Changeset 11107 for dotorg/trunk

Show
Ignore:
Timestamp:
05/27/2008 09:03:51 PM (6 months ago)
Author:
dave
Message:

rebuild html files.

Location:
dotorg/trunk/html/beps
Files:
6 modified

Legend:

Unmodified
Added
Removed

  • dotorg/trunk/html/beps/bep_0000.html

    r11103 r11107  
     1<?xml version="1.0" encoding="utf-8" ?> 
     2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 
     3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> 
     4<head> 
     5<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 
     6<meta name="generator" content="Docutils 0.5: http://docutils.sourceforge.net/" /> 
     7<title></title> 
     8<link rel="stylesheet" href="../css/bep.css" type="text/css" /> 
     9</head> 
     10<body> 
     11<div class="document"> 
     12 
     13<div id="upper" class="clear"> 
     14<div id="wrap"> 
     15<div id="header"> 
     16<h1><a href="../index.html">BitTorrent<span>.org</span></a></h1> 
     17</div> 
     18<div id="nav"> 
     19<ul> 
     20<li><a href="../index.html">Home</a></li> 
     21<li><a href="../introduction.html">For Users</a></li> 
     22<li><a href="bep_0000.html"><span>For Developers</span></a></li> 
     23<!-- <li><a href="./blog">Blog</a></li> --> 
     24<li><a href="http://forum.bittorrent.org"> Forums </li> 
     25<li><a href="../donate.html">Donate!</a></li> 
     26</ul> 
     27</div> <!-- nav --> 
     28<!-- ### Begin Content ### --> 
     29<div id="second"> 
     30 
     31 
     32 
     33<table class="rfc2822 docutils field-list" frame="void" rules="none"> 
     34<col class="field-name" /> 
     35<col class="field-body" /> 
     36<tbody valign="top"> 
     37<tr class="field"><th class="field-name">BEP:</th><td class="field-body">0</td> 
     38</tr> 
     39<tr class="field"><th class="field-name">Title:</th><td class="field-body">Index of BitTorrent Enhancement Proposals</td> 
     40</tr> 
     41<tr class="field"><th class="field-name">Version:</th><td class="field-body">11106</td> 
     42</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_0000.rst">2008-05-27 20:58:22 -0700 (Tue, 27 May 2008)</a></td> 
     44</tr> 
     45<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> 
     46</tr> 
     47<tr class="field"><th class="field-name">Status:</th><td class="field-body">Active</td> 
     48</tr> 
     49<tr class="field"><th class="field-name">Type:</th><td class="field-body">Process</td> 
     50</tr> 
     51<tr class="field"><th class="field-name">Created:</th><td class="field-body">10-Jan-2008</td> 
     52</tr> 
     53<tr class="field"><th class="field-name">Post-History:</th><td class="field-body"></td> 
     54</tr> 
     55</tbody> 
     56</table> 
     57<hr /> 
     58<div class="contents topic" id="contents"> 
     59<p class="topic-title first">Contents</p> 
     60<ul class="simple"> 
     61<li><a class="reference internal" href="#final-and-active-process-beps" id="id4">Final and Active Process BEPs</a></li> 
     62<li><a class="reference internal" href="#accepted-beps" id="id5">Accepted BEPs</a></li> 
     63<li><a class="reference internal" href="#draft-beps" id="id6">Draft BEPs</a></li> 
     64<li><a class="reference internal" href="#deferred-beps" id="id7">Deferred BEPs</a></li> 
     65<li><a class="reference internal" href="#withdrawn-beps" id="id8">Withdrawn BEPs</a></li> 
     66<li><a class="reference internal" href="#rejected-beps" id="id9">Rejected BEPs</a></li> 
     67</ul> 
     68</div> 
     69<p>The BitTorrent Community Forum coordinates the development of the 
     70BitTorrent protocol suite and its reference implementation. It is the 
     71wish of Bram Cohen that the BitTorrent mainline python implementation 
     72remain open source and that the protocol development process be 
     73modelled after the Python Enhancement Proposal (PEP) process <a class="footnote-reference" href="#python" id="id1">[1]</a>.</p> 
     74<p>This document indexes all BitTorrent Enhancement Proposals (BEPs). 
     75When a new proposal is submitted, one of the BitTorrent.org editors 
     76assigns a BEP number and updates this index appropriately.  Each 
     77document has a number that never changes and the history of the 
     78document is maintained in subversion <a class="footnote-reference" href="#svn" id="id2">[2]</a>.</p> 
     79<div class="section" id="final-and-active-process-beps"> 
     80<h1>Final and Active Process BEPs</h1> 
     81<table border="1" class="docutils"> 
     82<colgroup> 
     83<col width="7%" /> 
     84<col width="93%" /> 
     85</colgroup> 
     86<thead valign="bottom"> 
     87<tr><th class="head">Num</th> 
     88<th class="head">Title</th> 
     89</tr> 
     90</thead> 
     91<tbody valign="top"> 
     92<tr><td><span class="raw-html"><A HREF="bep_0000.html">0</A></span></td> 
     93<td><span class="raw-html"><A HREF="bep_0000.html">Index of BitTorrent Enhancement Proporsals </A></span></td> 
     94</tr> 
     95<tr><td><span class="raw-html"><A HREF="bep_0001.html">1</A></span></td> 
     96<td><span class="raw-html"><A HREF="bep_0001.html">The BEP Process</A></span></td> 
     97</tr> 
     98<tr><td><span class="raw-html"><A HREF="bep_0002.html">2</A></span></td> 
     99<td><span class="raw-html"><A HREF="bep_0002.html">Sample reStructured Text BEP Template</A></span></td> 
     100</tr> 
     101<tr><td><span class="raw-html"><A HREF="bep_0003.html">3</A></span></td> 
     102<td><span class="raw-html"><A HREF="bep_0003.html">The BitTorrent Protocol Specification</A></span></td> 
     103</tr> 
     104<tr><td><span class="raw-html"><A HREF="bep_0004.html">4</A></span></td> 
     105<td><span class="raw-html"><A HREF="bep_0004.html">Known Number Allocations </A></span></td> 
     106</tr> 
     107<tr><td><span class="raw-html"><A HREF="bep_0020.html">20</A></span></td> 
     108<td><span class="raw-html"><A HREF="bep_0020.html">Peer ID Conventions</A></span></td> 
     109</tr> 
     110<tr><td><span class="raw-html"><A HREF="bep_1000.html">1000</A></span></td> 
     111<td><span class="raw-html"><A HREF="bep_1000.html">Pending Standards Track Documents</A></span></td> 
     112</tr> 
     113</tbody> 
     114</table> 
     115</div> 
     116<div class="section" id="accepted-beps"> 
     117<h1>Accepted BEPs</h1> 
     118<p>These BEPs describe mechanisms that have been deployed in one or more BitTorrent 
     119implementations and have proven useful.  They may require minor revisions. 
     120They await the blessing of the BDFL before they can be considered Final.</p> 
     121<table border="1" class="docutils"> 
     122<colgroup> 
     123<col width="7%" /> 
     124<col width="93%" /> 
     125</colgroup> 
     126<thead valign="bottom"> 
     127<tr><th class="head">Num</th> 
     128<th class="head">Title</th> 
     129</tr> 
     130</thead> 
     131<tbody valign="top"> 
     132<tr><td><span class="raw-html"><A HREF="bep_0009.html">9</A></span></td> 
     133<td><span class="raw-html"><A HREF="bep_0009.html">Extension for Peers to Send Metadata Files </A></span></td> 
     134</tr> 
     135<tr><td><span class="raw-html"><A HREF="bep_0023.html">23</A></span></td> 
     136<td><span class="raw-html"><A HREF="bep_0023.html">Tracker Returns Compact Peer Lists</A></span></td> 
     137</tr> 
     138</tbody> 
     139</table> 
     140</div> 
     141<div class="section" id="draft-beps"> 
     142<h1>Draft BEPs</h1> 
     143<p>The following BEPs are under consideration for standardization.</p> 
     144<table border="1" class="docutils"> 
     145<colgroup> 
     146<col width="7%" /> 
     147<col width="93%" /> 
     148</colgroup> 
     149<thead valign="bottom"> 
     150<tr><th class="head">Num</th> 
     151<th class="head">Title</th> 
     152</tr> 
     153</thead> 
     154<tbody valign="top"> 
     155<tr><td><span class="raw-html"><A HREF="bep_0005.html">5</A></span></td> 
     156<td><span class="raw-html"><A HREF="bep_0005.html">DHT Protocol </A></span></td> 
     157</tr> 
     158<tr><td><span class="raw-html"><A HREF="bep_0006.html">6</A></span></td> 
     159<td><span class="raw-html"><A HREF="bep_0006.html">Fast Extension </A></span></td> 
     160</tr> 
     161<tr><td><span class="raw-html"><A HREF="bep_0007.html">7</A></span></td> 
     162<td><span class="raw-html"><A HREF="bep_0007.html">IPv6 Tracker Extension   </A></span></td> 
     163</tr> 
     164<tr><td><span class="raw-html"><A HREF="bep_0010.html">10</A></span></td> 
     165<td><span class="raw-html"><A HREF="bep_0010.html">Extension Protocol </A></span></td> 
     166</tr> 
     167<tr><td><span class="raw-html"><A HREF="bep_0012.html">12</A></span></td> 
     168<td><span class="raw-html"><A HREF="bep_0012.html">Multitracker Metadata Extension</A></span></td> 
     169</tr> 
     170<tr><td><span class="raw-html"><A HREF="bep_0015.html">15</A></span></td> 
     171<td><span class="raw-html"><A HREF="bep_0015.html">UDP Tracker Protocol</A></span></td> 
     172</tr> 
     173<tr><td><span class="raw-html"><A HREF="bep_0016.html">16</A></span></td> 
     174<td><span class="raw-html"><A HREF="bep_0016.html">Superseeding</A></span></td> 
     175</tr> 
     176<tr><td><span class="raw-html"><A HREF="bep_0017.html">17</A></span></td> 
     177<td><span class="raw-html"><A HREF="bep_0017.html">HTTP Seeding (Hoffman-style) </A></span></td> 
     178</tr> 
     179<tr><td><span class="raw-html"><A HREF="bep_0018.html">18</A></span></td> 
     180<td><span class="raw-html"><A HREF="bep_0018.html">Search Engine Specification</A></span></td> 
     181</tr> 
     182<tr><td><span class="raw-html"><A HREF="bep_0019.html">19</A></span></td> 
     183<td><span class="raw-html"><A HREF="bep_0019.html">HTTP/FTP Seeding (GetRight-style) </A></span></td> 
     184</tr> 
     185<tr><td><span class="raw-html"><A HREF="bep_0021.html">21</A></span></td> 
     186<td><span class="raw-html"><A HREF="bep_0021.html">Extension for Partial Seeds</A></span></td> 
     187</tr> 
     188<tr><td><span class="raw-html"><A HREF="bep_0022.html">22</A></span></td> 
     189<td><span class="raw-html"><A HREF="bep_0022.html">BitTorrent Cache Discovery Protocol</A></span></td> 
     190</tr> 
     191<tr><td><span class="raw-html"><A HREF="bep_0024.html">24</A></span></td> 
     192<td><span class="raw-html"><A HREF="bep_0024.html">Tracker Returns External IP</A></span></td> 
     193</tr> 
     194<tr><td><span class="raw-html"><A HREF="bep_0026.html">26</A></span></td> 
     195<td><span class="raw-html"><A HREF="bep_0026.html">Zeroconf Peer Advertising and Discovery</A></span></td> 
     196</tr> 
     197</tbody> 
     198</table> 
     199</div> 
     200<div class="section" id="deferred-beps"> 
     201<h1>Deferred BEPs</h1> 
     202<p>The editor(s) deem that the following BEPs are not progressing toward standardization, 
     203but they have not yet been withdrawn.</p> 
     204<table border="1" class="docutils"> 
     205<colgroup> 
     206<col width="8%" /> 
     207<col width="92%" /> 
     208</colgroup> 
     209<thead valign="bottom"> 
     210<tr><th class="head">Num</th> 
     211<th class="head">Title</th> 
     212</tr> 
     213</thead> 
     214<tbody valign="top"> 
     215<tr><td><span class="raw-html"><A HREF="bep_0008.html">8</A></span></td> 
     216<td><span class="raw-html"><A HREF="bep_0008.html">Tracker Peer Obfuscation </A></span></td> 
     217</tr> 
     218</tbody> 
     219</table> 
     220</div> 
     221<div class="section" id="withdrawn-beps"> 
     222<h1>Withdrawn BEPs</h1> 
     223<p>At this time, no BEPs have been withdrawn.</p> 
     224</div> 
     225<div class="section" id="rejected-beps"> 
     226<h1>Rejected BEPs</h1> 
     227<p>At this time, no BEPs have been rejected.</p> 
     228<table class="docutils footnote" frame="void" id="python" rules="none"> 
     229<colgroup><col class="label" /><col /></colgroup> 
     230<tbody valign="top"> 
     231<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td><a class="reference external" href="http://www.python.org/dev/peps/">http://www.python.org/dev/peps/</a></td></tr> 
     232</tbody> 
     233</table> 
     234<table class="docutils footnote" frame="void" id="svn" rules="none"> 
     235<colgroup><col class="label" /><col /></colgroup> 
     236<tbody valign="top"> 
     237<tr><td class="label"><a class="fn-backref" href="#id2">[2]</a></td><td><a class="reference external" href="http://bittorrent.org/trac">http://bittorrent.org/trac</a></td></tr> 
     238</tbody> 
     239</table> 
     240</div> 
     241 
     242 
     243</div> 
     244        <div id="footer"> 
     245<hr/> 
     246</div> 
     247 
     248</div> 
     249</body> 
     250</html> 

  • dotorg/trunk/html/beps/bep_0001.html

    r11103 r11107  
     1<?xml version="1.0" encoding="utf-8" ?> 
     2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 
     3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> 
     4<head> 
     5<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 
     6<meta name="generator" content="Docutils 0.5: http://docutils.sourceforge.net/" /> 
     7<title></title> 
     8<link rel="stylesheet" href="../css/bep.css" type="text/css" /> 
     9</head> 
     10<body> 
     11<div class="document"> 
     12 
     13<div id="upper" class="clear"> 
     14<div id="wrap"> 
     15<div id="header"> 
     16<h1><a href="../index.html">BitTorrent<span>.org</span></a></h1> 
     17</div> 
     18<div id="nav"> 
     19<ul> 
     20<li><a href="../index.html">Home</a></li> 
     21<li><a href="../introduction.html">For Users</a></li> 
     22<li><a href="bep_0000.html"><span>For Developers</span></a></li> 
     23<!-- <li><a href="./blog">Blog</a></li> --> 
     24<li><a href="http://forum.bittorrent.org"> Forums </li> 
     25<li><a href="../donate.html">Donate!</a></li> 
     26</ul> 
     27</div> <!-- nav --> 
     28<!-- ### Begin Content ### --> 
     29<div id="second"> 
     30 
     31 
     32 
     33<table class="rfc2822 docutils field-list" frame="void" rules="none"> 
     34<col class="field-name" /> 
     35<col class="field-body" /> 
     36<tbody valign="top"> 
     37<tr class="field"><th class="field-name">BEP:</th><td class="field-body">1</td> 
     38</tr> 
     39<tr class="field"><th class="field-name">Title:</th><td class="field-body">The BitTorrent Enhancement Proposal Process</td> 
     40</tr> 
     41<tr class="field"><th class="field-name">Version:</th><td class="field-body">11054</td> 
     42</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_0001.rst">2008-05-02 20:19:03 -0700 (Fri, 02 May 2008)</a></td> 
     44</tr> 
     45<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> 
     46</tr> 
     47<tr class="field"><th class="field-name">Status:</th><td class="field-body">Active</td> 
     48</tr> 
     49<tr class="field"><th class="field-name">Type:</th><td class="field-body">Process</td> 
     50</tr> 
     51<tr class="field"><th class="field-name">Created:</th><td class="field-body">10-Jan-2008</td> 
     52</tr> 
     53<tr class="field"><th class="field-name">Post-History:</th><td class="field-body"></td> 
     54</tr> 
     55</tbody> 
     56</table> 
     57<hr /> 
     58<div class="contents topic" id="contents"> 
     59<p class="topic-title first">Contents</p> 
     60<ul class="simple"> 
     61<li><a class="reference internal" href="#what-is-a-bep" id="id3">What is a BEP</a></li> 
     62<li><a class="reference internal" href="#bep-types" id="id4">BEP Types</a></li> 
     63<li><a class="reference internal" href="#bep-work-flow" id="id5">BEP Work Flow</a></li> 
     64<li><a class="reference internal" href="#intellectual-property-and-bittorrent-standards" id="id6">Intellectual Property and BitTorrent Standards</a></li> 
     65<li><a class="reference internal" href="#history" id="id7">History</a></li> 
     66<li><a class="reference internal" href="#acknowledgements" id="id8">Acknowledgements</a></li> 
     67<li><a class="reference internal" href="#references-and-footnotes" id="id9">References and Footnotes</a></li> 
     68<li><a class="reference internal" href="#copyright" id="id10">Copyright</a></li> 
     69</ul> 
     70</div> 
     71<div class="section" id="what-is-a-bep"> 
     72<h1>What is a BEP</h1> 
     73<p>BEP stands for BitTorrent Enhancement Proposal.  A BEP is a design 
     74document providing information to the BitTorrent community, or 
     75describing a new feature for the BitTorrent protocols. The BEP should 
     76provide a concise technical specification of the feature and a 
     77rationale for the feature.</p> 
     78<p>We intend BEPs to be the primary mechanisms for proposing new 
     79features, for collecting community input on an issue, and for 
     80documenting the design decisions that have gone into BitTorrent. The BEP 
     81author is responsible for building consensus within the community and 
     82documenting dissenting opinions.</p> 
     83<p>Because the BEPs are maintained as reStructured text files in a versioned 
     84repository, their revision history is the historical record of the 
     85feature proposal <a class="footnote-reference" href="#svn" id="id1">[1]</a>.</p> 
     86</div> 
     87<div class="section" id="bep-types"> 
     88<h1>BEP Types</h1> 
     89<p>There are three kinds of BEP:</p> 
     90<blockquote> 
     91<ol class="arabic simple"> 
     92<li>A Standards Track BEP describes an extension to one of the BitTorrent 
     93protocols or a change in the behavior of one of the actors in these 
     94protocols, where the actors are currently clients, trackers, and web 
     95servers.</li> 
     96<li>An Informational BEP describes a BitTorrent design issue, or 
     97provides general guidelines or information to the BitTorrent 
     98community, but does not propose an extension. Informational BEPs 
     99do not necessarily represent a BitTorrent community consensus or 
     100recommendation, so users and implementors are free to ignore 
     101Informational BEPs or follow their advice.</li> 
     102<li>A Process BEP describes a process surrounding BitTorrent, or 
     103proposes a change to (or an event in) a process. Process BEPs are 
     104like Standards Track BEPs but apply to areas other than the 
     105BitTorrent protocols.  They are more than recommendations, and 
     106users are typically not free to ignore them. Examples include 
     107release schedules, procedures, guidelines, changes to the 
     108decision-making process, and changes to the tools or environment 
     109used in BitTorrent development.</li> 
     110</ol> 
     111</blockquote> 
     112</div> 
     113<div class="section" id="bep-work-flow"> 
     114<h1>BEP Work Flow</h1> 
     115<p>The BEP editors assign BEP numbers and change their status. The 
     116current BEP editors are David Harrison and Arvid Norberg. Please send 
     117all BEP-related email to &lt;<a class="reference external" href="mailto:editor&#37;&#52;&#48;bittorrent&#46;org">editor<span>&#64;</span>bittorrent<span>&#46;</span>org</a>&gt;.  Also see BEP Editor 
     118Responsibilities &amp; Workflow below.</p> 
     119<p>The BEP process begins with a new idea for the BitTorrent 
     120protocols. It is highly recommended that a single BEP contain a single 
     121key proposal. The BEP editor reserves the right to reject BEP 
     122proposals if they appear unfocussed or overly broad. If in doubt, 
     123split your BEP into muliple BEPs.</p> 
     124<p>Each BEP must have a champion -- someone who writes the BEP using the 
     125style and format described below, shepherds the discussions in the 
     126appropriate forums, and attempts to build community consensus around 
     127the idea. The BEP champion should first post a description of the idea 
     128to the BEPs forum at forum.bittorrent.org.</p> 
     129<p>If the champion believes the idea warrants a BEP then the champion 
     130emails the BEP editor &lt;<a class="reference external" href="mailto:editor&#37;&#52;&#48;bittorrent&#46;org">editor<span>&#64;</span>bittorrent<span>&#46;</span>org</a>&gt; with a proposed title 
     131and a draft of the BEP. This draft must be written in BEP style as 
     132described below.</p> 
     133<p>If the BEP editor approves, he assigns the BEP a number, labels it as 
     134Standards Track, Informational, or Process, gives it status &quot;Draft&quot;, 
     135and creates and checks-in the initial draft of the BEP to the 
     136subversion repository. The BEP editor will not unreasonably 
     137deny a BEP. Reasons for denying BEP status include duplication of 
     138effort, being technically unsound, not providing proper motivation or 
     139not addressing backwards compatibility. The BDFL (Benevolent Dictator 
     140for Life, Bram Cohen) can be consulted during the approval phase, and 
     141is the final arbiter of the draft's BEP-ability.</p> 
     142<p>If a pre-BEP is rejected, the author may elect to take the pre-BEP to 
     143the BEP forum seeking feedback and consesnsus from the community at large. 
     144A proposal may be re-submitted after it has been revised.</p> 
     145<p>The champion is then responsible for marshaling community support for 
     146it. As updates are necessary, the BEP author can check in new versions 
     147if they have SVN commit permissions, or can email new BEP versions to 
     148the BEP editor for committing.</p> 
     149<p>Standards Track BEPs consist of two parts, a design document and a 
     150reference implementation. The reference implementation need not be 
     151complete when a BEP is submitted to the editors.  However Standards 
     152Track BEPs must include an implementation in at least one BitTorrent 
     153client with publicy available code before it can be considered Final.</p> 
     154<p>BEP champions are responsible for collecting community feedback on a 
     155BEP before submitting it for review. A BEP that has not been discussed 
     156in the BEPs forum on forum.bittorrent.org will not be 
     157accepted. However, wherever possible, long open-ended discussions in 
     158the BEP forum should be avoided. Strategies to keep the discussions 
     159efficient include: setting up a separate SIG forum for the topic, 
     160having the BEP author accept private comments in the early design 
     161phases, setting up a wiki page, etc. BEP authors should use their 
     162discretion here.</p> 
     163<p>Once the authors have completed a BEP, they must inform the BEP editor 
     164that it is ready for review. BEPs are reviewed by the BDFL and his 
     165chosen consultants, who may accept or reject a BEP or send it back to 
     166the author(s) for revision. For a BEP that is pre-determined to be 
     167acceptable (e.g., it is an obvious win as-is and/or its implementation 
     168already exists in one or more popular BitTorrent clients) the BDFL may 
     169also initiate a BEP review, first notifying the BEP author(s) and 
     170giving them a chance to make revisions.</p> 
     171<p>For a BEP to be accepted it must meet certain minimum criteria. It 
     172must be a clear and complete description of the proposed 
     173enhancement. The enhancement must represent a net improvement. The 
     174proposed implementation, if applicable, must be functional and have 
     175been tested in live BitTorrent swarms.  Supporting results from 
     176analyses, testbed experiments and event-based simulations are also 
     177recommended where appropriate.  A Standards Track document should 
     178include the rationale behind a proposal and may briefly summarize 
     179analytical, simulation, or experimental results where necessary to 
     180illustrate or motivate the enhancement.  However, detailed analytical, 
     181simulation, and experiment results, especially comparing different 
     182approaches to the same problem should be omitted from Standards Track 
     183BEPs and instead cited from a published paper or a separate 
     184Informational BEP.</p> 
     185<p>Once a BEP has been accepted, the reference implementation must be 
     186completed. When the reference implementation is complete and accepted 
     187by the BDFL, the status will be changed to &quot;Final&quot;.</p> 
     188<p>A BEP can also be assigned status &quot;Deferred&quot;. The BEP author or editor 
     189can assign the BEP this status when no progress is being made on the 
     190BEP. Once a BEP is deferred, the BEP editor can re-assign it to draft 
     191status.</p> 
     192<p>A BEP can also be &quot;Rejected&quot;. Perhaps after all is said and done it 
     193was not a good idea. It is still important to have a record of this 
     194fact.</p> 
     195<p>BEPs can also be replaced by a different BEP, rendering the original 
     196obsolete. This is intended for Informational BEPs, where version 2 of 
     197an API can replace version 1.</p> 
     198<p>The possible paths of the status of BEPs are as follows:</p> 
     199<img alt="bep_0001_1.png" src="bep_0001_1.png" /> 
     200</div> 
     201<div class="section" id="intellectual-property-and-bittorrent-standards"> 
     202<h1>Intellectual Property and BitTorrent Standards</h1> 
     203<p>Any idea submitted in a BEP will not be considered for standardization 
     204if the idea is not in the public domain.  Before a BEP can be 
     205considered Final, all people (including the BEP authors) or entities 
     206with a claim on the intellectual property expressed in a BEP must 
     207assign in writing all intellectual property expressed in the BEP to 
     208the public domain.  If the BEP authors lack the power to assign 
     209intellectual property rights then they must disclose this fact before 
     210the BEP can be considered Final.</p> 
     211<p>Furthermore BEP authors should not knowingly propose anything in their 
     212BEPs that infringes on the intellectual property rights of others.</p> 
     213<p>This policy statement should not be construed as meaning that BEP 
     214authors are required to assign software implementations of any 
     215particular idea to the public domain.  BitTorrent implementors may 
     216retain all rights to their implementations.</p> 
     217</div> 
     218<div class="section" id="history"> 
     219<h1>History</h1> 
     220<p>This document was derived heavily from PEP-0001 <a class="footnote-reference" href="#pep-1" id="id2">[2]</a>.  In many places 
     221text was simply copied and modified.  Although the PEP-0001 text 
     222was written by Barry Warsaw, Jeremy Hylton, and David Goodger, they 
     223are not responsible for its use in the BitTorent Enhancement Process, 
     224and should not be bothered with technical questions specific to 
     225BitTorrent or the BEP process.  Please direct all comments to the 
     226BitTorrent editors &lt;<a class="reference external" href="mailto:editor&#37;&#52;&#48;bittorrent&#46;org">editor<span>&#64;</span>bittorrent<span>&#46;</span>org</a>&gt; or the forums at 
     227forum.bittorrent.org.</p> 
     228</div> 
     229<div class="section" id="acknowledgements"> 
     230<h1>Acknowledgements</h1> 
     231<p>Thanks to Barry Warsaw, David Goodger, and Guido van Rossum for their 
     232guidance.</p> 
     233</div> 
     234<div class="section" id="references-and-footnotes"> 
     235<h1>References and Footnotes</h1> 
     236<table class="docutils footnote" frame="void" id="svn" rules="none"> 
     237<colgroup><col class="label" /><col /></colgroup> 
     238<tbody valign="top"> 
     239<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td>This historical record is available by the normal SVN 
     240commands for retrieving older revisions. For those without direct 
     241access to the SVN tree, you can browse the current and past BEP 
     242revisions here: <a class="reference external" href="http://bittorrent.org/trac/">http://bittorrent.org/trac/</a></td></tr> 
     243</tbody> 
     244</table> 
     245<table class="docutils footnote" frame="void" id="pep-1" rules="none"> 
     246<colgroup><col class="label" /><col /></colgroup> 
     247<tbody valign="top"> 
     248<tr><td class="label"><a class="fn-backref" href="#id2">[2]</a></td><td>PEP-001: PEP Purposes and Guidelines, Warsaw, Hylton, Goodger. 
     249(<a class="reference external" href="http://www.python.org/dev/peps/pep-0001">http://www.python.org/dev/peps/pep-0001</a>)</td></tr> 
     250</tbody> 
     251</table> 
     252</div> 
     253<div class="section" id="copyright"> 
     254<h1>Copyright</h1> 
     255<p>This document has been placed in the public domain.</p> 
     256<!-- Local Variables: 
     257mode: indented-text 
     258indent-tabs-mode: nil 
     259sentence-end-double-space: t 
     260fill-column: 70 
     261coding: utf-8 
     262End: --> 
     263</div> 
     264 
     265 
     266</div> 
     267        <div id="footer"> 
     268<hr/> 
     269</div> 
     270 
     271</div> 
     272</body> 
     273</html> 

  • dotorg/trunk/html/beps/bep_0004.html

    r11093 r11107  
    3939<tr class="field"><th class="field-name">Title:</th><td class="field-body">Assigned Numbers</td> 
    4040</tr> 
    41 <tr class="field"><th class="field-name">Version:</th><td class="field-body">11031</td> 
     41<tr class="field"><th class="field-name">Version:</th><td class="field-body">11093</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_0004.rst">2008-02-28 16:43:58 -0800 (Thu, 28 Feb 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_0004.rst">2008-05-20 19:01:53 -0700 (Tue, 20 May 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> 

  • dotorg/trunk/html/beps/bep_0007.html

    r11098 r11107  
    3939<tr class="field"><th class="field-name">Title:</th><td class="field-body">IPv6 Tracker Extension</td> 
    4040</tr> 
    41 <tr class="field"><th class="field-name">Version:</th><td class="field-body">11031</td> 
     41<tr class="field"><th class="field-name">Version:</th><td class="field-body">11098</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_0007.rst">2008-02-28 16:43:58 -0800 (Thu, 28 Feb 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_0007.rst">2008-05-21 00:08:51 -0700 (Wed, 21 May 2008)</a></td> 
    4444</tr> 
    4545<tr class="field"><th class="field-name">Author:</th><td class="field-body">Greg Hazel &lt;greg&#32;&#97;t&#32;bittorrent.com&gt;, Arvid Norberg &lt;arvid&#32;&#97;t&#32;bittorrent.com&gt;</td> 

  • dotorg/trunk/html/beps/bep_0022.html

    r11088 r11107  
    3939<tr class="field"><th class="field-name">Title:</th><td class="field-body">BitTorrent Cache Discovery Protocol</td> 
    4040</tr> 
    41 <tr class="field"><th class="field-name">Version:</th><td class="field-body">11087</td> 
    42 </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_0022.rst">2008-05-19 16:16:31 -0700 (Mon, 19 May 2008)</a></td> 
     41<tr class="field"><th class="field-name">Version:</th><td class="field-body">11101</td> 
     42</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_0022.rst">2008-05-27 19:02:55 -0700 (Tue, 27 May 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;, Stanislav Shalunov &lt;shalunov&#32;&#97;t&#32;bittorrent.com&gt;, Greg Hazel &lt;greg&#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="#motivation" id="id9">Motivation</a></li> 
    64 <li><a class="reference internal" href="#the-discovery-mechanism" id="id10">The Discovery Mechanism</a></li> 
    65 <li><a class="reference internal" href="#iterative-queries" id="id11">Iterative Queries</a></li> 
    66 <li><a class="reference internal" href="#network-address-translators" id="id12">Network Address Translators</a></li> 
    67 <li><a class="reference internal" href="#example" id="id13">Example</a></li> 
    68 <li><a class="reference internal" href="#references" id="id14">References</a></li> 
    69 <li><a class="reference internal" href="#copyright" id="id15">Copyright</a></li> 
     63<li><a class="reference internal" href="#motivation" id="id10">Motivation</a></li> 
     64<li><a class="reference internal" href="#the-discovery-mechanism" id="id11">The Discovery Mechanism</a></li> 
     65<li><a class="reference internal" href="#iterative-queries" id="id12">Iterative Queries</a></li> 
     66<li><a class="reference internal" href="#network-address-translators" id="id13">Network Address Translators</a></li> 
     67<li><a class="reference internal" href="#example" id="id14">Example</a></li> 
     68<li><a class="reference internal" href="#references" id="id15">References</a></li> 
     69<li><a class="reference internal" href="#copyright" id="id16">Copyright</a></li> 
    7070</ul> 
    7171</div> 
    … …  
    8686those that share the access network.  When subsequent peers transfer 
    8787from their ISP's cache, the ISP experiences less transit traffic.</p> 
     88<p>The key words &quot;MUST&quot;, &quot;MUST NOT&quot;, &quot;REQUIRED&quot;, &quot;SHALL&quot;, &quot;SHALL 
     89NOT&quot;, &quot;SHOULD&quot;, &quot;SHOULD NOT&quot;, &quot;RECOMMENDED&quot;,  &quot;MAY&quot;, and 
     90&quot;OPTIONAL&quot; in this document are to be interpreted as described in 
     91IETF <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> 
    8892</div> 
    8993<div class="section" id="the-discovery-mechanism"> 
    … …  
    113117tracker is called a <em>cache tracker</em>, but the protocol to talk to this 
    114118tracker is no different from the standard BitTorrent tracker protocol 
    115 described in <a class="footnote-reference" href="#bep-3" id="id1">[1]</a>.</p> 
     119described in <a class="footnote-reference" href="#bep-3" id="id2">[1]</a>.</p> 
    116120<p>When the BitTorrent client joins a swarm it announces to one or more 
    117121of the trackers referenced in the .torrent file and announces to the 
    … …  
    119123other peers that announced the same file to the cache tracker.</p> 
    120124<p>A cache is a BitTorrent peer.  A client MAY treat it preferentially.</p> 
    121 <p>Reverse DNS lookups are described in <a class="reference external" href="http://www.faqs.org/rfcs/rfc1034.html">RFC 1034</a> <a class="footnote-reference" href="#rfc-1034" id="id2">[4]</a>. 
    122 The SRV resource record type is described in <a class="reference external" href="http://www.faqs.org/rfcs/rfc2782.html">RFC 2782</a> <a class="footnote-reference" href="#rfc-2782" id="id3">[5]</a>.</p> 
     125<p>Reverse DNS lookups are described in <a class="reference external" href="http://www.faqs.org/rfcs/rfc1034.html">RFC 1034</a> <a class="footnote-reference" href="#rfc-1034" id="id3">[4]</a>. 
     126The SRV resource record type is described in <a class="reference external" href="http://www.faqs.org/rfcs/rfc2782.html">RFC 2782</a> <a class="footnote-reference" href="#rfc-2782" id="id4">[6]</a>.</p> 
    123127</div> 
    124128<div class="section" id="iterative-queries"> 
    … …  
    132136</pre> 
    133137<p>However, if wildcards are implemented according to the algorithm in 
    134 section 4.3.2 in <a class="footnote-reference" href="#rfc-1034" id="id4">[4]</a> then all subdomains of pacbell.net that 
     138section 4.3.2 in <a class="footnote-reference" href="#rfc-1034" id="id5">[4]</a> then all subdomains of pacbell.net that 
    135139do not have an exact label match will match the wildcard.  Thus,</p> 
    136140<pre class="literal-block"> 
    … …  
    150154_bittorrent-tracker._tcp.*.pacbell.net 
    151155</pre> 
    152 <p>However, section 4.3.3 in <a class="footnote-reference" href="#rfc-1034" id="id5">[4]</a> specifies that wildcards only 
     156<p>However, section 4.3.3 in <a class="footnote-reference" href="#rfc-1034" id="id6">[4]</a> specifies that wildcards only 
    153157appear as the first label in a domain name.  This restriction was 
    154 lifted in <a class="footnote-reference" href="#rfc-4592" id="id6">[6]</a>, but not with semantics applicable to our use 
     158lifted in <a class="footnote-reference" href="#rfc-4592" id="id7">[7]</a>, but not with semantics applicable to our use 
    155159case.  An asterisk not at the beginning of a domain name is not 
    156160treated like a wildcard.  Only a lookup for the exact domain name</p> 
    … …  
    159163</pre> 
    160164<p>matches.</p> 
    161 <p>We propose an alternative that avoids wildcards and has the advantage 
    162 that it allows suborganizations to override the SRV records provided 
    163 by parent organizations: the peer starts by querying using its 
    164 fully-qualified domain name returned from the reverse DNS lookup, and 
    165 if this fails then it queries again after removing the most specific 
    166 (leftmost) label in the domain name.  For example, if no SRV records 
    167 are returned when querying for</p> 
     165<p>We propose an alternative that avoids wildcards and allows 
     166suborganizations to override SRV records provided by parent 
     167organizations: the peer starts by querying using its fully-qualified 
     168domain name returned from the reverse DNS lookup, and if this fails 
     169then it queries again after removing the most specific (leftmost) 
     170label in the domain name.  For example, if no SRV records are returned 
     171when querying for</p> 
    168172<pre class="literal-block"> 
    169173_bittorrent-tracker._tcp.adsl-69-107-0-14.dsl.pltn13.pacbell.net 
    … …  
    177181_bittorrent-tracker.pltn13.pacbell.net 
    178182</pre> 
    179 <p>The search removes one domain at a time terminating when one or more