Version:	2.0.11

home

Table of contents

[report issue]

storage_error

Declared in "libtorrent/error_code.hpp"

used by storage to return errors also includes which underlying file the error happened on

 struct storage_error { explicit operator bool () const; file_index_t file () const; void file (file_index_t f); error_code ec; operation_t operation; };

[report issue]

bool()

 explicit operator bool () const;

explicitly converts to true if this object represents an error, and false if it does not.

[report issue]

file()

 file_index_t file () const; void file (file_index_t f);

set and query the index (in the torrent) of the file this error occurred on. This may also have special values defined in torrent_status.

[report issue]

ec: the error that occurred

[report issue]

operation: A code from operation_t enum, indicating what kind of operation failed.

[report issue]

gzip_category()

Declared in "libtorrent/gzip.hpp"

 boost::system::error_category& gzip_category ();

get the error_category for zip errors

[report issue]

pcp_category()

Declared in "libtorrent/natpmp.hpp"

 boost::system::error_category& pcp_category ();

[report issue]

bdecode_category()

Declared in "libtorrent/bdecode.hpp"

 boost::system::error_category& bdecode_category ();

[report issue]

libtorrent_category()

Declared in "libtorrent/error_code.hpp"

 boost::system::error_category& libtorrent_category ();

return the instance of the libtorrent_error_category which maps libtorrent error codes to human readable error messages.

[report issue]

http_category()

Declared in "libtorrent/error_code.hpp"

 boost::system::error_category& http_category ();

returns the error_category for HTTP errors

[report issue]

i2p_category()

Declared in "libtorrent/i2p_stream.hpp"

 boost::system::error_category& i2p_category ();

returns the error category for I2P errors

[report issue]

socks_category()

Declared in "libtorrent/socks5_stream.hpp"

 boost::system::error_category& socks_category ();

returns the error_category for SOCKS5 errors

[report issue]

upnp_category()

Declared in "libtorrent/upnp.hpp"

 boost::system::error_category& upnp_category ();

the boost.system error category for UPnP errors

[report issue]

enum error_code_enum

Declared in "libtorrent/gzip.hpp"

name	value	description
no_error	0	Not an error
invalid_gzip_header	1	the supplied gzip buffer has invalid header
inflated_data_too_large	2	the gzip buffer would inflate to more bytes than the specified maximum size, and was rejected.
data_did_not_terminate	3	available inflate data did not terminate
space_exhausted	4	output space exhausted before completing inflate
invalid_block_type	5	invalid block type (type == 3)
invalid_stored_block_length	6	stored block length did not match one's complement
too_many_length_or_distance_codes	7	dynamic block code description: too many length or distance codes
code_lengths_codes_incomplete	8	dynamic block code description: code lengths codes incomplete
repeat_lengths_with_no_first_length	9	dynamic block code description: repeat lengths with no first length
repeat_more_than_specified_lengths	10	dynamic block code description: repeat more than specified lengths
invalid_literal_length_code_lengths	11	dynamic block code description: invalid literal/length code lengths
invalid_distance_code_lengths	12	dynamic block code description: invalid distance code lengths
invalid_literal_code_in_block	13	invalid literal/length or distance code in fixed or dynamic block
distance_too_far_back_in_block	14	distance is too far back in fixed or dynamic block
unknown_gzip_error	15	an unknown error occurred during gzip inflation
error_code_max	16	the number of error codes

[report issue]

enum pcp_errors

Declared in "libtorrent/natpmp.hpp"

name	value	description
pcp_success	0
pcp_unsupp_version	1
pcp_not_authorized	2
pcp_malformed_request	3
pcp_unsupp_opcode	4
pcp_unsupp_option	5
pcp_malformed_option	6
pcp_network_failure	7
pcp_no_resources	8
pcp_unsupp_protocol	9
pcp_user_ex_quota	10
pcp_cannot_provide_external	11
pcp_address_mismatch	12
pcp_excessive_remote_peers	13

[report issue]

enum error_code_enum

Declared in "libtorrent/bdecode.hpp"

name	value	description
no_error	0	Not an error
expected_digit	1	expected digit in bencoded string
expected_colon	2	expected colon in bencoded string
unexpected_eof	3	unexpected end of file in bencoded string
expected_value	4	expected value (list, dict, int or string) in bencoded string
depth_exceeded	5	bencoded recursion depth limit exceeded
limit_exceeded	6	bencoded item count limit exceeded
overflow	7	integer overflow
error_code_max	8	the number of error codes

[report issue]

enum error_code_enum

Declared in "libtorrent/error_code.hpp"

