peer-impl.go

   1 package torrent
   2
   3 import (
   4         "github.com/RoaringBitmap/roaring"
   5         "github.com/anacrolix/torrent/metainfo"
   6 )
   7
   8 // Contains implementation details that differ between peer types, like Webseeds and regular
   9 // BitTorrent protocol connections. Some methods are underlined so as to avoid collisions with
  10 // legacy PeerConn methods.
  11 type peerImpl interface {
  12         // Trigger the actual request state to get updated
  13         handleUpdateRequests()
  14         writeInterested(interested bool) bool
  15
  16         // _cancel initiates cancellation of a request and returns acked if it expects the cancel to be
  17         // handled by a follow-up event.
  18         _cancel(RequestIndex) (acked bool)
  19         _request(Request) bool
  20         connectionFlags() string
  21         onClose()
  22         onGotInfo(*metainfo.Info)
  23         // Drop connection. This may be a no-op if there is no connection.
  24         drop()
  25         // Rebuke the peer
  26         ban()
  27         String() string
  28         connStatusString() string
  29
  30         // All if the peer should have everything, known if we know that for a fact. For example, we can
  31         // guess at how many pieces are in a torrent, and assume they have all pieces based on them
  32         // having sent haves for everything, but we don't know for sure. But if they send a have-all
  33         // message, then it's clear that they do.
  34         peerHasAllPieces() (all, known bool)
  35         peerPieces() *roaring.Bitmap
  36 }