home *** CD-ROM | disk | FTP | other *** search
/ PC World 2006 February / PCWorld_2006-02_cd.bin / software / vyzkuste / klientip2p / klientip2p.exe / BitTorrent-4.2.2.exe / README.txt < prev    next >
Text File  |  2005-12-16  |  5KB  |  134 lines
  1. About BitTorrent:
  2. =================
  3.  
  4. BitTorrent is a tool for distributing files. It's extremely easy to
  5. use - downloads are started by clicking on hyperlinks.  Whenever more
  6. than one person is downloading at once they send pieces of the file(s)
  7. to each other, thus relieving the central server's bandwidth
  8. burden. Even with many simultaneous downloads, the upload burden on
  9. the central server remains quite small, since each new downloader
  10. introduces new upload capacity.
  11.  
  12.  
  13. Instructions for users:
  14. =======================
  15.  
  16. Once you install BitTorrent, you should be able to download .torrent
  17. files.  If you have any questions, please read the FAQ:
  18.  
  19. http://www.bittorrent.com/FAQ.html
  20.  
  21. If you find a bug, check the FAQ for your bug.  If your bug is not in
  22. the FAQ, please send email to:
  23.  
  24. bugs at bittorrent.com
  25.  
  26.  
  27. Instructions for publishers:
  28. ============================
  29.  
  30. Instructions for trackerless operation are in TRACKERLESS.txt.
  31.  
  32. To start hosting -
  33.  
  34. 1) start running a tracker
  35.  
  36. First, you need a tracker. If you're on a dynamic IP or otherwise 
  37. unreliable connection, you should find someone else's tracker and 
  38. use that. Otherwise, follow the rest of this step.
  39.  
  40. Trackers refer downloaders to each other. The load on the tracker 
  41. is very small, so you only need one for all your files.
  42.  
  43. To run a tracker, execute the command bittorrent-tracker.py Here is an
  44. example -
  45.  
  46. ./bittorrent-tracker.py --port 6969 --dfile dstate
  47.  
  48. --dfile is where persistent information is kept on the tracker across 
  49. invocations. It makes everything start working again immediately if 
  50. you restart the tracker. A new one will be created if it doesn't exist 
  51. already.
  52.  
  53. The tracker must be on a net-addressable box, and you must know the 
  54. ip number or dns name of it.
  55.  
  56. The tracker outputs web logs to standard out. You can get information 
  57. about the files it's currently serving by getting its index page. 
  58.  
  59. 2) create a torrent file using maketorrent.py (GUI) or
  60. maketorrent-console.py. The GUI version, maketorrent.py is preferred.
  61.  
  62. To generate a torrent file using maketorrent-console.py and give it the file
  63. you want a torrent for and the url of the tracker
  64.  
  65. ./maketorrent-console.py myfile.ext http://my.tracker:6969/announce
  66.  
  67. This will generate a file called myfile.ext.torrent
  68.  
  69. Make sure to include the port number in the tracker url if it isn't 80.
  70.  
  71. (You may also use maketorrent.py to create trackerless torrents. See
  72. the file TRACKERLESS.txt for information about trackerless operation.)
  73.  
  74. This command may take a while to scan over the whole file hashing it.
  75.  
  76. The /announce path is special and hard-coded into the tracker. 
  77. Make sure to give the domain or ip your tracker is on instead of 
  78. my.tracker.
  79.  
  80. You can use either a dns name or an IP address in the tracker url.
  81.  
  82. 3) associate .torrent with application/x-bittorrent on your web server
  83.  
  84. The way you do this is dependent on the particular web server you're using.
  85.  
  86. You must have a web server which can serve ordinary static files and is 
  87. addressable from the internet at large.
  88.  
  89. 4) put the newly made .torrent file on your web server
  90.  
  91. Note that the file name you choose on the server must end in .torrent, so 
  92. it gets associated with the right mimetype.
  93.  
  94. 5) put up a static page which links to the location you uploaded to in step 4
  95.  
  96. The file you uploaded in step 4 is linked to using an ordinary url.
  97.  
  98. 6) start a downloader as a resume on the complete file
  99.  
  100. You have to run a downloader which already has the complete file, 
  101. so new downloaders have a place to get it from. Here's an example -
  102.  
  103. ./bittorrent-console.py --url http://my.server/myfile.torrent --saveas myfile.ext
  104.  
  105. Make sure the saveas argument points to the already complete file.
  106.  
  107. If you're running the complete downloader on the same machine or LAN as 
  108. the tracker, give a --ip parameter to the complete downloader. The --ip 
  109. parameter can be either an IP address or DNS name.
  110.  
  111. BitTorrent defaults to port 6881. If it can't use 6881, (probably because 
  112. another download is happening) it tries 6882, then 6883, etc. It gives up 
  113. after 6889.
  114.  
  115. 7) you're done!
  116.  
  117. Now you just have to get people downloading! Refer them to the page you 
  118. created in step 5.
  119.  
  120. BitTorrent can also publish whole directories - simply point
  121. btmaketorrent.py at the directory with files in it, they'll be
  122. published as one unit. All files in subdirectories will be included,
  123. although files and directories named 'CVS', 'core', 'Thumbs.db',
  124. 'desktop.ini' and beginning with a dot ('.') are ignored.
  125.  
  126.  
  127. Instructions for installation:
  128. ==============================
  129.  
  130. Instructions for Unix installation are in INSTALL.unix.txt
  131.  
  132. Instructions for Windows installation and creating Windows installers
  133. are in BUILD.windows.txt
  134.