FedP2P/t.go

230 lines
5.6 KiB
Go
Raw Normal View History

package torrent
2015-04-28 13:24:17 +08:00
import (
"strings"
"github.com/anacrolix/missinggo/pubsub"
2015-04-28 13:24:17 +08:00
"github.com/anacrolix/torrent/metainfo"
)
2015-09-06 10:31:23 +08:00
// The torrent's infohash. This is fixed and cannot change. It uniquely
// identifies a torrent.
func (t *Torrent) InfoHash() metainfo.Hash {
2016-04-03 16:40:43 +08:00
return t.infoHash
2015-08-02 01:55:48 +08:00
}
2016-04-20 18:10:10 +08:00
// Returns a channel that is closed when the info (.Info()) for the torrent
// has become available.
2016-04-03 16:40:43 +08:00
func (t *Torrent) GotInfo() <-chan struct{} {
t.cl.mu.Lock()
defer t.cl.mu.Unlock()
2016-05-09 13:47:39 +08:00
return t.gotMetainfo.C()
2015-04-28 13:24:17 +08:00
}
// Returns the metainfo info dictionary, or nil if it's not yet available.
func (t *Torrent) Info() *metainfo.Info {
2017-08-29 13:16:53 +08:00
t.cl.mu.Lock()
defer t.cl.mu.Unlock()
2016-04-03 16:40:43 +08:00
return t.info
}
2015-06-03 11:30:55 +08:00
// Returns a Reader bound to the torrent's data. All read calls block until
2016-01-28 14:22:10 +08:00
// the data requested is actually available.
2018-01-06 13:37:13 +08:00
func (t *Torrent) NewReader() Reader {
r := reader{
mu: &t.cl.mu,
2016-04-03 16:40:43 +08:00
t: t,
readahead: 5 * 1024 * 1024,
length: *t.length,
}
2018-01-06 13:37:13 +08:00
t.addReader(&r)
return &r
}
// Returns the state of pieces of the torrent. They are grouped into runs of
// same state. The sum of the state run lengths is the number of pieces
// in the torrent.
2016-04-03 16:40:43 +08:00
func (t *Torrent) PieceStateRuns() []PieceStateRun {
t.cl.mu.Lock()
defer t.cl.mu.Unlock()
2016-04-03 16:40:43 +08:00
return t.pieceStateRuns()
}
2015-06-23 00:02:22 +08:00
2016-04-03 16:40:43 +08:00
func (t *Torrent) PieceState(piece int) PieceState {
t.cl.mu.Lock()
defer t.cl.mu.Unlock()
2016-04-03 16:40:43 +08:00
return t.pieceState(piece)
2016-02-07 18:57:57 +08:00
}
// The number of pieces in the torrent. This requires that the info has been
// obtained first.
2016-04-03 16:40:43 +08:00
func (t *Torrent) NumPieces() int {
return t.numPieces()
2015-06-23 00:02:22 +08:00
}
// Get missing bytes count for specific piece.
func (t *Torrent) PieceBytesMissing(piece int) int64 {
t.cl.mu.Lock()
defer t.cl.mu.Unlock()
return int64(t.pieces[piece].bytesLeft())
}
// Drop the torrent from the client, and close it. It's always safe to do
// this. No data corruption can, or should occur to either the torrent's data,
// or connected peers.
2016-04-03 16:40:43 +08:00
func (t *Torrent) Drop() {
2015-06-23 00:02:22 +08:00
t.cl.mu.Lock()
2016-04-03 16:40:43 +08:00
t.cl.dropTorrent(t.infoHash)
2015-06-23 00:02:22 +08:00
t.cl.mu.Unlock()
}
2015-07-21 20:54:02 +08:00
2018-01-27 09:01:09 +08:00
// Number of bytes of the entire torrent we have completed. This is the sum of
// completed pieces, and dirtied chunks of incomplete pieces. Do not use this
// for download rate, as it can go down when pieces are lost or fail checks.
// Sample Torrent.Stats.DataBytesRead for actual file data download rate.
2016-04-03 16:40:43 +08:00
func (t *Torrent) BytesCompleted() int64 {
2015-07-21 20:54:02 +08:00
t.cl.mu.RLock()
defer t.cl.mu.RUnlock()
2016-04-03 16:40:43 +08:00
return t.bytesCompleted()
2015-07-21 20:54:02 +08:00
}
2015-12-12 11:00:07 +08:00
// The subscription emits as (int) the index of pieces as their state changes.
// A state change is when the PieceState for a piece alters in value.
2016-04-03 16:40:43 +08:00
func (t *Torrent) SubscribePieceStateChanges() *pubsub.Subscription {
return t.pieceStateChanges.Subscribe()
}
2015-11-22 15:44:33 +08:00
2015-12-12 11:00:07 +08:00
// Returns true if the torrent is currently being seeded. This occurs when the
// client is willing to upload without wanting anything in return.
2016-04-03 16:40:43 +08:00
func (t *Torrent) Seeding() bool {
2015-11-22 15:44:33 +08:00
t.cl.mu.Lock()
defer t.cl.mu.Unlock()
return t.seeding()
2015-11-22 15:44:33 +08:00
}
2015-12-12 11:03:04 +08:00
// Clobbers the torrent display name. The display name is used as the torrent
// name if the metainfo is not available.
2016-04-03 16:40:43 +08:00
func (t *Torrent) SetDisplayName(dn string) {
2015-12-12 11:03:04 +08:00
t.cl.mu.Lock()
defer t.cl.mu.Unlock()
2016-04-03 16:40:43 +08:00
t.setDisplayName(dn)
2015-12-12 11:03:04 +08:00
}
// The current working name for the torrent. Either the name in the info dict,
// or a display name given such as by the dn value in a magnet link, or "".
2016-04-03 16:40:43 +08:00
func (t *Torrent) Name() string {
t.cl.mu.Lock()
defer t.cl.mu.Unlock()
2016-04-03 16:40:43 +08:00
return t.name()
}
2016-04-20 18:10:10 +08:00
// The completed length of all the torrent data, in all its files. This is
// derived from the torrent info, when it is available.
2016-04-03 16:40:43 +08:00
func (t *Torrent) Length() int64 {
return *t.length
}
2016-01-16 22:49:04 +08:00
// Returns a run-time generated metainfo for the torrent that includes the
// info bytes and announce-list as currently known to the client.
func (t *Torrent) Metainfo() metainfo.MetaInfo {
2016-01-16 22:49:04 +08:00
t.cl.mu.Lock()
defer t.cl.mu.Unlock()
return t.newMetaInfo()
2016-01-16 22:49:04 +08:00
}
2018-01-06 13:37:13 +08:00
func (t *Torrent) addReader(r *reader) {
t.cl.mu.Lock()
defer t.cl.mu.Unlock()
2016-04-03 16:40:43 +08:00
if t.readers == nil {
2018-01-06 13:37:13 +08:00
t.readers = make(map[*reader]struct{})
}
2016-04-03 16:40:43 +08:00
t.readers[r] = struct{}{}
r.posChanged()
}
2018-01-06 13:37:13 +08:00
func (t *Torrent) deleteReader(r *reader) {
2016-04-03 16:40:43 +08:00
delete(t.readers, r)
t.readersChanged()
}
2016-04-03 16:40:43 +08:00
func (t *Torrent) DownloadPieces(begin, end int) {
t.cl.mu.Lock()
defer t.cl.mu.Unlock()
for i := begin; i < end; i++ {
if t.pieces[i].priority.Raise(PiecePriorityNormal) {
t.updatePiecePriority(i)
}
}
2016-02-04 22:18:54 +08:00
}
2016-04-03 16:40:43 +08:00
func (t *Torrent) CancelPieces(begin, end int) {
2016-02-04 22:18:54 +08:00
t.cl.mu.Lock()
defer t.cl.mu.Unlock()
for i := begin; i < end; i++ {
p := &t.pieces[i]
if p.priority == PiecePriorityNone {
continue
}
p.priority = PiecePriorityNone
t.updatePiecePriority(i)
}
2016-02-20 11:39:56 +08:00
}
2018-01-21 19:49:12 +08:00
func (t *Torrent) initFiles() {
var offset int64
2018-01-21 19:49:12 +08:00
t.files = new([]*File)
for _, fi := range t.info.UpvertedFiles() {
*t.files = append(*t.files, &File{
t,
2018-01-21 19:49:12 +08:00
strings.Join(append([]string{t.info.Name}, fi.Path...), "/"),
offset,
fi.Length,
fi,
2018-01-21 19:49:12 +08:00
PiecePriorityNone,
})
offset += fi.Length
}
2018-01-21 19:49:12 +08:00
}
// Returns handles to the files in the torrent. This requires that the Info is
// available first.
func (t *Torrent) Files() []*File {
return *t.files
}
func (t *Torrent) AddPeers(pp []Peer) {
cl := t.cl
cl.mu.Lock()
defer cl.mu.Unlock()
t.addPeers(pp)
}
// Marks the entire torrent for download. Requires the info first, see
// GotInfo. Sets piece priorities for historical reasons.
func (t *Torrent) DownloadAll() {
t.DownloadPieces(0, t.numPieces())
}
func (t *Torrent) String() string {
s := t.name()
if s == "" {
s = t.infoHash.HexString()
}
return s
}
2016-05-23 08:18:58 +08:00
func (t *Torrent) AddTrackers(announceList [][]string) {
2016-05-23 08:18:58 +08:00
t.cl.mu.Lock()
defer t.cl.mu.Unlock()
t.addTrackers(announceList)
2016-05-23 08:18:58 +08:00
}
2017-09-15 17:35:16 +08:00
func (t *Torrent) Piece(i int) *Piece {
t.cl.mu.Lock()
defer t.cl.mu.Unlock()
return &t.pieces[i]
}