First massive push

book-es/AUTHORS

@@ -0,0 +1,14 @@
+CNP3 is written and maintained by `Olivier Bonaventure`_ http://inl.info.ucl.ac.be/obo
+
+Other contributors, include :
+
+* Virginie Van den Schriek contributed to various exercises
+* Laurent Vanbever contributed to various exercises
+* Damien Saucez contributed to various exercises
+* Mickael Hoerdt contributed to various exercises 
+* Pierre Reinbold designed the icons used to represent routers, switches, ... and provides all the sysadmin support to host the book
+* Nipaul Long converted most of the figures to SVG format
+* Daire O' Doherty helped to improve the writing throughout the book
+
+Many thanks for all contributions!
+

book-es/CHANGES

@@ -0,0 +1,78 @@
+Release 0.3 (in development)
+============================
+
+The book was chosen by the Saylor foundation as a recipient of one of the first Textbook Challenge award. This has resulted in a change of license of the textbook. It is now distributed under a CC-BY creative commons license as reflected in all source files and in the preface :
+
+ `Computer Networking : Principles, Protocols and Practice`, (c) 2011, `Olivier Bonaventure <http://inl.info.ucl.ac.be/obo>`_, `Universite catholique de Louvain <http://www.uclouvain.be>`_ (Belgium) and the collaborators listed above, used under a Creative Commons Attribution (CC BY) license made possible by funding from The Saylor Foudnation's Open Textbook Challenge in order to be incorporated into Saylor.org' collection of open courses available at `http://www.saylor.org <http://www.saylo.org>`_. Full license terms may be viewed at : `http://creativecommons.org/licenses/by/3.0/ <http://creativecommons.org/licenses/by/3.0/>`_
+
+
+Release 0.2 (in development)
+============================
+
+Revision 323
+
+Applied several patches from Stephane Bortzmeyer on :
+
+- #50 on LAN chapter
+- #49 on transport chapter
+- #52 network chapter
+- #53 (IPv6 addresses in lower case) made a first pass on the ipv6.rst file and have fixed most
+- #28 (figure - reported by Fabien Duchene)
+
+Revision 318
+
+New text
+--------
+- new exercises in the LAN section on the spanning tree proposed by Simon van der Linden
+
+
+Revision 317
+
+Minor improvements
+------------------
+- Added exercises on IP in the network layer chapter
+- typo reported by Benjamin Blaise
+
+Revision 316
+
+Minor improvements
+------------------
+- many small changes to figures
+- Changed to haiku style for HTML version, suggested by Simon van der Linden
+- #10 replaced bandwidth by bit rate in the introduction since bandwidth was used for the physical layer. bit rate seemed more appropriate than 
+- #27 various improvements in network layer chapter reported by S. Bortzmeyer
+- #33 fixed to US English spelling for the entire book
+- #34 typo repo reported by F. Pelsser
+- typo reported by Andre Sintzoff
+- fixed typos and error in bandwidth computation reported by Francois Aubry and Benjamin Blaise
+- included various text enhancements proposed by Daire O'Doherty in the application layer chapter
+- clarified DNS question, suggestion by Fabien Duchene
+- updated description of loopback interfaces in bgp section
+- Clarified text based on comments provided by Daire O'Doherty in the network layer and lan chapters
+- moved to PDF figures for the latex version instead of the png figures. Should improve the readability
+- fix from Stephane Bortzmeyer on the URI definition in application chapter
+
+Revision 315
+
+New text
+--------
+ - Added AUTHORS file with all contributors
+ - Added CHANGES file that summarises all changes to the book
+ - #26 added example of higher level libraries in the socket section, suggestion from Stephane Bortzmeyer 
+
+Minor improvements
+-------------------
+
+ - #30 fixed errors in some exercices reported by Stephane Bortzmeyer
+ - #19 added reference to :rfc:`5598` for email architecture suggested by Stephane Bortzmeyer
+ - #8 improved description of star topology, suggestion from Stephane Bortzmeyer
+ - #23 replaced `www.google.com` with `www.ietf.org` in the exercise about AAAA DNS records suggestion from Stephane Bortzmeyer
+ - #7 typo in introduction
+ - #14 fixed in the HTTP section from Stephane Bortzmeyer
+ - #13 changes to email section proposed by Stephane Bortzmeyer
+ - fixed problems in latex generation due to problems in detecting the correct boudning box in PNG files generated by inkscape
+
+Release 0.1
+===========
+
+Changes were not closely tracked in this release, see svn log and trac site (https://scm.info.ucl.ac.be/trac/cnp3) for partial information about these changes

book-es/Makefile

@@ -0,0 +1,140 @@
+# Makefile for Sphinx documentation
+#
+
+# PKT
+
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+PAPER         =
+BUILDDIR      = _build
+
+# Internal variables.
+PAPEROPT_a4     = -D latex_paper_size=a4
+PAPEROPT_letter = -D latex_paper_size=letter
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+
+.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest
+
+
+help:
+	@echo "Please use \`make <target>' where <target> is one of"
+	@echo "  html       to make standalone HTML files"
+	@echo "  dirhtml    to make HTML files named index.html in directories"
+	@echo "  singlehtml to make a single large HTML file"
+	@echo "  pickle     to make pickle files"
+	@echo "  json       to make JSON files"
+	@echo "  htmlhelp   to make HTML files and a HTML help project"
+	@echo "  qthelp     to make HTML files and a qthelp project"
+	@echo "  devhelp    to make HTML files and a Devhelp project"
+	@echo "  epub       to make an epub"
+	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
+	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
+	@echo "  text       to make text files"
+	@echo "  man        to make manual pages"
+	@echo "  changes    to make an overview of all changed/added/deprecated items"
+	@echo "  linkcheck  to check all external links for integrity"
+	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
+
+
+clean:
+	-rm -rf $(BUILDDIR)/*
+
+html:
+	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
+
+dirhtml:
+	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
+
+singlehtml:
+	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
+	@echo
+	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
+
+pickle:
+	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
+	@echo
+	@echo "Build finished; now you can process the pickle files."
+
+json:
+	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
+	@echo
+	@echo "Build finished; now you can process the JSON files."
+
+htmlhelp:
+	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
+	@echo
+	@echo "Build finished; now you can run HTML Help Workshop with the" \
+	      ".hhp project file in $(BUILDDIR)/htmlhelp."
+
+qthelp:
+	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
+	@echo
+	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
+	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
+	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/Premierspaseninformatique.qhcp"
+	@echo "To view the help file:"
+	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/Premierspaseninformatique.qhc"
+
+devhelp:
+	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
+	@echo
+	@echo "Build finished."
+	@echo "To view the help file:"
+	@echo "# mkdir -p $$HOME/.local/share/devhelp/Premierspaseninformatique"
+	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/Premierspaseninformatique"
+	@echo "# devhelp"
+
+epub:
+	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
+	@echo
+	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
+
+latex:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo
+	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
+	@echo "Run \`make' in that directory to run these through (pdf)latex" \
+	      "(use \`make latexpdf' here to do that automatically)."
+
+latexpdf:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo "Running LaTeX files through pdflatex..."
+	make -C $(BUILDDIR)/latex all-pdf
+	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
+
+text:
+	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
+	@echo
+	@echo "Build finished. The text files are in $(BUILDDIR)/text."
+
+man:
+	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
+	@echo
+	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
+
+changes:
+	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
+	@echo
+	@echo "The overview file is in $(BUILDDIR)/changes."
+
+linkcheck:
+	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
+	@echo
+	@echo "Link check complete; look for any errors in the above output " \
+	      "or in $(BUILDDIR)/linkcheck/output.txt."
+
+doctest:
+	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
+	@echo "Testing of doctests in the sources finished, look at the " \
+	      "results in $(BUILDDIR)/doctest/output.txt."
+
+pdf:
+	$(SPHINXBUILD) -b pdf $(ALLSPHINXOPTS) _build/pdf
+	@echo
+	@echo "Build finished. The PDF files are in _build/pdf."

book-es/Makefile-images

@@ -0,0 +1,9 @@
+#
+# OB
+#
+SUBDIRS = intro/svg intro/pkt application/svg application/pkt transport/pkt transport/svg network/pkt network/svg lan/pkt lan/svg
+
+subdirs:
+	for dir in $(SUBDIRS); do \
+               $(MAKE) -C $$dir; \
+	done

book-es/README.txt

@@ -0,0 +1,33 @@
+
+Computer Networking : Principles, Protocols and Practice
+
+(c) Olivier Bonaventure, Universite catholique de Louvain, Belgium
+    http://inl.info.ucl.ac.be
+
+All the files in this subversion repository are licensed under a Creative Commons Attribution-Share Alike 3.0 Unported License.
+
+Like any open-source project, the future of Computer Networking Principles, Protocols and Practice will depend on the work of contributors. Most of the text has been written by Olivier Bonaventure. Laurent Vanbever, Virginie Van den Schriek, Damien Saucez and Mickael Hoerdt have contributed to exercises. 
+
+ The development of the textbook is managed through a trac platform at https://scm.info.ucl.ac.be/trac/cnp3 . You can contribute to the project by : 
+
+  - sending comments, suggestions or bug reports  by filing tickets  on https://scm.info.ucl.ac.be/trac/cnp3/newticket or via the CNP3 mailing list at https://listes-2.sipr.ucl.ac.be/sympa/subscribe/cnp3
+  - proposing new exercises on the mailing list
+  - proposing new sections or chapters on the CNP3 mailing list 
+  - follow the development on the book's 'facebook page <http://www.facebook.com/pages/Computer-Networking-Principles-Protocols-and-Practice/129951043755620>'
+
+ A stable release of the textbook will be issued at least once per year on http://inl.info.ucl.ac.be/CNP3 and the development version will always be available from https://scm.info.ucl.ac.be/trac/cnp3 . 
+
+You can download the sources via subversion by using
+
+    svn co https://scm.info.ucl.ac.be/svn/cnp3/book 
+
+The book was compiled on MacOS/X Snow Leopard using sphinx. inkscape is required to convert some of the images in png format. Most of the images will be converted to the SVG format to improve the portability of the textbook. python is also required. When US and British spelling disagree, we opt for US spelling.
+
+The textbook was written on a Mac running Snow Leopard, but it should rebuild on other Unix based systems. Comments on issues in rebuilding the textbook are welcome.
+
+
+
+
+				Olivier Bonaventure
+				Louvain-la-Neuve, July 2011 
+

book-es/_build/TEST.txt

@@ -0,0 +1 @@
+Just a test

book-es/_static/TEST.txt

@@ -0,0 +1 @@
+Just a test

book-es/_templates/TEST.txt

@@ -0,0 +1 @@
+Just a test

book-es/application/Mission/Makefile

@@ -0,0 +1,89 @@
+# Makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = ~/local/bin/sphinx-build
+PAPER         =
+BUILDDIR      = _build
+
+# Internal variables.
+PAPEROPT_a4     = -D latex_paper_size=a4
+PAPEROPT_letter = -D latex_paper_size=letter
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+
+.PHONY: help clean html dirhtml pickle json htmlhelp qthelp latex changes linkcheck doctest
+
+help:
+	@echo "Please use \`make <target>' where <target> is one of"
+	@echo "  html      to make standalone HTML files"
+	@echo "  dirhtml   to make HTML files named index.html in directories"
+	@echo "  pickle    to make pickle files"
+	@echo "  json      to make JSON files"
+	@echo "  htmlhelp  to make HTML files and a HTML help project"
+	@echo "  qthelp    to make HTML files and a qthelp project"
+	@echo "  latex     to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
+	@echo "  changes   to make an overview of all changed/added/deprecated items"
+	@echo "  linkcheck to check all external links for integrity"
+	@echo "  doctest   to run all doctests embedded in the documentation (if enabled)"
+
+clean:
+	-rm -rf $(BUILDDIR)/*
+
+html:
+	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
+
+dirhtml:
+	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
+
+pickle:
+	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
+	@echo
+	@echo "Build finished; now you can process the pickle files."
+
+json:
+	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
+	@echo
+	@echo "Build finished; now you can process the JSON files."
+
+htmlhelp:
+	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
+	@echo
+	@echo "Build finished; now you can run HTML Help Workshop with the" \
+	      ".hhp project file in $(BUILDDIR)/htmlhelp."
+
+qthelp:
+	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
+	@echo
+	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
+	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
+	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/CNP3.qhcp"
+	@echo "To view the help file:"
+	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/CNP3.qhc"
+
+latex:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo
+	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
+	@echo "Run \`make all-pdf' or \`make all-ps' in that directory to" \
+	      "run these through (pdf)latex."
+
+changes:
+	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
+	@echo
+	@echo "The overview file is in $(BUILDDIR)/changes."
+
+linkcheck:
+	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
+	@echo
+	@echo "Link check complete; look for any errors in the above output " \
+	      "or in $(BUILDDIR)/linkcheck/output.txt."
+
+doctest:
+	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
+	@echo "Testing of doctests in the sources finished, look at the " \
+	      "results in $(BUILDDIR)/doctest/output.txt."