Changes between Initial Version and Version 1 of archive/libtorrent.rakshasa.no/LibTorrentResume

Timestamp:

08/08/15 14:25:52 (10 years ago)

Author:

Gabor Hudiczius

Comment:

--

archive/libtorrent.rakshasa.no/LibTorrentResume

@@ +1 @@
+[[libtorrentMirror]]
+
+= Resume data =
+
+Using the functions ''torrent::Download::hash_check(true)'' and
+''torrent::Download::hash_resume_save()'' the client can tell the
+library to load and save various data that is useful when resuming a
+download. To ignore resume data call
+''torrent::Download::hash_check(true)''.
+
+The resume data is stored in the bencoded torrent as a dictionary
+under the key "libtorrent resume". All the following items are within
+that dictionary.
+
+== Completed chunks ==
+
+When resuming the library will skip hash checking for chunk ranges
+that have valid resume data. The file modification time-stamp is
+stored with the resume data, and ranges containing files whose stored
+time-stamp does not exactly match what is on the disk it will be
+invalidated. If the file size does not match it will also invalidate
+the range.
+
+== Peer addresses ==
+
+Peer addresses that are contained in torrent::AvailableList will be
+saved, which will includes connected peers as their addresses are
+copied over when a torrent is stopped.
+
+== Files ==
+
+Various file related information is stored in a list under the key
+"files". This list exactly matches the file list in the original
+torrent.
+
+  * ''mtime'': File modification time-stamp as an integer.
+  * ''priority'': The file priority as an integer between [0,3>.