name	value	description
no_error	0	Not an error
file_collision	1	Two torrents has files which end up overwriting each other
failed_hash_check	2	A piece did not match its piece hash
torrent_is_no_dict	3	The .torrent file does not contain a bencoded dictionary at its top level
torrent_missing_info	4	The .torrent file does not have an `info` dictionary
torrent_info_no_dict	5	The .torrent file's `info`entry is not a dictionary
torrent_missing_piece_length	6	The .torrent file does not have a `piece length`entry
torrent_missing_name	7	The .torrent file does not have a `name`entry
torrent_invalid_name	8	The .torrent file's name entry is invalid
torrent_invalid_length	9	The length of a file, or of the whole .torrent file is invalid. Either negative or not an integer
torrent_file_parse_failed	10	Failed to parse a file entry in the .torrent
torrent_missing_pieces	11	The `pieces` field is missing or invalid in the .torrent file
torrent_invalid_hashes	12	The `pieces` string has incorrect length
too_many_pieces_in_torrent	13	The .torrent file has more pieces than is supported by libtorrent
invalid_swarm_metadata	14	The metadata (.torrent file) that was received from the swarm matched the info-hash, but failed to be parsed
invalid_bencoding	15	The file or buffer is not correctly bencoded
no_files_in_torrent	16	The .torrent file does not contain any files
invalid_escaped_string	17	The string was not properly url-encoded as expected
session_is_closing	18	Operation is not permitted since the session is shutting down
duplicate_torrent	19	There's already a torrent with that info-hash added to the session
invalid_torrent_handle	20	The supplied torrent_handle is not referring to a valid torrent
invalid_entry_type	21	The type requested from the entry did not match its type
missing_info_hash_in_uri	22	The specified URI does not contain a valid info-hash
file_too_short	23	One of the files in the torrent was unexpectedly small. This might be caused by files being changed by an external process
unsupported_url_protocol	24	The URL used an unknown protocol. Currently `http` and `https` (if built with openssl support) are recognized. For trackers `udp` is recognized as well.
url_parse_error	25	The URL did not conform to URL syntax and failed to be parsed
peer_sent_empty_piece	26	The peer sent a piece message of length 0
parse_failed	27	A bencoded structure was corrupt and failed to be parsed
invalid_file_tag	28	The fast resume file was missing or had an invalid file version tag
missing_info_hash	29	The fast resume file was missing or had an invalid info-hash
mismatching_info_hash	30	The info-hash did not match the torrent
invalid_hostname	31	The URL contained an invalid hostname
invalid_port	32	The URL had an invalid port
port_blocked	33	The port is blocked by the port-filter, and prevented the connection
expected_close_bracket_in_address	34	The IPv6 address was expected to end with "]"
destructing_torrent	35	The torrent is being destructed, preventing the operation to succeed
timed_out	36	The connection timed out
upload_upload_connection	37	The peer is upload only, and we are upload only. There's no point in keeping the connection
uninteresting_upload_peer	38	The peer is upload only, and we're not interested in it. There's no point in keeping the connection
invalid_info_hash	39	The peer sent an unknown info-hash
torrent_paused	40	The torrent is paused, preventing the operation from succeeding
invalid_have	41	The peer sent an invalid have message, either wrong size or referring to a piece that doesn't exist in the torrent
invalid_bitfield_size	42	The bitfield message had the incorrect size
too_many_requests_when_choked	43	The peer kept requesting pieces after it was choked, possible abuse attempt.
invalid_piece	44	The peer sent a piece message that does not correspond to a piece request sent by the client
no_memory	45	memory allocation failed
torrent_aborted	46	The torrent is aborted, preventing the operation to succeed
self_connection	47	The peer is a connection to ourself, no point in keeping it
invalid_piece_size	48	The peer sent a piece message with invalid size, either negative or greater than one block
timed_out_no_interest	49	The peer has not been interesting or interested in us for too long, no point in keeping it around
timed_out_inactivity	50	The peer has not said anything in a long time, possibly dead
timed_out_no_handshake	51	The peer did not send a handshake within a reasonable amount of time, it might not be a bittorrent peer
timed_out_no_request	52	The peer has been unchoked for too long without requesting any data. It might be lying about its interest in us
invalid_choke	53	The peer sent an invalid choke message
invalid_unchoke	54	The peer send an invalid unchoke message
invalid_interested	55	The peer sent an invalid interested message
invalid_not_interested	56	The peer sent an invalid not-interested message
invalid_request	57	The peer sent an invalid piece request message
invalid_hash_list	58	The peer sent an invalid hash-list message (this is part of the merkle-torrent extension)
invalid_hash_piece	59	The peer sent an invalid hash-piece message (this is part of the merkle-torrent extension)
invalid_cancel	60	The peer sent an invalid cancel message
invalid_dht_port	61	The peer sent an invalid DHT port-message
invalid_suggest	62	The peer sent an invalid suggest piece-message
invalid_have_all	63	The peer sent an invalid have all-message
invalid_have_none	64	The peer sent an invalid have none-message
invalid_reject	65	The peer sent an invalid reject message
invalid_allow_fast	66	The peer sent an invalid allow fast-message
invalid_extended	67	The peer sent an invalid extension message ID
invalid_message	68	The peer sent an invalid message ID
sync_hash_not_found	69	The synchronization hash was not found in the encrypted handshake
invalid_encryption_constant	70	The encryption constant in the handshake is invalid
no_plaintext_mode	71	The peer does not support plain text, which is the selected mode
no_rc4_mode	72	The peer does not support RC4, which is the selected mode
unsupported_encryption_mode	73	The peer does not support any of the encryption modes that the client supports
unsupported_encryption_mode_selected	74	The peer selected an encryption mode that the client did not advertise and does not support
invalid_pad_size	75	The pad size used in the encryption handshake is of invalid size
invalid_encrypt_handshake	76	The encryption handshake is invalid
no_incoming_encrypted	77	The client is set to not support incoming encrypted connections and this is an encrypted connection
no_incoming_regular	78	The client is set to not support incoming regular bittorrent connections, and this is a regular connection
duplicate_peer_id	79	The client is already connected to this peer-ID
torrent_removed	80	Torrent was removed
packet_too_large	81	The packet size exceeded the upper sanity check-limit
reserved	82
http_error	83	The web server responded with an error
missing_location	84	The web server response is missing a location header
invalid_redirection	85	The web seed redirected to a path that no longer matches the .torrent directory structure
redirecting	86	The connection was closed because it redirected to a different URL
invalid_range	87	The HTTP range header is invalid
no_content_length	88	The HTTP response did not have a content length
banned_by_ip_filter	89	The IP is blocked by the IP filter
too_many_connections	90	At the connection limit
peer_banned	91	The peer is marked as banned
stopping_torrent	92	The torrent is stopping, causing the operation to fail
too_many_corrupt_pieces	93	The peer has sent too many corrupt pieces and is banned
torrent_not_ready	94	The torrent is not ready to receive peers
peer_not_constructed	95	The peer is not completely constructed yet
session_closing	96	The session is closing, causing the operation to fail
optimistic_disconnect	97	The peer was disconnected in order to leave room for a potentially better peer
torrent_finished	98	The torrent is finished
no_router	99	No UPnP router found
metadata_too_large	100	The metadata message says the metadata exceeds the limit
invalid_metadata_request	101	The peer sent an invalid metadata request message
invalid_metadata_size	102	The peer advertised an invalid metadata size
invalid_metadata_offset	103	The peer sent a message with an invalid metadata offset
invalid_metadata_message	104	The peer sent an invalid metadata message
pex_message_too_large	105	The peer sent a peer exchange message that was too large
invalid_pex_message	106	The peer sent an invalid peer exchange message
invalid_lt_tracker_message	107	The peer sent an invalid tracker exchange message
too_frequent_pex	108	The peer sent an pex messages too often. This is a possible attempt of and attack
no_metadata	109	The operation failed because it requires the torrent to have the metadata (.torrent file) and it doesn't have it yet. This happens for magnet links before they have downloaded the metadata, and also torrents added by URL.
invalid_dont_have	110	The peer sent an invalid `dont_have` message. The don't have message is an extension to allow peers to advertise that the no longer has a piece they previously had.
requires_ssl_connection	111	The peer tried to connect to an SSL torrent without connecting over SSL.
invalid_ssl_cert	112	The peer tried to connect to a torrent with a certificate for a different torrent.
not_an_ssl_torrent	113	the torrent is not an SSL torrent, and the operation requires an SSL torrent
banned_by_port_filter	114	peer was banned because its listen port is within a banned port range, as specified by the port_filter.
invalid_session_handle	115	The session_handle is not referring to a valid session_impl
invalid_listen_socket	116	the listen socket associated with this request was closed
invalid_hash_request	117
invalid_hashes	118
invalid_hash_reject	119
deprecated_120	120
deprecated_121	121
deprecated_122	122
deprecated_123	123
deprecated_124	124
missing_file_sizes	130	The resume data file is missing the `file sizes`entry
no_files_in_resume_data	131	The resume data file `file sizes`entry is empty
missing_pieces	132	The resume data file is missing the `pieces` and `slots`entry
mismatching_number_of_files	133	The number of files in the resume data does not match the number of files in the torrent
mismatching_file_size	134	One of the files on disk has a different size than in the fast resume file
mismatching_file_timestamp	135	One of the files on disk has a different timestamp than in the fast resume file
not_a_dictionary	136	The resume data file is not a dictionary
invalid_blocks_per_piece	137	The `blocks per piece`entry is invalid in the resume data file
missing_slots	138	The resume file is missing the `slots`entry, which is required for torrents with compact allocation. DEPRECATED
too_many_slots	139	The resume file contains more slots than the torrent
invalid_slot_list	140	The `slot`entry is invalid in the resume data
invalid_piece_index	141	One index in the `slot` list is invalid
pieces_need_reorder	142	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. DEPRECATED
resume_data_not_modified	143	this error is returned when asking to save resume data and specifying the flag to only save when there's anything new to save (torrent_handle::only_if_modified) and there wasn't anything changed.
invalid_save_path	144	the save_path in add_torrent_params is not valid
http_parse_error	150	The HTTP header was not correctly formatted
http_missing_location	151	The HTTP response was in the 300-399 range but lacked a location header
http_failed_decompress	152	The HTTP response was encoded with gzip or deflate but decompressing it failed
no_i2p_router	160	The URL specified an i2p address, but no i2p router is configured
no_i2p_endpoint	161	i2p acceptor is not available yet, can't announce without endpoint
scrape_not_available	170	The tracker URL doesn't support transforming it into a scrape URL. i.e. it doesn't contain "announce.
invalid_tracker_response	171	invalid tracker response
invalid_peer_dict	172	invalid peer dictionary entry. Not a dictionary
tracker_failure	173	tracker sent a failure message
invalid_files_entry	174	missing or invalid `files`entry
invalid_hash_entry	175	missing or invalid `hash`entry
invalid_peers_entry	176	missing or invalid `peers` and `peers6`entry
invalid_tracker_response_length	177	UDP tracker response packet has invalid size
invalid_tracker_transaction_id	178	invalid transaction id in UDP tracker response
invalid_tracker_action	179	invalid action field in UDP tracker response
announce_skipped	180	skipped announce (because it's assumed to be unreachable over the given source network interface)
no_entropy	200	random number generation failed
ssrf_mitigation	201	blocked by SSRF mitigation
blocked_by_idna	202	blocked because IDNA host names are banned
torrent_unknown_version	210	the torrent file has an unknown meta version
torrent_missing_file_tree	211	the v2 torrent file has no file tree
torrent_missing_meta_version	212	the torrent contains v2 keys but does not specify meta version 2
torrent_inconsistent_files	213	the v1 and v2 file metadata does not match
torrent_missing_piece_layer	214	one or more files are missing piece layer hashes
torrent_invalid_piece_layer	215	a piece layer has the wrong size or failed hash check
torrent_missing_pieces_root	216	a v2 file entry has no root hash
torrent_inconsistent_hashes	217	the v1 and v2 hashes do not describe the same data
torrent_invalid_pad_file	218	a file in the v2 metadata has the pad attribute set
error_code_max	219	the number of error codes

[report issue]

enum http_errors

Declared in "libtorrent/error_code.hpp"

name	value	description
cont	100
ok	200
created	201
accepted	202
no_content	204
multiple_choices	300
moved_permanently	301
moved_temporarily	302
not_modified	304
bad_request	400
unauthorized	401
forbidden	403
not_found	404
internal_server_error	500
not_implemented	501
bad_gateway	502
service_unavailable	503

[report issue]

enum i2p_error_code

Declared in "libtorrent/i2p_stream.hpp"

name	value	description
no_error	0
parse_failed	1
cant_reach_peer	2
i2p_error	3
invalid_key	4
invalid_id	5
timeout	6
key_not_found	7
duplicated_id	8
num_errors	9

[report issue]

enum socks_error_code

Declared in "libtorrent/socks5_stream.hpp"

name	value	description
no_error	0
unsupported_version	1
unsupported_authentication_method	2
unsupported_authentication_version	3
authentication_error	4
username_required	5
general_failure	6
command_not_supported	7
no_identd	8
identd_error	9
num_errors	10

[report issue]

enum error_code_enum

Declared in "libtorrent/upnp.hpp"

name	value	description
no_error	0	No error
invalid_argument	402	One of the arguments in the request is invalid
action_failed	501	The request failed
value_not_in_array	714	The specified value does not exist in the array
source_ip_cannot_be_wildcarded	715	The source IP address cannot be wild-carded, but must be fully specified
external_port_cannot_be_wildcarded	716	The external port cannot be a wildcard, but must be specified
port_mapping_conflict	718	The port mapping entry specified conflicts with a mapping assigned previously to another client
internal_port_must_match_external	724	Internal and external port value must be the same
only_permanent_leases_supported	725	The NAT implementation only supports permanent lease times on port mappings
remote_host_must_be_wildcard	726	RemoteHost must be a wildcard and cannot be a specific IP address or DNS name
external_port_must_be_wildcard	727	ExternalPort must be a wildcard and cannot be a specific port