piece

Documentation

Index

• Constants
• type Block
• type Piece
  • func NewPieces(info *metainfo.Info, files []allocator.File) []Piece
  • func (p *Piece) FindBlock(begin, length uint32) (b Block, ok bool)
  • func (p *Piece) GetBlock(i int) (b Block, ok bool)
  • func (p *Piece) NumBlocks() int
  • func (p *Piece) VerifyHash(buf []byte, h hash.Hash) bool

Constants

const BlockSize = 16 * 1024

BlockSize is the size of smallest piece data that we are going to request from peers.

Types

type Block

type Block struct {
	Index  int    // index in piece
	Begin  uint32 // offset in piece
	Length uint32 // always equal to BlockSize except the last block of a piece.
}

Block is part of a Piece that is specified in peerprotocol.Request messages.

type Piece

type Piece struct {
	Index   uint32            // index in torrent
	Length  uint32            // always equal to Info.PieceLength except last piece
	Data    filesection.Piece // the place to write downloaded bytes
	Hash    []byte
	Writing bool
	Done    bool
}

Piece of a torrent.

func NewPieces

func NewPieces(info *metainfo.Info, files []allocator.File) []Piece

NewPieces returns a slice of Pieces by mapping files to the pieces.

func (*Piece) FindBlock

func (p *Piece) FindBlock(begin, length uint32) (b Block, ok bool)

FindBlock returns the block at offset `begin` and length `length`.

func (*Piece) GetBlock

func (p *Piece) GetBlock(i int) (b Block, ok bool)

GetBlock returns the Block at index i.

func (*Piece) NumBlocks

func (p *Piece) NumBlocks() int

NumBlocks returns the number of blocks in the piece.

func (*Piece) VerifyHash

func (p *Piece) VerifyHash(buf []byte, h hash.Hash) bool

VerifyHash returns true if hash of piece data in buffer `buf` matches the hash of Piece.