00001
00002
00003
00004
00005
00006
00007
00008 char const* torrent_status_doc =
00009 "Represents the current status for a torrent.\n"
00010 "Returned by `torrent_handle.status()`.";
00011
00012 char const* torrent_status_state_doc =
00013 "The torrents current task. One of `torrent_status.states`.";
00014
00015 char const* torrent_status_paused_doc =
00016 "Indicates if this torrent is paused or not.";
00017
00018 char const* torrent_status_progress_doc =
00019 "A value in the range [0, 1], that represents the progress of\n"
00020 "the torrent's current task.";
00021
00022 char const* torrent_status_next_announce_doc =
00023 "The time until the torrent will announce itself to the\n"
00024 "tracker. An instance of `datetime.timedelta`.";
00025
00026 char const* torrent_status_announce_interval_doc =
00027 "The interval at which the torrent will reannounce itself to the\n"
00028 "tracker. An instance of `datetime.timedelta`.";
00029
00030 char const* torrent_status_current_tracker_doc =
00031 "The URL of the last working tracker. If no tracker request has\n"
00032 "been successful yet, it's set to an empty string.";
00033
00034 char const* torrent_status_total_download_doc = "";
00035 char const* torrent_status_total_upload_doc = "";
00036 char const* torrent_status_total_payload_download_doc = "";
00037 char const* torrent_status_total_payload_upload_doc = "";
00038 char const* torrent_status_total_failed_bytes_doc = "";
00039
00040 char const* session_status_doc =
00041 "";
00042 char const* session_status_has_incoming_connections_doc =
00043 "";
00044 char const* session_status_upload_rate_doc =
00045 "";
00046 char const* session_status_download_rate_doc =
00047 "";
00048 char const* session_status_payload_upload_rate_doc =
00049 "";
00050 char const* session_status_payload_download_rate_doc =
00051 "";
00052 char const* session_status_total_download_doc =
00053 "";
00054 char const* session_status_total_upload_doc =
00055 "";
00056 char const* session_status_total_payload_download_doc =
00057 "";
00058 char const* session_status_total_payload_upload_doc =
00059 "";
00060 char const* session_status_num_peers_doc =
00061 "";
00062 char const* session_status_dht_nodes_doc =
00063 "";
00064 char const* session_status_cache_nodes_doc =
00065 "";
00066 char const* session_status_dht_torrents_doc =
00067 "";
00068
00069 char const* session_doc =
00070 "";
00071 char const* session_init_doc =
00072 "The `fingerprint` is a short string that will be used in\n"
00073 "the peer-id to identify the client and the client's version.\n"
00074 "For more details see the `fingerprint` class.\n"
00075 "The constructor that only takes a fingerprint will not open\n"
00076 "a listen port for the session, to get it running you'll have\n"
00077 "to call `session.listen_on()`.";
00078
00079 char const* session_listen_on_doc =
00080 "";
00081 char const* session_is_listening_doc =
00082 "";
00083 char const* session_listen_port_doc =
00084 "";
00085
00086 char const* session_status_m_doc =
00087 "Returns an instance of `session_status` with session wide-statistics\n"
00088 "and status";
00089
00090 char const* session_start_dht_doc =
00091 "";
00092 char const* session_stop_dht_doc =
00093 "";
00094 char const* session_dht_state_doc =
00095 "";
00096
00097 char const* session_add_torrent_doc =
00098 "Adds a new torrent to the session. Return a `torrent_handle`.\n"
00099 "\n"
00100 ":Parameters:\n"
00101 " - `torrent_info`: `torrent_info` instance representing the torrent\n"
00102 " you want to add.\n"
00103 " - `save_path`: The path to the directory where files will be saved.\n"
00104 " - `resume_data (optional)`: The resume data for this torrent, as decoded\n"
00105 " with `bdecode()`. This can be acquired from a running torrent with\n"
00106 " `torrent_handle.write_resume_data()`.\n"
00107 " - `compact_mode (optional)`: If set to true (default), the storage\n"
00108 " will grow as more pieces are downloaded, and pieces are rearranged\n"
00109 " to finally be in their correct places once the entire torrent has\n"
00110 " been downloaded. If it is false, the entire storage is allocated\n"
00111 " before download begins. I.e. the files contained in the torrent\n"
00112 " are filled with zeros, and each downloaded piece is put in its\n"
00113 " final place directly when downloaded.\n"
00114 " - `block_size (optional)`: Sets the preferred request size, i.e.\n"
00115 " the number of bytes to request from a peer at a time. This block size\n"
00116 " must be a divisor of the piece size, and since the piece size is an\n"
00117 " even power of 2, so must the block size be. If the block size given\n"
00118 " here turns out to be greater than the piece size, it will simply be\n"
00119 " clamped to the piece size.\n"
00120 "\n"
00121 ":Exceptions:\n"
00122 " - `duplicate_torrent`: If the torrent you are trying to add already\n"
00123 " exists in the session (is either queued for checking, being checked\n"
00124 " or downloading) `add_torrent()` will throw `duplicate_torrent`.\n";
00125
00126 char const* session_remove_torrent_doc =
00127 "Close all peer connections associated with the torrent and tell the\n"
00128 "tracker that we've stopped participating in the swarm.";
00129
00130 char const* session_set_download_rate_limit_doc =
00131 "";
00132 char const* session_set_upload_rate_limit_doc =
00133 "";
00134 char const* session_set_max_uploads_doc =
00135 "";
00136 char const* session_set_max_connections_doc =
00137 "";
00138 char const* session_set_max_half_open_connections_doc =
00139 "Sets the maximum number of half-open connections libtorrent will\n"
00140 "have when connecting to peers. A half-open connection is one where\n"
00141 "connect() has been called, but the connection still hasn't been\n"
00142 "established (nor failed). Windows XP Service Pack 2 sets a default,\n"
00143 "system wide, limit of the number of half-open connections to 10. So, \n"
00144 "this limit can be used to work nicer together with other network\n"
00145 "applications on that system. The default is to have no limit, and passing\n"
00146 "-1 as the limit, means to have no limit. When limiting the number of\n"
00147 "simultaneous connection attempts, peers will be put in a queue waiting\n"
00148 "for their turn to get connected.";
00149
00150 char const* session_set_settings_doc =
00151 "";
00152 char const* session_set_severity_level_doc =
00153 "";
00154 char const* session_pop_alert_doc =
00155 "";
00156
00157 char const* alert_doc =
00158 "Base class for all concrete alert classes.";
00159
00160 char const* alert_msg_doc =
00161 "Returns a string describing this alert.";
00162
00163 char const* alert_severity_doc =
00164 "Returns the severity level for this alert, one of `alert.severity_levels`.";
00165
00166 char const* listen_failed_alert_doc =
00167 "This alert is generated when none of the ports, given in the\n"
00168 "port range, to `session` can be opened for listening. This alert\n"
00169 "is generated as severity level `alert.severity_levels.fatal`.";
00170
00171 char const* file_error_alert_doc =
00172 "If the storage fails to read or write files that it needs access\n"
00173 "to, this alert is generated and the torrent is paused. It is\n"
00174 "generated as severity level `alert.severity_levels.fatal`.";
00175
00176 char const* tracker_announce_alert_doc =
00177 "This alert is generated each time a tracker announce is sent\n"
00178 "(or attempted to be sent). It is generated at severity level `alert.severity_levels.info`.";
00179
00180 char const* tracker_alert_doc =
00181 "This alert is generated on tracker time outs, premature\n"
00182 "disconnects, invalid response or a HTTP response other than\n"
00183 "\"200 OK\". From the alert you can get the handle to the torrent\n"
00184 "the tracker belongs to. This alert is generated as severity level\n"
00185 "`alert.severity_levels.warning`.";
00186
00187 char const* tracker_reply_alert_doc =
00188 "This alert is only for informational purpose. It is generated when\n"
00189 "a tracker announce succeeds. It is generated with severity level\n"
00190 "`alert.severity_levels.info`.";
00191
00192 char const* tracker_warning_alert_doc =
00193 "This alert is triggered if the tracker reply contains a warning\n"
00194 "field. Usually this means that the tracker announce was successful\n"
00195 ", but the tracker has a message to the client. The message string in\n"
00196 "the alert will contain the warning message from the tracker. It is\n"
00197 "generated with severity level `alert.severity_levels.warning`.";
00198
00199 char const* url_seed_alert_doc =
00200 "This alert is generated when a HTTP seed name lookup fails. This\n"
00201 "alert is generated as severity level `alert.severity_levels.warning`.";
00202
00203 char const* hash_failed_alert_doc =
00204 "This alert is generated when a finished piece fails its hash check.\n"
00205 "You can get the handle to the torrent which got the failed piece\n"
00206 "and the index of the piece itself from the alert. This alert is\n"
00207 "generated as severity level `alert.severity_levels.info`.";
00208
00209 char const* peer_ban_alert_doc =
00210 "This alert is generated when a peer is banned because it has sent\n"
00211 "too many corrupt pieces to us. It is generated at severity level\n"
00212 "`alert.severity_levels.info`. The handle member is a `torrent_handle` to the torrent that\n"
00213 "this peer was a member of.";
00214
00215 char const* peer_error_alert_doc =
00216 "This alert is generated when a peer sends invalid data over the\n"
00217 "peer-peer protocol. The peer will be disconnected, but you get its\n"
00218 "ip address from the alert, to identify it. This alert is generated\n"
00219 "is severity level `alert.severity_levels.debug`.";
00220
00221 char const* invalid_request_alert_doc =
00222 "This is a debug alert that is generated by an incoming invalid\n"
00223 "piece request. The handle is a handle to the torrent the peer\n"
00224 "is a member of. Ip is the address of the peer and the request is\n"
00225 "the actual incoming request from the peer. The alert is generated\n"
00226 "as severity level `alert.severity_levels.debug`.";
00227
00228 char const* peer_request_doc =
00229 "The `peer_request` contains the values the client sent in its\n"
00230 "request message. ``piece`` is the index of the piece it want data\n"
00231 "from, ``start`` is the offset within the piece where the data should be\n"
00232 "read, and ``length`` is the amount of data it wants.";
00233
00234 char const* torrent_finished_alert_doc =
00235 "This alert is generated when a torrent switches from being a\n"
00236 "downloader to a seed. It will only be generated once per torrent.\n"
00237 "It contains a `torrent_handle` to the torrent in question. This alert\n"
00238 "is generated as severity level `alert.severity_levels.info`.";
00239
00240 char const* metadata_failed_alert_doc =
00241 "This alert is generated when the metadata has been completely\n"
00242 "received and the info-hash failed to match it. i.e. the\n"
00243 "metadata that was received was corrupt. libtorrent will\n"
00244 "automatically retry to fetch it in this case. This is only\n"
00245 "relevant when running a torrent-less download, with the metadata\n"
00246 "extension provided by libtorrent. It is generated at severity\n"
00247 "level `alert.severity_levels.info`.";
00248
00249 char const* metadata_received_alert_doc =
00250 "This alert is generated when the metadata has been completely\n"
00251 "received and the torrent can start downloading. It is not generated\n"
00252 "on torrents that are started with metadata, but only those that\n"
00253 "needs to download it from peers (when utilizing the libtorrent\n"
00254 "extension). It is generated at severity level `alert.severity_levels.info`.";
00255
00256 char const* fastresume_rejected_alert_doc =
00257 "This alert is generated when a fastresume file has been passed\n"
00258 "to `session.add_torrent` but the files on disk did not match the\n"
00259 "fastresume file. The string explains the reason why the resume\n"
00260 "file was rejected. It is generated at severity level `alert.severity_levels.warning`.";
00261