Changeset 11140 for dotorg/trunk

Show
Ignore:
Timestamp:
09/04/2008 04:17:22 PM (3 months ago)
Author:
dave
Message:

regenerated html

Files:
1 modified

Legend:

Unmodified
Added
Removed

  • dotorg/trunk/html/beps/bep_0027.html

    r11130 r11140  
    3939<tr class="field"><th class="field-name">Title:</th><td class="field-body">Private Torrents</td> 
    4040</tr> 
    41 <tr class="field"><th class="field-name">Version:</th><td class="field-body">11128</td> 
     41<tr class="field"><th class="field-name">Version:</th><td class="field-body">11139</td> 
    4242</tr> 
    43 <tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference external" href="http://bittorrent.org/trac/browser/dotorg/trunk/html/beps/bep_0027.rst">2008-08-12 18:07:27 -0700 (Tue, 12 Aug 2008)</a></td> 
     43<tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference external" href="http://bittorrent.org/trac/browser/dotorg/trunk/html/beps/bep_0027.rst">2008-09-04 16:16:57 -0700 (Thu, 04 Sep 2008)</a></td> 
    4444</tr> 
    4545<tr class="field"><th class="field-name">Author:</th><td class="field-body">David Harrison &lt;dave&#32;&#97;t&#32;bittorrent.com&gt;</td> 
    … …  
    6161<p class="topic-title first">Contents</p> 
    6262<ul class="simple"> 
    63 <li><a class="reference internal" href="#rationale" id="id7">Rationale</a></li> 
    64 <li><a class="reference internal" href="#history" id="id8">History</a></li> 
    65 <li><a class="reference internal" href="#references" id="id9">References</a></li> 
    66 <li><a class="reference internal" href="#copyright" id="id10">Copyright</a></li> 
     63<li><a class="reference internal" href="#rationale" id="id8">Rationale</a></li> 
     64<li><a class="reference internal" href="#history" id="id9">History</a></li> 
     65<li><a class="reference internal" href="#references" id="id10">References</a></li> 
     66<li><a class="reference internal" href="#copyright" id="id11">Copyright</a></li> 
    6767</ul> 
    6868</div> 
    … …  
    7070NOT&quot;, &quot;SHOULD&quot;, &quot;SHOULD NOT&quot;, &quot;RECOMMENDED&quot;,  &quot;MAY&quot;, and 
    7171&quot;OPTIONAL&quot; in this document are to be interpreted as described in 
    72 IETF <a class="reference external" href="http://www.faqs.org/rfcs/rfc2119.html">RFC 2119</a> <a class="footnote-reference" href="#rfc-2119" id="id1">[5]</a>.</p> 
     72IETF <a class="reference external" href="http://www.faqs.org/rfcs/rfc2119.html">RFC 2119</a> <a class="footnote-reference" href="#rfc-2119" id="id1">[6]</a>.</p> 
    7373<p>A <em>private tracker</em> restricts access to the torrents it tracks.  A 
    74 torrent with restricted access is called a <em>private torrent</em>.  To 
    75 promote sharing, private trackers often maintain statistics about 
    76 registered users and restrict access to certain or all torrents for 
    77 users that do not adequately upload.</p> 
     74torrent with restricted access is called a <em>private torrent</em>.  All 
     75other torrents are <em>public torrents</em>.  To promote sharing, private 
     76trackers often maintain statistics about registered users and restrict 
     77access to certain or all torrents for users that do not adequately 
     78upload.</p> 
    7879<p>When generating a metainfo file, users denote a torrent as private by 
    7980including the key-value pair &quot;private=1&quot; in the &quot;info&quot; dict of the 
    … …  
    8384private tracker, and MUST ONLY initiate connections to peers returned 
    8485from the private tracker.</p> 
     86<p>When multiple trackers appear in the <em>announce-list</em> in the metainfo 
     87file of a private torrent (see multitracker extension in <a class="footnote-reference" href="#bep-12" id="id3">[4]</a>), 
     88each peer MUST use only one tracker at a time and only switch between 
     89trackers when the current tracker fails.  When switching between 
     90trackers, the peer MUST disconnect from all current peers and 
     91reconnect only to those provided from the new tracker.</p> 
    8592<div class="section" id="rationale"> 
    8693<h1>Rationale</h1> 
    … …  
    94101peers in a swarm:</p> 
    95102<ul class="simple"> 
    96 <li>Trackers <a class="footnote-reference" href="#bep-3" id="id3">[1]</a>,</li> 
    97 <li>Distribute Hash Table (DHT) <a class="footnote-reference" href="#bep-5" id="id4">[2]</a>,</li> 
    98 <li>Peer EXchange (PEX) <a class="footnote-reference" href="#bep-11" id="id5">[3]</a>,</li> 
    99 <li>Local Service Discovery (LSD) <a class="footnote-reference" href="#bep-14" id="id6">[4]</a>.</li> 
     103<li>Trackers <a class="footnote-reference" href="#bep-3" id="id4">[1]</a>,</li> 
     104<li>Distribute Hash Table (DHT) <a class="footnote-reference" href="#bep-5" id="id5">[2]</a>,</li> 
     105<li>Peer EXchange (PEX) <a class="footnote-reference" href="#bep-11" id="id6">[3]</a>,</li> 
     106<li>Local Service Discovery (LSD) <a class="footnote-reference" href="#bep-14" id="id7">[5]</a>.</li> 
    100107</ul> 
    101108<p>Announcing or exchanging peer information via any of these mechanisms 
    … …  
    106113with the intruder would provide the intruder with a full complement of 
    107114peers.</p> 
     115<p>When a peer switches between trackers, the peer drops connections so 
     116that it cannot become an ongoing bridge between peers granted access 
     117from a private tracker and peers announcing to a public tracker.  This 
     118partially mitigates the effect of an attacker modifying a metainfo 
     119file's <em>announce-list</em> and redistributing the file, e.g., via a public 
     120tracker web site.</p> 
    108121</div> 
    109122<div class="section" id="history"> 
    … …  
    116129<colgroup><col class="label" /><col /></colgroup> 
    117130<tbody valign="top"> 
    118 <tr><td class="label">[1]</td><td><em>(<a class="fn-backref" href="#id2">1</a>, <a class="fn-backref" href="#id3">2</a>)</em> BEP_0003.  The BitTorrent Protocol Specification, Cohen. 
     131<tr><td class="label">[1]</td><td><em>(<a class="fn-backref" href="#id2">1</a>, <a class="fn-backref" href="#id4">2</a>)</em> BEP_0003.  The BitTorrent Protocol Specification. Cohen. 
    119132<a class="reference external" href="http://www.bittorrent.org/beps/bep_0003.html">http://www.bittorrent.org/beps/bep_0003.html</a></td></tr> 
    120133</tbody> 
    … …  
    123136<colgroup><col class="label" /><col /></colgroup> 
    124137<tbody valign="top"> 
    125 <tr><td class="label"><a class="fn-backref" href="#id4">[2]</a></td><td>BEP_0005.  The DHT Protocol, Loewenstern. 
     138<tr><td class="label"><a class="fn-backref" href="#id5">[2]</a></td><td>BEP_0005.  The DHT Protocol. Loewenstern. 
    126139<a class="reference external" href="http://www.bittorrent.org/beps/bep_0005.html">http://www.bittorrent.org/beps/bep_0005.html</a></td></tr> 
    127140</tbody> 
    … …  
    130143<colgroup><col class="label" /><col /></colgroup> 
    131144<tbody valign="top"> 
    132 <tr><td class="label"><a class="fn-backref" href="#id5">[3]</a></td><td>BEP_0011.  Peer EXchange.  , . 
    133 <a class="reference external" href="http://www.bittorrent.org/beps/bep_0011.html">http://www.bittorrent.org/beps/bep_0011.html</a></td></tr> 
     145<tr><td class="label"><a class="fn-backref" href="#id6">[3]</a></td><td>BEP_0011.  Peer EXchange (pending)</td></tr> 
     146</tbody> 
     147</table> 
     148<table class="docutils footnote" frame="void" id="bep-12" rules="none"> 
     149<colgroup><col class="label" /><col /></colgroup> 
     150<tbody valign="top"> 
     151<tr><td class="label"><a class="fn-backref" href="#id3">[4]</a></td><td>BEP_0012.  Multitracker Metadata Extension. Hoffman. 
     152<a class="reference external" href="http://www.bittorrent.org/beps/bep_0012.html">http://www.bittorrent.org/beps/bep_0012.html</a></td></tr> 
    134153</tbody> 
    135154</table> 
    … …  
    137156<colgroup><col class="label" /><col /></colgroup> 
    138157<tbody valign="top"> 
    139 <tr><td class="label"><a class="fn-backref" href="#id6">[4]</a></td><td>BEP_0014.  Local Service Discovery. Harrison, Hazel. 
     158<tr><td class="label"><a class="fn-backref" href="#id7">[5]</a></td><td>BEP_0014.  Local Service Discovery. Harrison, Hazel. 
    140159<a class="reference external" href="http://www.bittorrent.org/beps/bep_0014.html">http://www.bittorrent.org/beps/bep_0014.html</a></td></tr> 
    141160</tbody> 
    … …  
    144163<colgroup><col class="label" /><col /></colgroup> 
    145164<tbody valign="top"> 
    146 <tr><td class="label"><a class="fn-backref" href="#id1">[5]</a></td><td><a class="reference external" href="http://www.faqs.org/rfcs/rfc2119.html">RFC-2119</a>. <a class="reference external" href="http://www.ietf.org/rfc/rfc2119.txt">http://www.ietf.org/rfc/rfc2119.txt</a></td></tr> 
     165<tr><td class="label"><a class="fn-backref" href="#id1">[6]</a></td><td><a class="reference external" href="http://www.faqs.org/rfcs/rfc2119.html">RFC-2119</a>. <a class="reference external" href="http://www.ietf.org/rfc/rfc2119.txt">http://www.ietf.org/rfc/rfc2119.txt</a></td></tr> 
    147166</tbody> 
    148167</table>