-
Notifications
You must be signed in to change notification settings - Fork 11
/
README.html
357 lines (245 loc) · 16.5 KB
/
README.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>About This Book — Computer Networks: A Systems Approach Version 6.2-dev documentation</title>
<link rel="shortcut icon" href="static/bridge.ico"/>
<script type="text/javascript" src="static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="static/documentation_options.js"></script>
<script type="text/javascript" src="static/jquery.js"></script>
<script type="text/javascript" src="static/underscore.js"></script>
<script type="text/javascript" src="static/doctools.js"></script>
<script type="text/javascript" src="static/language_data.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/latest.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="static/js/theme.js"></script>
<link rel="stylesheet" href="static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="static/pygments.css" type="text/css" />
<link rel="stylesheet" href="static/css/rtd_theme_mods.css" type="text/css" />
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="prev" title="Emerging Topics" href="supplements.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="index.html" class="icon icon-home"> Computer Networks: A Systems Approach
</a>
<div class="version">
Version 6.2-dev
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
<p class="caption"><span class="caption-text">Table of Contents</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="preface.html">Preface</a></li>
<li class="toctree-l1"><a class="reference internal" href="foundation.html">Chapter 1: Foundation</a></li>
<li class="toctree-l1"><a class="reference internal" href="direct.html">Chapter 2: Direct Links</a></li>
<li class="toctree-l1"><a class="reference internal" href="internetworking.html">Chapter 3: Internetworking</a></li>
<li class="toctree-l1"><a class="reference internal" href="scaling.html">Chapter 4: Advanced Internetworking</a></li>
<li class="toctree-l1"><a class="reference internal" href="e2e.html">Chapter 5: End-to-End Protocols</a></li>
<li class="toctree-l1"><a class="reference internal" href="congestion.html">Chapter 6: Congestion Control</a></li>
<li class="toctree-l1"><a class="reference internal" href="data.html">Chapter 7: End-to-End Data</a></li>
<li class="toctree-l1"><a class="reference internal" href="security.html">Chapter 8: Network Security</a></li>
<li class="toctree-l1"><a class="reference internal" href="applications.html">Chapter 9: Applications</a></li>
<li class="toctree-l1"><a class="reference internal" href="supplements.html">Emerging Topics</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">About This Book</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#read-the-book">Read the Book</a></li>
<li class="toctree-l2"><a class="reference internal" href="#releases-and-editions">Releases and Editions</a></li>
<li class="toctree-l2"><a class="reference internal" href="#build-the-book">Build the Book</a></li>
<li class="toctree-l2"><a class="reference internal" href="#how-to-contribute">How to Contribute</a></li>
<li class="toctree-l2"><a class="reference internal" href="#join-us">Join Us</a></li>
</ul>
</li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" aria-label="top navigation">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">Computer Networks: A Systems Approach</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html">Docs</a> »</li>
<li>About This Book</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/README.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<div class="section" id="about-this-book">
<h1>About This Book<a class="headerlink" href="#about-this-book" title="Permalink to this headline">¶</a></h1>
<p>This <a class="reference external" href="https://github.com/SystemsApproach">site</a>
contains source text for <em>Computer Networks: A Systems
Approach</em>, now available under terms of the <a class="reference external" href="https://creativecommons.org/licenses/by/4.0">Creative Commons (CC BY
4.0)</a> license. The
community is invited to contribute corrections, improvements, updates,
and new material under the same terms.</p>
<p>Like many open source software projects, this one has been seeded with
once restricted content: the 5th edition of <em>Peterson and Davie</em>,
copyrighted by Elsevier. Our hope is that open sourcing this material
will both make it widely available and serve as an attractor for new
content: updating what’s already there, expanding it to cover new
topics, and augmenting the text with additional teaching collateral.</p>
<p>We will initially play an editorial role (curating and wordsmithing) for
contributions that come back, but our plan is to share ownership of the
project with others committed to its success.</p>
<p>And if you make use of this work, the attribution should include the
following information:</p>
<div class="line-block">
<div class="line">Title: <em>Computer Networks: A Systems Approach</em></div>
<div class="line">Authors: Larry Peterson and Bruce Davie</div>
<div class="line">Copyright: Elsevier, 2012</div>
<div class="line">Source: <a class="reference external" href="https://github.com/SystemsApproach">https://github.com/SystemsApproach</a></div>
<div class="line">License: <a class="reference external" href="https://creativecommons.org/licenses/by/4.0">CC BY 4.0</a></div>
</div>
<div class="section" id="read-the-book">
<h2>Read the Book<a class="headerlink" href="#read-the-book" title="Permalink to this headline">¶</a></h2>
<p>This book is part of the <a class="reference external" href="https://www.systemsapproach.org">Systems Approach Series</a>, with an online version published
at <a class="reference external" href="https://book.systemsapproach.org">https://book.systemsapproach.org</a>.</p>
<p>To track progress and receive notices about new versions, you can follow
the project on
<a class="reference external" href="https://www.facebook.com/Computer-Networks-A-Systems-Approach-110933578952503/">Facebook</a>
and <a class="reference external" href="https://twitter.com/SystemsAppr">Twitter</a>. To read a running
commentary on how the Internet is evolving, follow the <a class="reference external" href="https://www.systemsapproach.org/blog">Systems Approach
Blog</a>.</p>
</div>
<div class="section" id="releases-and-editions">
<h2>Releases and Editions<a class="headerlink" href="#releases-and-editions" title="Permalink to this headline">¶</a></h2>
<p>We release ever-changing open source content rather than publish fixed
books, although you can roughly equate v6.0 with a 6th Edition. Read the
<a class="reference external" href="preface.html">Preface</a> to find out what’s new in this version. Note
that Morgan Kaufmann (Elsevier) plans to publish a 6th edition of their
textbook based on a fork of v6.0, but going forward, open source
releases found here will not necessarily stay in sync with any future
published editions.</p>
<p>In general, <code class="docutils literal notranslate"><span class="pre">master</span></code> contains a coherent and internally consistent
version of the material. (If it were code, the book would build and
run.) New content under development is checked into branches until it
can be merged into <code class="docutils literal notranslate"><span class="pre">master</span></code> without breaking self-consistency. The web
version of the book available at <a class="reference external" href="https://book.systemsapproach.org">https://book.systemsapproach.org</a> is
periodically generated from <code class="docutils literal notranslate"><span class="pre">master</span></code>, and corresponds to a typical
maintenance release, although we do not bother to tag it as such (e.g.,
6.0.1).</p>
<p>Minor releases (e.g., v6.1) are tagged whenever there is sufficient new
content to justify the effort. This happens quarterly, give-or-take, and
is primarily to create a snapshot so that everyone in a course can know
they are using the same version. The off-line formats (e.g., pdf, epub)
are also generated with every minor release.</p>
</div>
<div class="section" id="build-the-book">
<h2>Build the Book<a class="headerlink" href="#build-the-book" title="Permalink to this headline">¶</a></h2>
<p>The source content is organized as a git repository per chapter, each of
which focuses on a major networking topic (e.g., <em>Internetworking</em>,
<em>Congestion Control</em>). A “root” repo (<a class="reference external" href="https://github.com/SystemsApproach/book">this
one</a>) contains the
top-level files needed to assemble a full book.</p>
<p>To build a web-viewable version, you first need to download the source:</p>
<div class="code shell highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">mkdir</span> <span class="o">~/</span><span class="n">systemsapproach</span>
<span class="n">cd</span> <span class="o">~/</span><span class="n">systemsapproach</span>
<span class="n">git</span> <span class="n">clone</span> <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">github</span><span class="o">.</span><span class="n">com</span><span class="o">/</span><span class="n">systemsapproach</span><span class="o">/</span><span class="n">book</span><span class="o">.</span><span class="n">git</span>
<span class="n">cd</span> <span class="n">book</span>
<span class="n">git</span> <span class="n">submodule</span> <span class="n">init</span>
<span class="n">git</span> <span class="n">submodule</span> <span class="n">update</span>
</pre></div>
</div>
<p>The build process is stored in the <code class="docutils literal notranslate"><span class="pre">Makefile</span></code> and requires Python be
installed. The <code class="docutils literal notranslate"><span class="pre">Makefile</span></code> will create a virtualenv (<code class="docutils literal notranslate"><span class="pre">doc_venv</span></code>) which
installs the documentation generation toolset.</p>
<p>To generate HTML in <code class="docutils literal notranslate"><span class="pre">_build/html</span></code>, run <code class="docutils literal notranslate"><span class="pre">make</span> <span class="pre">html</span></code>.</p>
<p>To get a live reload in your browser (refreshes on file save), run <code class="docutils literal notranslate"><span class="pre">make</span> <span class="pre">reload</span></code>.</p>
<p>To check the formatting of the book, run <code class="docutils literal notranslate"><span class="pre">make</span> <span class="pre">lint</span></code>.</p>
<p>To see the other available output formats, run <code class="docutils literal notranslate"><span class="pre">make</span></code>.</p>
</div>
<div class="section" id="how-to-contribute">
<h2>How to Contribute<a class="headerlink" href="#how-to-contribute" title="Permalink to this headline">¶</a></h2>
<p>We hope that if you use this material, you are also willing to
contribute back to it. If you are new to open source, you might check
out this <a class="reference external" href="https://opensource.guide/how-to-contribute/">How to Contribute to Open
Source</a> guide. Among
other things, you’ll learn about posting <em>Issues</em> that you’d like to see
addressed, and issuing <em>Pull Requests</em> to merge your improvements back
into GitHub.</p>
<p>If you do want to contribute either patches or new material, you will
need to sign a <a class="reference external" href="https://github.com/SystemsApproach/book/blob/master/CLA.md">Contributor Licensing Agreement
(CLA)</a>.
You’ll be prompted to sign the CLA the first time you make a pull
request.</p>
<p>The CLA is pretty straightforward: it establishes that (a) you have the
right to contribute what you’re contributing, and (b) what you
contribute is available to everyone else under the same <a class="reference external" href="https://creativecommons.org/licenses/by/4.0">CC
BY</a> terms as the
existing content. The CLA is a little unusual in that it explicitly
calls out Elsevier’s rights (which are the same as everyone’s), but this
does signal their intent to continue publishing textbooks based on the
material.</p>
<p>You should also familiarize yourself with the <a class="reference external" href="https://github.com/SystemsApproach/book/blob/master/CONTRIBUTING.rst">guidelines for
contributing</a>.</p>
<p>If you’d like to contribute and are looking for something that needs
attention, see the current <a class="reference external" href="https://github.com/orgs/SystemsApproach/projects/">Project
Board</a>. We’d also
like to expand the set of topics/chapters beyond the initial set
inherited from the 5th edition, so if you have ideas, we’d love to hear
from you. Send email to <code class="docutils literal notranslate"><span class="pre">discuss@systemsapproach.org</span></code>, or better yet,
<a class="reference external" href="https://groups.google.com/a/systemsapproach.org/forum/#!forum/discuss">join the
forum</a>.</p>
<p>Finally, in as much as this is an on-going effort, we will try to record
and track our
<a class="reference external" href="https://github.com/SystemsApproach/book/blob/master/status.rst">progress</a>.
For now, think of this as a poor-man’s release notes. Additional
information about work-in-progress can be found in the
<a class="reference external" href="https://github.com/SystemsApproach/book/wiki">wiki</a>.</p>
</div>
<div class="section" id="join-us">
<h2>Join Us<a class="headerlink" href="#join-us" title="Permalink to this headline">¶</a></h2>
<p>We hope you’ve gotten value out of <em>Computer Networks: A Systems
Approach</em> over the years, and we’re eager to have you join us in this
new venture.</p>
<div class="line-block">
<div class="line">Larry Peterson & Bruce Davie</div>
<div class="line">November 2019</div>
</div>
</div>
</div>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="supplements.html" class="btn btn-neutral float-left" title="Emerging Topics" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
</div>
<hr/>
<div role="contentinfo">
<p>
© Copyright 2019
</p>
</div>
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script type="text/javascript">
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>