-
-
- integer() string() list() dict() type() -
- operator[] -
- find_key() +
- entry -
- torrent_info
-
-
- torrent_info() -
- add_tracker() -
- files() orig_files() -
- rename_file() -
- begin_files() end_files() rbegin_files() rend_files() -
- num_files() file_at() -
- map_block() -
- map_file() -
- url_seeds() add_url_seed() http_seeds() add_http_seed() -
- trackers() -
- total_size() piece_length() piece_size() num_pieces() -
- hash_for_piece() hash_for_piece_ptr() info_hash() -
- name() comment() creation_date() creator() -
- priv() -
- nodes() -
- add_node() -
- metadata() metadata_size() +
- torrent_info
-
+
- torrent_info() +
- add_tracker() +
- files() orig_files() +
- rename_file() +
- begin_files() end_files() rbegin_files() rend_files() +
- num_files() file_at() +
- map_block() +
- map_file() +
- url_seeds() add_url_seed() http_seeds() add_http_seed() +
- trackers() +
- total_size() piece_length() piece_size() num_pieces() +
- hash_for_piece() hash_for_piece_ptr() info_hash() +
- name() comment() creation_date() creator() +
- priv() +
- nodes() +
- add_node() +
- metadata() metadata_size()
- - torrent_handle
-
-
- set_piece_deadline() -
- piece_priority() prioritize_pieces() piece_priorities() -
- file_priority() prioritize_files() file_priorities() -
- file_progress() -
- save_path() -
- move_storage() -
- rename_file() -
- get_storage_impl() -
- super_seeding() -
- add_piece() -
- read_piece() -
- force_reannounce() -
- scrape_tracker() -
- connect_peer() -
- name() -
- set_ratio() -
- set_upload_limit() set_download_limit() upload_limit() download_limit() -
- set_sequential_download() is_sequential_download() -
- set_peer_upload_limit() set_peer_download_limit() -
- pause() resume() is_paused() -
- force_recheck() -
- clear_error() -
- set_upload_mode() -
- resolve_countries() -
- is_seed() -
- is_auto_managed() auto_managed() -
- has_metadata() set_metadata() -
- set_tracker_login() -
- trackers() replace_trackers() add_tracker() -
- add_url_seed() remove_url_seed() url_seeds() -
- add_http_seed() remove_http_seed() http_seeds() -
- queue_position() queue_position_up() queue_position_down() queue_position_top() queue_position_bottom() -
- use_interface() -
- info_hash() -
- set_max_uploads() max_uploads() set_max_connections() max_connections() -
- save_resume_data() -
- status() -
- get_download_queue() -
- get_peer_info() -
- get_torrent_info() -
- is_valid() +
- torrent_handle
-
+
- set_piece_deadline() +
- piece_priority() prioritize_pieces() piece_priorities() +
- file_priority() prioritize_files() file_priorities() +
- file_progress() +
- save_path() +
- move_storage() +
- rename_file() +
- get_storage_impl() +
- super_seeding() +
- add_piece() +
- read_piece() +
- force_reannounce() +
- scrape_tracker() +
- connect_peer() +
- name() +
- set_ratio() +
- set_upload_limit() set_download_limit() upload_limit() download_limit() +
- set_sequential_download() is_sequential_download() +
- set_peer_upload_limit() set_peer_download_limit() +
- pause() resume() is_paused() +
- force_recheck() +
- clear_error() +
- set_upload_mode() +
- resolve_countries() +
- is_seed() +
- is_auto_managed() auto_managed() +
- has_metadata() set_metadata() +
- set_tracker_login() +
- trackers() replace_trackers() add_tracker() +
- add_url_seed() remove_url_seed() url_seeds() +
- add_http_seed() remove_http_seed() http_seeds() +
- queue_position() queue_position_up() queue_position_down() queue_position_top() queue_position_bottom() +
- use_interface() +
- info_hash() +
- set_max_uploads() max_uploads() set_max_connections() max_connections() +
- save_resume_data() +
- status() +
- get_download_queue() +
- get_peer_info() +
- get_torrent_info() +
- is_valid()
- - torrent_status -
- peer_info -
- session customization
-
-
- presets -
- session_settings +
- torrent_status +
- peer_info +
- session customization -
- pe_settings -
- proxy_settings -
- ip_filter
-
-
- ip_filter() -
- add_rule() -
- access() -
- export_filter() +
- pe_settings +
- proxy_settings +
- ip_filter -
- big_number -
- bitfield -
- hasher -
- fingerprint -
- UPnP and NAT-PMP
-
-
- add_mapping -
- delete_mapping -
- router_model() +
- big_number +
- bitfield +
- hasher +
- fingerprint +
- UPnP and NAT-PMP -
- free functions
-
-
- identify_client() -
- client_fingerprint() -
- bdecode() bencode() -
- add_magnet_uri() -
- make_magnet_uri() +
- free functions -
- alerts
-
-
- read_piece_alert -
- external_ip_alert -
- listen_failed_alert -
- portmap_error_alert -
- portmap_alert -
- portmap_log_alert -
- file_error_alert -
- file_renamed_alert -
- file_rename_failed_alert -
- tracker_announce_alert -
- tracker_error_alert -
- tracker_reply_alert -
- dht_reply_alert -
- tracker_warning_alert -
- scrape_reply_alert -
- scrape_failed_alert -
- url_seed_alert -
- hash_failed_alert -
- peer_alert -
- peer_ban_alert -
- peer_snubbed_alert -
- peer_unsnubbed_alert -
- peer_error_alert -
- peer_connected_alert -
- peer_disconnected_alert -
- invalid_request_alert -
- request_dropped_alert -
- block_timeout_alert -
- block_finished_alert -
- block_downloading_alert -
- unwanted_block_alert -
- torrent_delete_failed_alert -
- torrent_finished_alert -
- performance_alert -
- state_changed_alert -
- metadata_failed_alert -
- metadata_received_alert -
- fastresume_rejected_alert -
- peer_blocked_alert -
- storage_moved_alert -
- storage_moved_failed_alert -
- torrent_paused_alert -
- torrent_resumed_alert -
- save_resume_data_alert -
- save_resume_data_failed_alert -
- dht_announce_alert -
- dht_get_peers_alert -
- dispatcher +
- alerts
-
+
- read_piece_alert +
- external_ip_alert +
- listen_failed_alert +
- portmap_error_alert +
- portmap_alert +
- portmap_log_alert +
- file_error_alert +
- file_renamed_alert +
- file_rename_failed_alert +
- tracker_announce_alert +
- tracker_error_alert +
- tracker_reply_alert +
- dht_reply_alert +
- tracker_warning_alert +
- scrape_reply_alert +
- scrape_failed_alert +
- url_seed_alert +
- hash_failed_alert +
- peer_alert +
- peer_ban_alert +
- peer_snubbed_alert +
- peer_unsnubbed_alert +
- peer_error_alert +
- peer_connected_alert +
- peer_disconnected_alert +
- invalid_request_alert +
- request_dropped_alert +
- block_timeout_alert +
- block_finished_alert +
- file_completed_alert +
- block_downloading_alert +
- unwanted_block_alert +
- torrent_delete_failed_alert +
- torrent_finished_alert +
- performance_alert +
- state_changed_alert +
- metadata_failed_alert +
- metadata_received_alert +
- fastresume_rejected_alert +
- peer_blocked_alert +
- storage_moved_alert +
- storage_moved_failed_alert +
- torrent_paused_alert +
- torrent_resumed_alert +
- save_resume_data_alert +
- save_resume_data_failed_alert +
- dht_announce_alert +
- dht_get_peers_alert +
- dispatcher
- - exceptions
-
-
- libtorrent_exception +
- exceptions -
- error_code
-
-
- translating error codes +
- error_code -
- storage_interface
-
-
- initialize() -
- has_any_file() -
- readv() writev() -
- sparse_end() -
- move_storage() -
- verify_resume_data() -
- write_resume_data() -
- move_slot() -
- swap_slots() -
- swap_slots3() -
- rename_file() -
- release_files() -
- delete_files() +
- storage_interface -
- magnet links -
- queuing
-
-
- downloading -
- seeding +
- magnet links +
- queuing -
- fast resume
-
-
- file format +
- fast resume -
- threads -
- storage allocation
-
-
- sparse allocation -
- full allocation -
- compact allocation +
- threads +
- storage allocation -
- extensions
@@ -452,6 +454,7 @@ class session: public boost::noncopyable entry state() const; void set_ip_filter(ip_filter const& f); + ip_filter const& get_ip_filter() const; session_status status() const; cache_status get_cache_status() const; @@ -853,6 +856,16 @@ accepted and not, see ip_filter<+
Each time a peer is blocked because of the IP filter, a peer_blocked_alert is generated.
+get_ip_filter()
++
+-
+
- :: +
- ip_filter const& get_ip_filter() const; +
Returns the ip_filter currently in the session. See ip_filter.
+status()
@@ -876,28 +889,28 @@ struct session_status { bool has_incoming_connections; - float upload_rate; - float download_rate; + int upload_rate; + int download_rate; size_type total_download; size_type total_upload; - float payload_upload_rate; - float payload_download_rate; + int payload_upload_rate; + int payload_download_rate; size_type total_payload_download; size_type total_payload_upload; - float ip_overhead_upload_rate; - float ip_overhead_download_rate; + int ip_overhead_upload_rate; + int ip_overhead_download_rate; size_type total_ip_overhead_download; size_type total_ip_overhead_upload; - float dht_upload_rate; - float dht_download_rate; + int dht_upload_rate; + int dht_download_rate; size_type total_dht_download; size_type total_dht_upload; - float tracker_upload_rate; - float tracker_download_rate; + int tracker_upload_rate; + int tracker_download_rate; size_type total_tracker_download; size_type total_tracker_upload; @@ -1921,7 +1934,7 @@ struct torrent_handle torrent_handle(); torrent_status status(); - void file_progress(std::vector<size_type>& fp); + void file_progress(std::vector<size_type>& fp, int flags = 0); void get_download_queue(std::vector<partial_piece_info>& queue) const; void get_peer_info(std::vector<peer_info>& v) const; torrent_info const& get_torrent_info() const; @@ -2123,7 +2136,7 @@ particular pieces, piece_priority
file_progress()
-void file_progress(std::vector<size_type>& fp); +void file_progress(std::vector<size_type>& fp, int flags = 0);
This function fills in the supplied vector with the the number of bytes downloaded @@ -2131,6 +2144,13 @@ of each file in this torrent. The progress values are ordered the same as the fi in the torrent_info. This operation is not very cheap. Its complexity is O(n + mj). Where n is the number of files, m is the number of downloading pieces and j is the number of blocks in a piece.
+The flags parameter can be used to specify the granularity of the file progress. If +left at the default value of 0, the progress will be as accurate as possible, but also +more expensive to calculate. If torrent_handle::piece_granularity is specified, +the progress will be specified in piece granularity. i.e. only pieces that have been +fully downloaded and passed the hash check count. When specifying piece granularity, +the operation is a lot cheaper, since libtorrent already keeps track of this internally +and no calculation is required.
save_path()
@@ -2806,6 +2826,7 @@ struct torrent_status state_t state; bool paused; float progress; + int progress_ppm; std::string error; boost::posix_time::time_duration next_announce; @@ -2822,11 +2843,11 @@ struct torrent_status size_type total_failed_bytes; size_type total_redundant_bytes; - float download_rate; - float upload_rate; + int download_rate; + int upload_rate; - float download_payload_rate; - float upload_payload_rate; + int download_payload_rate; + int upload_payload_rate; int num_peers; @@ -2846,6 +2867,10 @@ struct torrent_status size_type total_wanted; int num_seeds; + + int distributed_full_copies; + int distributed_fraction; + float distributed_copies; int block_size; @@ -2880,8 +2905,11 @@ struct torrent_status };progress is a value in the range [0, 1], that represents the progress of the -torrent's current task. It may be checking files or downloading. The torrent's -current task is in the state member, it will be one of the following:
+torrent's current task. It may be checking files or downloading. +progress_ppm reflects the same value as progress, but instead in a range +[0, 1000000] (ppm = parts per million). When floating point operations are disabled, +this is the only alternative to the floating point value in progress.
+The torrent's current task is in the state member, it will be one of the following:
+@@ -3000,16 +3028,23 @@ are filtered as not wanted. excluding pieces that have been filtered. num_seeds is the number of peers that are seeding that this client is currently connected to.
-distributed_copies is the number of distributed copies of the torrent. -Note that one copy may be spread out among many peers. The integer part -tells how many copies there are currently of the rarest piece(s) among the -peers this client is connected to. The fractional part tells the share of -pieces that have more copies than the rarest piece(s). For example: 2.5 would -mean that the rarest pieces have only 2 copies among the peers this torrent is -connected to, and that 50% of all the pieces have more than two copies.
+distributed_full_copies is the number of distributed copies of the torrent. +Note that one copy may be spread out among many peers. It tells how many copies +there are currently of the rarest piece(s) among the peers this client is +connected to.
+distributed_fraction tells the share of pieces that have more copies than +the rarest piece(s). Divide this number by 1000 to get the fraction.
+For example, if distributed_full_copies is 2 and distrbuted_fraction +is 500, it means that the rarest pieces have only 2 copies among the peers +this torrent is connected to, and that 50% of all the pieces have more than +two copies.
If we are a seed, the piece picker is deallocated as an optimization, and piece availability is no longer tracked. In this case the distributed -copies is set to -1.
+copies members are set to -1. +distributed_copies is a floating point representation of the +distributed_full_copies as the integer part and distributed_fraction +/ 1000 as the fraction part. If floating point operations are disabled +this value is always -1.
block_size is the size of a block, in bytes. A block is a sub piece, it is the number of bytes that each piece request asks for and the number of bytes that each bit in the partial_piece_info's bitset represents @@ -3103,10 +3138,10 @@ struct peer_info char write_state; asio::ip::tcp::endpoint ip; - float up_speed; - float down_speed; - float payload_up_speed; - float payload_down_speed; + int up_speed; + int down_speed; + int payload_up_speed; + int payload_down_speed; size_type total_download; size_type total_upload; peer_id pid; @@ -3168,6 +3203,7 @@ struct peer_info int upload_rate_peak; float progress; + int progress_ppm; };
The flags attribute tells you in which state the peer is. It is set to @@ -3375,7 +3411,7 @@ string.
bytes per second.pending_disk_bytes is the number of bytes this peer has pending in the disk-io thread. Downloaded and waiting to be written to disk. This is what -is capped by session_settings::max_outstanding_disk_bytes_per_connection.
+is capped by session_settings::max_queued_disk_bytes.send_quota and receive_quota are the number of bytes this peer has been assigned to be allowed to send and receive until it has to request more quota from the bandwidth manager.
@@ -3385,7 +3421,10 @@ estimated by timing the the tcp cdownload_rate_peak and upload_rate_peak are the highest download and upload rates seen on this connection. They are given in bytes per second. This number is reset to 0 on reconnect.
-progress is the progress of the peer.
+progress is the progress of the peer in the range [0, 1]. This is always 0 when +floating point operations are diabled, instead use progress_ppm.
+progress_ppm indicates the download progress of the peer in the range [0, 1000000] +(parts per million).
session customization
@@ -3495,6 +3534,8 @@ struct session_settings bool rate_limit_ip_overhead; bool announce_to_all_trackers; + bool announce_to_all_tiers; + bool prefer_udp_trackers; bool strict_super_seeding; @@ -3522,6 +3563,7 @@ struct session_settings int write_cache_line_size; int optimistic_disk_retry; + bool disable_hash_check; };user_agent this is the client identification to the tracker. @@ -3672,9 +3714,9 @@ of time, on upload slot is closed. The number of upload slots will never be less than what has been set by session::set_max_uploads(). To query the current number of upload slots, see session_status::allowed_upload_slots.
When auto_upload_slots_rate_based is set, and auto_upload_slots is set, -the max upload slots setting is ignored and decided completely automatically. +the max upload slots setting is used as a minimum number of unchoked slots. This algorithm is designed to prevent the peer from spreading its upload -capacity too thin.
+capacity too thin, but still open more slots in order to utilize the full capacity.use_parole_mode specifies if parole mode should be used. Parole mode means that peers that participate in pieces that fail the hash check are put in a mode where they are only allowed to download whole pieces. If the whole piece a peer @@ -3781,10 +3823,13 @@ drained from the rate limiters, to avoid exceeding the limits with the total tra
announce_to_all_trackers controls how multi tracker torrents are treated. If this is set to true, all trackers in the same tier are announced to in parallel. If all trackers in tier 0 fails, all trackers -in tier 1 are announced as well. This is the uTorrent behavior. If it's -set to false, the behavior is as defined by the multi tracker -specification. It defaults to false, which is the same behavior previous -versions of libtorrent has had as well.
+in tier 1 are announced as well. If it's set to false, the behavior is as +defined by the multi tracker specification. It defaults to false, which +is the same behavior previous versions of libtorrent has had as well. +announce_to_all_tiers also controls how multi tracker torrents are +treated. When this is set to true, one tracker from each tier is announced +to. This is the uTorrent behavior. This is false by default in order +to comply with the multi-tracker specification.
prefer_udp_trackers is true by default. It means that trackers may be rearranged in a way that udp trackers are always tried before http trackers for the same hostname. Setting this to fails means that the @@ -3854,6 +3899,11 @@ upload mode, to test if the error condition has been fixed.
libtorrent will only do this automatically for auto managed torrents.
You can explicitly take a torrent out of upload only mode using set_upload_mode().
+disable_hash_check controls if downloaded pieces are verified against +the piece hashes in the torrent file or not. The default is false, i.e. +to verify all downloaded data. It may be useful to turn this off for performance +profiling and simulation scenarios. Do not disable the hash check for regular +bittorrent clients.
@@ -4880,7 +4930,7 @@ struct peer_disconnected_alert: peer_alert+invalid_request_alert
This is a debug alert that is generated by an incoming invalid piece request. -ìp is the address of the peer and the request is the actual incoming +Ïp is the address of the peer and the request is the actual incoming request from the peer.
struct invalid_request_alert: peer_alert @@ -4938,6 +4988,19 @@ struct block_finished_alert: peer_alert };
+file_completed_alert
+This is posted whenever an individual file completes its download. i.e. +All pieces overlapping this file have passed their hash check.
++struct file_completed_alert: torrent_alert +{ + // ... + int index; +}; ++The index member refers to the index of the file that completed.
+block_downloading_alert
This alert is generated when a block request is sent to a peer.
@@ -5691,6 +5754,22 @@ potentially better peerinvalid_lt_tracker_message The peer sent an invalid tracker exchange message + +NAT-PMP errors:
++
++ + ++ + + code +symbol +description +108 unsupported_protocol_version The NAT-PMP router responded with an unsupported protocol version @@ -5713,6 +5792,81 @@ potentially better peerfastresume data errors:
++
+ + ++ + + code +symbol +description +113 +missing_file_sizes +The resume data file is missing the 'file sizes' entry +114 +no_files_in_resume_data +The resume data file 'file sizes' entry is empty +115 +missing_pieces +The resume data file is missing the 'pieces' and 'slots' entry +116 +mismatching_number_of_files +The number of files in the resume data does not match the number +of files in the torrent +117 +mismatching_files_size +One of the files on disk has a different size than in the fast +resume file +118 +mismatching_file_timestamp +One of the files on disk has a different timestamp than in the +fast resume file +119 +not_a_dictionary +The resume data file is not a dictionary +120 +invalid_blocks_per_piece +The 'blocks per piece' entry is invalid in the resume data file +121 +missing_slots +The resume file is missing the 'slots' entry, which is required +for torrents with compact allocation +122 +too_many_slots +The resume file contains more slots than the torrent +123 +invalid_slot_list +The 'slot' entry is invalid in the resume data +124 +invalid_piece_index +One index in the 'slot' list is invalid +125 +pieces_need_reorder +The pieces on disk needs to be re-ordered for the specified +allocation mode. This happens if you specify sparse allocation +and the files on disk are using compact storage. The pieces needs +to be moved to their right position +The names of these error codes are declared in then libtorrent::errors namespace.
There is also another error category, libtorrent::upnp_category, defining errors retrned by UPnP routers. Here's a (possibly incomplete) list of UPnP error codes:
@@ -5808,13 +5962,13 @@ std::string error_code_to_string(boost::system::error_code const& ec) static const char const* swedish[] = { "inget fel", - "en fil i torrenten kolliderar med en fil från en annan torrent", + "en fil i torrenten kolliderar med en fil frÂn en annan torrent", "hash check misslyckades", - "torrent filen är inte en dictionary", - "'info'-nyckeln saknas eller är korrupt i torrentfilen", - "'info'-fältet är inte en dictionary", - "'piece length' fältet saknas eller är korrupt i torrentfilen", - "torrentfilen saknar namnfältet", + "torrent filen ‰r inte en dictionary", + "'info'-nyckeln saknas eller ‰r korrupt i torrentfilen", + "'info'-f‰ltet ‰r inte en dictionary", + "'piece length' f‰ltet saknas eller ‰r korrupt i torrentfilen", + "torrentfilen saknar namnf‰ltet", "ogiltigt namn i torrentfilen (kan vara en attack)", // ... more strings here }; @@ -5857,7 +6011,7 @@ struct storage_interface virtual int writev(file::iovec_t const* bufs, int slot, int offset, int num_bufs) = 0; virtual int sparse_end(int start) const; virtual bool move_storage(fs::path save_path) = 0; - virtual bool verify_resume_data(lazy_entry const& rd, std::string& error) = 0; + virtual bool verify_resume_data(lazy_entry const& rd, error_code& error) = 0; virtual bool write_resume_data(entry& rd) const = 0; virtual bool move_slot(int src_slot, int dst_slot) = 0; virtual bool swap_slots(int slot1, int slot2) = 0; @@ -5957,14 +6111,14 @@ The default storage moves the single file or the directory of the torrent.verify_resume_data()
-bool verify_resume_data(lazy_entry const& rd, std::string& error) = 0; +bool verify_resume_data(lazy_entry const& rd, error_code& error) = 0;
This function should verify the resume data rd with the files on disk. If the resume data seems to be up-to-date, return true. If not, set error to a description of what mismatched and return false.
The default storage may compare file sizes and time stamps of the files.
-Returning true indicates an error occurred.
+Returning false indicates an error occurred.
write_resume_data()
@@ -6249,10 +6403,14 @@ renamed, this entry contains a list of all the filenames. In the same order as in the torrent file.url-list -list of strings. List of url-seed URLs used by this torrent. +list of strings. List of url-seed URLs used by this torrent. +The urls are expected to be properly encoded and not contain +any illegal url characters. httpseeds -list of strings. List of httpseed URLs used by this torrent. +list of strings. List of httpseed URLs used by this torrent. +The urls are expected to be properly encoded and not contain +any illegal url characters. merkle tree string. In case this torrent is a merkle torrent, this is a diff --git a/docs/projects.html b/docs/projects.html index 199a95296..72af962a2 100644 --- a/docs/projects.html +++ b/docs/projects.html @@ -3,7 +3,7 @@ - + projects using libtorrent @@ -72,13 +72,13 @@ connects to the daemon. One GUI (ncurses) and one web interface (accessable through a web browser). Written by Michael Wojciechowski -and Johan Ström. +and Johan Strˆm.
tvblob
The BLOBbox represents the ability to harness all of the content available -on the web, without any filtering or pre-selection by a third party ¿ just +on the web, without any filtering or pre-selection by a third party ø just like surfing the web.
This means that anyone will have the ability to reach viewers via the Internet directly on TV, without them having to connect a PC.
diff --git a/docs/python_binding.html b/docs/python_binding.html index e9e854257..09b5a7d72 100644 --- a/docs/python_binding.html +++ b/docs/python_binding.html @@ -3,7 +3,7 @@ - +libtorrent python binding diff --git a/docs/running_tests.html b/docs/running_tests.html index 956f6f793..43d07a129 100644 --- a/docs/running_tests.html +++ b/docs/running_tests.html @@ -3,7 +3,7 @@ - +libtorrent manual diff --git a/docs/tuning.html b/docs/tuning.html index 1a147746b..aa1bf66b2 100644 --- a/docs/tuning.html +++ b/docs/tuning.html @@ -3,7 +3,7 @@ - +libtorrent manual diff --git a/docs/udp_tracker_protocol.html b/docs/udp_tracker_protocol.html index 6d54348ed..8778db217 100644 --- a/docs/udp_tracker_protocol.html +++ b/docs/udp_tracker_protocol.html @@ -3,7 +3,7 @@ - +Bittorrent udp-tracker protocol extension