-
-
- 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() force_dht_announce() -
- 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() -
- set_priority() -
- 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_availability() +
- 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() force_dht_announce() +
- 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() +
- set_priority() +
- 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 -
- listen_succeeded_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_connect_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 +
- alerts
-
+
- read_piece_alert +
- external_ip_alert +
- listen_failed_alert +
- listen_succeeded_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_connect_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
@@ -1556,6 +1558,8 @@ public: file_storage const& files() const; file_storage const& orig_files() const; + void remap_files(file_storage const& f); + void rename_file(int index, std::string const& new_filename); void rename_file(int index, std::wstring const& new_filename); @@ -1669,6 +1673,18 @@ names. Filename may be chaged using file_storage object, see the separate document on how to create torrents.++
remap_files()
++
++void remap_files(file_storage const& f); +
+Remaps the file storage to a new file layout. This can be used to, for instance, +download all data in a torrent to a single file, or to a number of fixed size +sector aligned files, regardless of the number and sizes of the files in the torrent.
+The new specified file_storage must have the exact same size as the current one.
++rename_file()
@@ -2027,6 +2043,7 @@ struct torrent_handle enum deadline_flags { alert_when_available = 1 }; void set_piece_deadline(int index, time_duration deadline, int flags = 0) const; + void piece_availability(std::vector<int>& avail) const; void piece_priority(int index, int priority) const; int piece_priority(int index) const; void prioritize_pieces(std::vector<int> const& pieces) const; @@ -2099,6 +2116,21 @@ as calling read_piece() for
In the python binding for this function, the deadline is the number of milliseconds as an integer.
+piece_availability()
++
++void piece_availability(std::vector<int>& avail) const; +
+Fills the specified std::vector<int> with the availability for each +piece in this torrent. libtorrent does not keep track of availability for +seeds, so if the torrent is seeding the availability for all pieces is +reported as 0.
+The piece availability is the number of peers that we are connected that has +advertized having a particular piece. This is the information that libtorrent +uses in order to prefer picking rare pieces.
+piece_priority() prioritize_pieces() piece_priorities()
@@ -2160,6 +2192,9 @@ sets the priorities of all the pieces in the torrent based on the vector.
Whenever a file priority is changed, all other piece priorities are reset to match the file priorities. In order to maintain sepcial priorities for particular pieces, piece_priority has to be called again for those pieces.
+You cannot set the file priorities on a torrent that does not yet +have metadata or a torrent that is a seed. file_priority(int, int) and +prioritize_files() are both no-ops for such torrents.
+file_progress()
@@ -3104,7 +3139,7 @@ larger if the pieces are larger.num_uploads is the number of unchoked peers in this torrent.
num_connections is the number of peer connections this torrent has, including half-open connections that hasn't completed the bittorrent handshake yet. This is -always <= num_peers.
+always >= num_peers.uploads_limit is the set limit of upload slots (unchoked peers) for this torrent.
connections_limit is the set limit of number of connections for this torrent.
storage_mode is one of storage_mode_allocate, storage_mode_sparse or @@ -3541,7 +3576,7 @@ struct session_settings int inactivity_timeout; int unchoke_interval; int optimistic_unchoke_interval; - address announce_ip; + std::string announce_ip; int num_want; int initial_picker_threshold; int allowed_fast_set_size; @@ -3723,7 +3758,7 @@ longer than what it takes for TCP to ramp up to it's max rate.
each optimistic unchoke. On this timer, the currently optimistically unchoked peer will change.announce_ip is the ip address passed along to trackers as the &ip= parameter. -If left as the default (default constructed), that parameter is ommited.
+If left as the default (an empty string), that parameter is omitted.num_want is the number of peers we want from each tracker request. It defines what is sent as the &num_want= parameter to the tracker.
initial_picker_threshold specifies the number of pieces we need before we diff --git a/docs/projects.html b/docs/projects.html index e72e2fee1..c58341f2f 100644 --- a/docs/projects.html +++ b/docs/projects.html @@ -40,6 +40,13 @@ project listed here, let +
+tonidoplug
+Tonidoplug is a tiny, low-power, low-cost home server and +NAS device powered by Tonido software that allows you to access +your apps, files, music and media from anywhere.
+
qBittorrent
qBittorrent is a QT bittorrent diff --git a/docs/projects.rst b/docs/projects.rst index 90a88d2c1..975613c43 100644 --- a/docs/projects.rst +++ b/docs/projects.rst @@ -21,6 +21,21 @@ project listed here, let me_ know. .. _firetorrent: http://www.fireaddons.com/ +.. container:: entry + + .. image:: tonidoplug.png + :align: right + :target: Tonidoplug_ + + **tonidoplug** + + Tonidoplug_ is a tiny, low-power, low-cost home server and + NAS device powered by Tonido software that allows you to access + your apps, files, music and media from anywhere. + + .. _Tonidoplug: http://www.tonidoplug.com/ + + .. container:: entry .. image:: qbittorrent_thumb.jpg diff --git a/docs/tonidoplug.png b/docs/tonidoplug.png new file mode 100644 index 000000000..1e30d7c81 Binary files /dev/null and b/docs/tonidoplug.png differ