/* Copyright (c) 2008-2014, Arvid Norberg All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of the author nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ #ifndef TORRENT_ERROR_CODE_HPP_INCLUDED #define TORRENT_ERROR_CODE_HPP_INCLUDED #include #include "libtorrent/config.hpp" #if defined TORRENT_WINDOWS || defined TORRENT_CYGWIN // asio assumes that the windows error codes are defined already #include #endif #if BOOST_VERSION < 103500 #include #else #include #endif #include "libtorrent/string_util.hpp" // for allocate_string_copy #include // free #ifndef BOOST_SYSTEM_NOEXCEPT #define BOOST_SYSTEM_NOEXCEPT throw() #endif namespace libtorrent { namespace errors { // libtorrent uses boost.system's ``error_code`` class to represent errors. libtorrent has // its own error category get_libtorrent_category() whith the error codes defined by error_code_enum. enum error_code_enum { // Not an error no_error = 0, // Two torrents has files which end up overwriting each other file_collision, // A piece did not match its piece hash failed_hash_check, // The .torrent file does not contain a bencoded dictionary at // its top level torrent_is_no_dict, // The .torrent file does not have an ``info`` dictionary torrent_missing_info, // The .torrent file's ``info`` entry is not a dictionary torrent_info_no_dict, // The .torrent file does not have a ``piece length`` entry torrent_missing_piece_length, // The .torrent file does not have a ``name`` entry torrent_missing_name, // The .torrent file's name entry is invalid torrent_invalid_name, // The length of a file, or of the whole .torrent file is invalid. // Either negative or not an integer torrent_invalid_length, // Failed to parse a file entry in the .torrent torrent_file_parse_failed, // The ``pieces`` field is missing or invalid in the .torrent file torrent_missing_pieces, // The ``pieces`` string has incorrect length torrent_invalid_hashes, // The .torrent file has more pieces than is supported by libtorrent too_many_pieces_in_torrent, // The metadata (.torrent file) that was received from the swarm // matched the info-hash, but failed to be parsed invalid_swarm_metadata, // The file or buffer is not correctly bencoded invalid_bencoding, // The .torrent file does not contain any files no_files_in_torrent, // The string was not properly url-encoded as expected invalid_escaped_string, // Operation is not permitted since the session is shutting down session_is_closing, // There's already a torrent with that info-hash added to the // session duplicate_torrent, // The supplied torrent_handle is not referring to a valid torrent invalid_torrent_handle, // The type requested from the entry did not match its type invalid_entry_type, // The specified URI does not contain a valid info-hash missing_info_hash_in_uri, // One of the files in the torrent was unexpectadly small. This // might be caused by files being changed by an external process file_too_short, // The URL used an unknown protocol. Currently ``http`` and // ``https`` (if built with openssl support) are recognized. For // trackers ``udp`` is recognized as well. unsupported_url_protocol, // The URL did not conform to URL syntax and failed to be parsed url_parse_error, // The peer sent a 'piece' message of length 0 peer_sent_empty_piece, // A bencoded structure was currupt and failed to be parsed parse_failed, // The fast resume file was missing or had an invalid file version // tag invalid_file_tag, // The fast resume file was missing or had an invalid info-hash missing_info_hash, // The info-hash did not match the torrent mismatching_info_hash, // The URL contained an invalid hostname invalid_hostname, // The URL had an invalid port invalid_port, // The port is blocked by the port-filter, and prevented the // connection port_blocked, // The IPv6 address was expected to end with ']' expected_close_bracket_in_address, // The torrent is being destructed, preventing the operation to // succeed destructing_torrent, // The connection timed out timed_out, // The peer is upload only, and we are upload only. There's no point // in keeping the connection upload_upload_connection, // The peer is upload only, and we're not interested in it. There's // no point in keeping the connection uninteresting_upload_peer, // The peer sent an unknown info-hash invalid_info_hash, // The torrent is paused, preventing the operation from succeeding torrent_paused, // The peer sent an invalid have message, either wrong size or // referring to a piece that doesn't exist in the torrent invalid_have, // The bitfield message had the incorrect size invalid_bitfield_size, // The peer kept requesting pieces after it was choked, possible // abuse attempt. too_many_requests_when_choked, // The peer sent a piece message that does not correspond to a // piece request sent by the client invalid_piece, // memory allocation failed no_memory, // The torrent is aborted, preventing the operation to succeed torrent_aborted, // The peer is a connection to ourself, no point in keeping it self_connection, // The peer sent a piece message with invalid size, either negative // or greater than one block invalid_piece_size, // The peer has not been interesting or interested in us for too // long, no point in keeping it around timed_out_no_interest, // The peer has not said anything in a long time, possibly dead timed_out_inactivity, // The peer did not send a handshake within a reasonable amount of // time, it might not be a bittorrent peer timed_out_no_handshake, // The peer has been unchoked for too long without requesting any // data. It might be lying about its interest in us timed_out_no_request, // The peer sent an invalid choke message invalid_choke, // The peer send an invalid unchoke message invalid_unchoke, // The peer sent an invalid interested message invalid_interested, // The peer sent an invalid not-interested message invalid_not_interested, // The peer sent an invalid piece request message invalid_request, // The peer sent an invalid hash-list message (this is part of the // merkle-torrent extension) invalid_hash_list, // The peer sent an invalid hash-piece message (this is part of the // merkle-torrent extension) invalid_hash_piece, // The peer sent an invalid cancel message invalid_cancel, // The peer sent an invalid DHT port-message invalid_dht_port, // The peer sent an invalid suggest piece-message invalid_suggest, // The peer sent an invalid have all-message invalid_have_all, // The peer sent an invalid have none-message invalid_have_none, // The peer sent an invalid reject message invalid_reject, // The peer sent an invalid allow fast-message invalid_allow_fast, // The peer sent an invalid extesion message ID invalid_extended, // The peer sent an invalid message ID invalid_message, // The synchronization hash was not found in the encrypted handshake sync_hash_not_found, // The encryption constant in the handshake is invalid invalid_encryption_constant, // The peer does not support plaintext, which is the selected mode no_plaintext_mode, // The peer does not support rc4, which is the selected mode no_rc4_mode, // The peer does not support any of the encryption modes that the // client supports unsupported_encryption_mode, // The peer selected an encryption mode that the client did not // advertise and does not support unsupported_encryption_mode_selected, // The pad size used in the encryption handshake is of invalid size invalid_pad_size, // The encryption handshake is invalid invalid_encrypt_handshake, // The client is set to not support incoming encrypted connections // and this is an encrypted connection no_incoming_encrypted, // The client is set to not support incoming regular bittorrent // connections, and this is a regular connection no_incoming_regular, // The client is already connected to this peer-ID duplicate_peer_id, // Torrent was removed torrent_removed, // The packet size exceeded the upper sanity check-limit packet_too_large, reserved, // The web server responded with an error http_error, // The web server response is missing a location header missing_location, // The web seed redirected to a path that no longer matches the // .torrent directory structure invalid_redirection, // The connection was closed becaused it redirected to a different // URL redirecting, // The HTTP range header is invalid invalid_range, // The HTTP response did not have a content length no_content_length, // The IP is blocked by the IP filter banned_by_ip_filter, // At the connection limit too_many_connections, // The peer is marked as banned peer_banned, // The torrent is stopping, causing the operation to fail stopping_torrent, // The peer has sent too many corrupt pieces and is banned too_many_corrupt_pieces, // The torrent is not ready to receive peers torrent_not_ready, // The peer is not completely constructed yet peer_not_constructed, // The session is closing, causing the operation to fail session_closing, // The peer was disconnected in order to leave room for a // potentially better peer optimistic_disconnect, // The torrent is finished torrent_finished, // No UPnP router found no_router, // The metadata message says the metadata exceeds the limit metadata_too_large, // The peer sent an invalid metadata request message invalid_metadata_request, // The peer advertised an invalid metadata size invalid_metadata_size, // The peer sent a message with an invalid metadata offset invalid_metadata_offset, // The peer sent an invalid metadata message invalid_metadata_message, // The peer sent a peer exchange message that was too large pex_message_too_large, // The peer sent an invalid peer exchange message invalid_pex_message, // The peer sent an invalid tracker exchange message invalid_lt_tracker_message, // The peer sent an pex messages too often. This is a possible // attempt of and attack too_frequent_pex, // 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. no_metadata, // The peer sent an invalid ``dont_have`` message. The dont have // message is an extension to allow peers to advertise that the // no longer has a piece they previously had. invalid_dont_have, // The peer tried to connect to an SSL torrent without connecting // over SSL. requires_ssl_connection, // The peer tried to connect to a torrent with a certificate // for a different torrent. invalid_ssl_cert, // the torrent is not an SSL torrent, and the operation requires // an SSL torrent not_an_ssl_torrent, // The NAT-PMP router responded with an unsupported protocol version unsupported_protocol_version = 120, // You are not authorized to map ports on this NAT-PMP router natpmp_not_authorized, // The NAT-PMP router failed because of a network failure network_failure, // The NAT-PMP router failed because of lack of resources no_resources, // The NAT-PMP router failed because an unsupported opcode was sent unsupported_opcode, // The resume data file is missing the 'file sizes' entry missing_file_sizes = 130, // The resume data file 'file sizes' entry is empty no_files_in_resume_data, // The resume data file is missing the 'pieces' and 'slots' entry missing_pieces, // The number of files in the resume data does not match the number // of files in the torrent mismatching_number_of_files, // One of the files on disk has a different size than in the fast // resume file mismatching_file_size, // One of the files on disk has a different timestamp than in the // fast resume file mismatching_file_timestamp, // The resume data file is not a dictionary not_a_dictionary, // The 'blocks per piece' entry is invalid in the resume data file invalid_blocks_per_piece, // The resume file is missing the 'slots' entry, which is required // for torrents with compact allocation missing_slots, // The resume file contains more slots than the torrent too_many_slots, // The 'slot' entry is invalid in the resume data invalid_slot_list, // One index in the 'slot' list is invalid invalid_piece_index, // 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 pieces_need_reorder, // The HTTP header was not correctly formatted http_parse_error = 150, // The HTTP response was in the 300-399 range but lacked a location // header http_missing_location, // The HTTP response was encoded with gzip or deflate but // decompressing it failed http_failed_decompress, // The URL specified an i2p address, but no i2p router is configured no_i2p_router = 160, // The tracker URL doesn't support transforming it into a scrape // URL. i.e. it doesn't contain "announce. scrape_not_available = 170, // invalid tracker response invalid_tracker_response, // invalid peer dictionary entry. Not a dictionary invalid_peer_dict, // tracker sent a failure message tracker_failure, // missing or invalid 'files' entry invalid_files_entry, // missing or invalid 'hash' entry invalid_hash_entry, // missing or invalid 'peers' and 'peers6' entry invalid_peers_entry, // udp tracker response packet has invalid size invalid_tracker_response_length, // invalid transaction id in udp tracker response invalid_tracker_transaction_id, // invalid action field in udp tracker response invalid_tracker_action, #ifndef TORRENT_NO_DEPRECATE // expected string in bencoded string expected_string = 190, // expected colon in bencoded string expected_colon, // unexpected end of file in bencoded string unexpected_eof, // expected value (list, dict, int or string) in bencoded string expected_value, // bencoded recursion depth limit exceeded depth_exceeded, // bencoded item count limit exceeded limit_exceeded, // integer overflow overflow, #endif // the number of error codes error_code_max }; // HTTP errors are reported in the libtorrent::http_category, with error code enums in // the ``libtorrent::errors`` namespace. enum http_errors { 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 }; } } #if BOOST_VERSION >= 103500 namespace boost { namespace system { template<> struct is_error_code_enum { static const bool value = true; }; template<> struct is_error_condition_enum { static const bool value = true; }; } } #endif namespace libtorrent { #if BOOST_VERSION < 103500 typedef asio::error_code error_code; // hidden inline asio::error::error_category get_posix_category() { return asio::error::system_category; } // hidden inline asio::error::error_category get_system_category() { return asio::error::system_category; } // hidden boost::system::error_category const& get_libtorrent_category() { static ::asio::error::error_category libtorrent_category(20); return libtorrent_category; } // hidden boost::system::error_category const& get_http_category() { static ::asio::error::error_category http_category(21); return http_category; } #else // return the instance of the libtorrent_error_category which // maps libtorrent error codes to human readable error messages. TORRENT_EXPORT boost::system::error_category& get_libtorrent_category(); // returns the error_category for HTTP errors TORRENT_EXPORT boost::system::error_category& get_http_category(); namespace errors { // hidden inline boost::system::error_code make_error_code(error_code_enum e) { return boost::system::error_code(e, get_libtorrent_category()); } } using boost::system::error_code; // hidden inline boost::system::error_category const& get_system_category() #if BOOST_VERSION < 104400 { return boost::system::get_system_category(); } #else { return boost::system::system_category(); } #endif // hidden inline boost::system::error_category const& get_posix_category() #if BOOST_VERSION < 103600 { return boost::system::get_posix_category(); } #elif BOOST_VERSION < 104400 { return boost::system::get_generic_category(); } #else { return boost::system::generic_category(); } #endif // BOOST_VERSION < 103600 #endif // BOOST_VERSION < 103500 // internal inline boost::system::error_category const& generic_category() { return get_posix_category(); } #ifndef BOOST_NO_EXCEPTIONS struct TORRENT_EXPORT libtorrent_exception: std::exception { libtorrent_exception(error_code const& s): m_error(s), m_msg(0) {} virtual const char* what() const throw(); virtual ~libtorrent_exception() throw(); error_code error() const { return m_error; } private: error_code m_error; mutable char* m_msg; }; #endif } #endif