Pieces

The Pieces tab displays each piece currently being downloaded by BitTorrent Mainline. If a piece is selected, then holding Shift on the keyboard while right-clicking on the pieces list will display a context menu with the option, "Log piece info...." When selected, debug information is added to the Logger tab for the currently-highlighted piece. The following is a description of each column:

  • # is the piece's number in the .torrent file.
  • Size is the size of the piece.
  • # of Blocks is the number of 16 KiB blocks that compose that single piece.
  • Blocks is the graphical progress bar for the piece. You'll notice that there are different colors displayed for different blocks. They are as follows:
    • Dark blue means the data has been downloaded and written to disk.
    • Medium blue means the data has been downloaded, but remains in the cache in memory, unwritten to disk.
    • Light blue means the data has been requested from a single peer.
    • Green means the data has been requested from multiple peers. Blocks only turn green during endgame mode.
  • Completed is the number of blocks completed in the piece.
  • Availability is the number of times this piece is seen completed within the group of peers you are currently connected to.
  • Priority shows the priority BitTorrent Mainline has assigned the piece based on the priority of the file(s) it belongs to. If the piece belongs to multiple files, then it is assigned the highest priority of the files it belongs to. If bt.prio_first_last_piece is enabled and the piece's priority is not skipped, the piece's priority gets elevated by one priority level.
  • Mode is the general evaluation of the speed at which the piece is being transferred by the peer. A piece's mode can be either fast, medium, or slow. BitTorrent Mainline uses this evaluation to determine whether a piece should be taken from fast peers or slow seeds. This is meant to try to prevent situations where a slow seed sends the same piece as a fast peer. Instead of allowing that to happen, BitTorrent Mainline attempts to have the slower seed send another piece, possibly something that might be rarer in the swarm.

© 2001-2009. BitTorrent, Inc. All rights reserved. BitTorrent, the BitTorrent Logo, and Torrent are trademarks of BitTorrent, Inc.