Annotation of embedaddon/curl/docs/libcurl/libcurl-errors.3, revision 1.1
1.1 ! misho 1: .\" **************************************************************************
! 2: .\" * _ _ ____ _
! 3: .\" * Project ___| | | | _ \| |
! 4: .\" * / __| | | | |_) | |
! 5: .\" * | (__| |_| | _ <| |___
! 6: .\" * \___|\___/|_| \_\_____|
! 7: .\" *
! 8: .\" * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al.
! 9: .\" *
! 10: .\" * This software is licensed as described in the file COPYING, which
! 11: .\" * you should have received as part of this distribution. The terms
! 12: .\" * are also available at https://curl.haxx.se/docs/copyright.html.
! 13: .\" *
! 14: .\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
! 15: .\" * copies of the Software, and permit persons to whom the Software is
! 16: .\" * furnished to do so, under the terms of the COPYING file.
! 17: .\" *
! 18: .\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
! 19: .\" * KIND, either express or implied.
! 20: .\" *
! 21: .\" **************************************************************************
! 22: .\"
! 23: .TH libcurl-errors 3 "March 23, 2020" "libcurl 7.70.0" "libcurl errors"
! 24:
! 25: .SH NAME
! 26: libcurl-errors \- error codes in libcurl
! 27: .SH DESCRIPTION
! 28: This man page includes most, if not all, available error codes in libcurl.
! 29: Why they occur and possibly what you can do to fix the problem are also included.
! 30: .SH "CURLcode"
! 31: Almost all "easy" interface functions return a CURLcode error code. No matter
! 32: what, using the \fIcurl_easy_setopt(3)\fP option \fICURLOPT_ERRORBUFFER(3)\fP
! 33: is a good idea as it will give you a human readable error string that may
! 34: offer more details about the cause of the error than just the error code.
! 35: \fIcurl_easy_strerror(3)\fP can be called to get an error string from a given
! 36: CURLcode number.
! 37:
! 38: CURLcode is one of the following:
! 39: .IP "CURLE_OK (0)"
! 40: All fine. Proceed as usual.
! 41: .IP "CURLE_UNSUPPORTED_PROTOCOL (1)"
! 42: The URL you passed to libcurl used a protocol that this libcurl does not
! 43: support. The support might be a compile-time option that you didn't use, it
! 44: can be a misspelled protocol string or just a protocol libcurl has no code
! 45: for.
! 46: .IP "CURLE_FAILED_INIT (2)"
! 47: Very early initialization code failed. This is likely to be an internal error
! 48: or problem, or a resource problem where something fundamental couldn't get
! 49: done at init time.
! 50: .IP "CURLE_URL_MALFORMAT (3)"
! 51: The URL was not properly formatted.
! 52: .IP "CURLE_NOT_BUILT_IN (4)"
! 53: A requested feature, protocol or option was not found built-in in this libcurl
! 54: due to a build-time decision. This means that a feature or option was not
! 55: enabled or explicitly disabled when libcurl was built and in order to get it
! 56: to function you have to get a rebuilt libcurl.
! 57: .IP "CURLE_COULDNT_RESOLVE_PROXY (5)"
! 58: Couldn't resolve proxy. The given proxy host could not be resolved.
! 59: .IP "CURLE_COULDNT_RESOLVE_HOST (6)"
! 60: Couldn't resolve host. The given remote host was not resolved.
! 61: .IP "CURLE_COULDNT_CONNECT (7)"
! 62: Failed to connect() to host or proxy.
! 63: .IP "CURLE_WEIRD_SERVER_REPLY (8)"
! 64: The server sent data libcurl couldn't parse. This error code was known as as
! 65: \fICURLE_FTP_WEIRD_SERVER_REPLY\fP before 7.51.0.
! 66: .IP "CURLE_REMOTE_ACCESS_DENIED (9)"
! 67: We were denied access to the resource given in the URL. For FTP, this occurs
! 68: while trying to change to the remote directory.
! 69: .IP "CURLE_FTP_ACCEPT_FAILED (10)"
! 70: While waiting for the server to connect back when an active FTP session is
! 71: used, an error code was sent over the control connection or similar.
! 72: .IP "CURLE_FTP_WEIRD_PASS_REPLY (11)"
! 73: After having sent the FTP password to the server, libcurl expects a proper
! 74: reply. This error code indicates that an unexpected code was returned.
! 75: .IP "CURLE_FTP_ACCEPT_TIMEOUT (12)"
! 76: During an active FTP session while waiting for the server to connect, the
! 77: \fICURLOPT_ACCEPTTIMEOUT_MS(3)\fP (or the internal default) timeout expired.
! 78: .IP "CURLE_FTP_WEIRD_PASV_REPLY (13)"
! 79: libcurl failed to get a sensible result back from the server as a response to
! 80: either a PASV or a EPSV command. The server is flawed.
! 81: .IP "CURLE_FTP_WEIRD_227_FORMAT (14)"
! 82: FTP servers return a 227-line as a response to a PASV command. If libcurl
! 83: fails to parse that line, this return code is passed back.
! 84: .IP "CURLE_FTP_CANT_GET_HOST (15)"
! 85: An internal failure to lookup the host used for the new connection.
! 86: .IP "CURLE_HTTP2 (16)"
! 87: A problem was detected in the HTTP2 framing layer. This is somewhat generic
! 88: and can be one out of several problems, see the error buffer for details.
! 89: .IP "CURLE_FTP_COULDNT_SET_TYPE (17)"
! 90: Received an error when trying to set the transfer mode to binary or ASCII.
! 91: .IP "CURLE_PARTIAL_FILE (18)"
! 92: A file transfer was shorter or larger than expected. This happens when the
! 93: server first reports an expected transfer size, and then delivers data that
! 94: doesn't match the previously given size.
! 95: .IP "CURLE_FTP_COULDNT_RETR_FILE (19)"
! 96: This was either a weird reply to a 'RETR' command or a zero byte transfer
! 97: complete.
! 98: .IP "CURLE_QUOTE_ERROR (21)"
! 99: When sending custom "QUOTE" commands to the remote server, one of the commands
! 100: returned an error code that was 400 or higher (for FTP) or otherwise
! 101: indicated unsuccessful completion of the command.
! 102: .IP "CURLE_HTTP_RETURNED_ERROR (22)"
! 103: This is returned if \fICURLOPT_FAILONERROR(3)\fP is set TRUE and the HTTP
! 104: server returns an error code that is >= 400.
! 105: .IP "CURLE_WRITE_ERROR (23)"
! 106: An error occurred when writing received data to a local file, or an error was
! 107: returned to libcurl from a write callback.
! 108: .IP "CURLE_UPLOAD_FAILED (25)"
! 109: Failed starting the upload. For FTP, the server typically denied the STOR
! 110: command. The error buffer usually contains the server's explanation for this.
! 111: .IP "CURLE_READ_ERROR (26)"
! 112: There was a problem reading a local file or an error returned by the read
! 113: callback.
! 114: .IP "CURLE_OUT_OF_MEMORY (27)"
! 115: A memory allocation request failed. This is serious badness and
! 116: things are severely screwed up if this ever occurs.
! 117: .IP "CURLE_OPERATION_TIMEDOUT (28)"
! 118: Operation timeout. The specified time-out period was reached according to the
! 119: conditions.
! 120: .IP "CURLE_FTP_PORT_FAILED (30)"
! 121: The FTP PORT command returned error. This mostly happens when you haven't
! 122: specified a good enough address for libcurl to use. See
! 123: \fICURLOPT_FTPPORT(3)\fP.
! 124: .IP "CURLE_FTP_COULDNT_USE_REST (31)"
! 125: The FTP REST command returned error. This should never happen if the server is
! 126: sane.
! 127: .IP "CURLE_RANGE_ERROR (33)"
! 128: The server does not support or accept range requests.
! 129: .IP "CURLE_HTTP_POST_ERROR (34)"
! 130: This is an odd error that mainly occurs due to internal confusion.
! 131: .IP "CURLE_SSL_CONNECT_ERROR (35)"
! 132: A problem occurred somewhere in the SSL/TLS handshake. You really want the
! 133: error buffer and read the message there as it pinpoints the problem slightly
! 134: more. Could be certificates (file formats, paths, permissions), passwords, and
! 135: others.
! 136: .IP "CURLE_BAD_DOWNLOAD_RESUME (36)"
! 137: The download could not be resumed because the specified offset was out of the
! 138: file boundary.
! 139: .IP "CURLE_FILE_COULDNT_READ_FILE (37)"
! 140: A file given with FILE:// couldn't be opened. Most likely because the file
! 141: path doesn't identify an existing file. Did you check file permissions?
! 142: .IP "CURLE_LDAP_CANNOT_BIND (38)"
! 143: LDAP cannot bind. LDAP bind operation failed.
! 144: .IP "CURLE_LDAP_SEARCH_FAILED (39)"
! 145: LDAP search failed.
! 146: .IP "CURLE_FUNCTION_NOT_FOUND (41)"
! 147: Function not found. A required zlib function was not found.
! 148: .IP "CURLE_ABORTED_BY_CALLBACK (42)"
! 149: Aborted by callback. A callback returned "abort" to libcurl.
! 150: .IP "CURLE_BAD_FUNCTION_ARGUMENT (43)"
! 151: A function was called with a bad parameter.
! 152: .IP "CURLE_INTERFACE_FAILED (45)"
! 153: Interface error. A specified outgoing interface could not be used. Set which
! 154: interface to use for outgoing connections' source IP address with
! 155: \fICURLOPT_INTERFACE(3)\fP.
! 156: .IP "CURLE_TOO_MANY_REDIRECTS (47)"
! 157: Too many redirects. When following redirects, libcurl hit the maximum amount.
! 158: Set your limit with \fICURLOPT_MAXREDIRS(3)\fP.
! 159: .IP "CURLE_UNKNOWN_OPTION (48)"
! 160: An option passed to libcurl is not recognized/known. Refer to the appropriate
! 161: documentation. This is most likely a problem in the program that uses
! 162: libcurl. The error buffer might contain more specific information about which
! 163: exact option it concerns.
! 164: .IP "CURLE_TELNET_OPTION_SYNTAX (49)"
! 165: A telnet option string was Illegally formatted.
! 166: .IP "CURLE_GOT_NOTHING (52)"
! 167: Nothing was returned from the server, and under the circumstances, getting
! 168: nothing is considered an error.
! 169: .IP "CURLE_SSL_ENGINE_NOTFOUND (53)"
! 170: The specified crypto engine wasn't found.
! 171: .IP "CURLE_SSL_ENGINE_SETFAILED (54)"
! 172: Failed setting the selected SSL crypto engine as default!
! 173: .IP "CURLE_SEND_ERROR (55)"
! 174: Failed sending network data.
! 175: .IP "CURLE_RECV_ERROR (56)"
! 176: Failure with receiving network data.
! 177: .IP "CURLE_SSL_CERTPROBLEM (58)"
! 178: problem with the local client certificate.
! 179: .IP "CURLE_SSL_CIPHER (59)"
! 180: Couldn't use specified cipher.
! 181: .IP "CURLE_PEER_FAILED_VERIFICATION (60)"
! 182: The remote server's SSL certificate or SSH md5 fingerprint was deemed not OK.
! 183: This error code has been unified with CURLE_SSL_CACERT since 7.62.0. Its
! 184: previous value was 51.
! 185: .IP "CURLE_BAD_CONTENT_ENCODING (61)"
! 186: Unrecognized transfer encoding.
! 187: .IP "CURLE_LDAP_INVALID_URL (62)"
! 188: Invalid LDAP URL.
! 189: .IP "CURLE_FILESIZE_EXCEEDED (63)"
! 190: Maximum file size exceeded.
! 191: .IP "CURLE_USE_SSL_FAILED (64)"
! 192: Requested FTP SSL level failed.
! 193: .IP "CURLE_SEND_FAIL_REWIND (65)"
! 194: When doing a send operation curl had to rewind the data to retransmit, but the
! 195: rewinding operation failed.
! 196: .IP "CURLE_SSL_ENGINE_INITFAILED (66)"
! 197: Initiating the SSL Engine failed.
! 198: .IP "CURLE_LOGIN_DENIED (67)"
! 199: The remote server denied curl to login (Added in 7.13.1)
! 200: .IP "CURLE_TFTP_NOTFOUND (68)"
! 201: File not found on TFTP server.
! 202: .IP "CURLE_TFTP_PERM (69)"
! 203: Permission problem on TFTP server.
! 204: .IP "CURLE_REMOTE_DISK_FULL (70)"
! 205: Out of disk space on the server.
! 206: .IP "CURLE_TFTP_ILLEGAL (71)"
! 207: Illegal TFTP operation.
! 208: .IP "CURLE_TFTP_UNKNOWNID (72)"
! 209: Unknown TFTP transfer ID.
! 210: .IP "CURLE_REMOTE_FILE_EXISTS (73)"
! 211: File already exists and will not be overwritten.
! 212: .IP "CURLE_TFTP_NOSUCHUSER (74)"
! 213: This error should never be returned by a properly functioning TFTP server.
! 214: .IP "CURLE_CONV_FAILED (75)"
! 215: Character conversion failed.
! 216: .IP "CURLE_CONV_REQD (76)"
! 217: Caller must register conversion callbacks.
! 218: .IP "CURLE_SSL_CACERT_BADFILE (77)"
! 219: Problem with reading the SSL CA cert (path? access rights?)
! 220: .IP "CURLE_REMOTE_FILE_NOT_FOUND (78)"
! 221: The resource referenced in the URL does not exist.
! 222: .IP "CURLE_SSH (79)"
! 223: An unspecified error occurred during the SSH session.
! 224: .IP "CURLE_SSL_SHUTDOWN_FAILED (80)"
! 225: Failed to shut down the SSL connection.
! 226: .IP "CURLE_AGAIN (81)"
! 227: Socket is not ready for send/recv wait till it's ready and try again. This
! 228: return code is only returned from \fIcurl_easy_recv(3)\fP and
! 229: \fIcurl_easy_send(3)\fP (Added in 7.18.2)
! 230: .IP "CURLE_SSL_CRL_BADFILE (82)"
! 231: Failed to load CRL file (Added in 7.19.0)
! 232: .IP "CURLE_SSL_ISSUER_ERROR (83)"
! 233: Issuer check failed (Added in 7.19.0)
! 234: .IP "CURLE_FTP_PRET_FAILED (84)"
! 235: The FTP server does not understand the PRET command at all or does not support
! 236: the given argument. Be careful when using \fICURLOPT_CUSTOMREQUEST(3)\fP, a
! 237: custom LIST command will be sent with PRET CMD before PASV as well. (Added in
! 238: 7.20.0)
! 239: .IP "CURLE_RTSP_CSEQ_ERROR (85)"
! 240: Mismatch of RTSP CSeq numbers.
! 241: .IP "CURLE_RTSP_SESSION_ERROR (86)"
! 242: Mismatch of RTSP Session Identifiers.
! 243: .IP "CURLE_FTP_BAD_FILE_LIST (87)"
! 244: Unable to parse FTP file list (during FTP wildcard downloading).
! 245: .IP "CURLE_CHUNK_FAILED (88)"
! 246: Chunk callback reported error.
! 247: .IP "CURLE_NO_CONNECTION_AVAILABLE (89)"
! 248: (For internal use only, will never be returned by libcurl) No connection
! 249: available, the session will be queued. (added in 7.30.0)
! 250: .IP "CURLE_SSL_PINNEDPUBKEYNOTMATCH (90)"
! 251: Failed to match the pinned key specified with \fICURLOPT_PINNEDPUBLICKEY(3)\fP.
! 252: .IP "CURLE_SSL_INVALIDCERTSTATUS (91)"
! 253: Status returned failure when asked with \fICURLOPT_SSL_VERIFYSTATUS(3)\fP.
! 254: .IP "CURLE_HTTP2_STREAM (92)"
! 255: Stream error in the HTTP/2 framing layer.
! 256: .IP "CURLE_RECURSIVE_API_CALL (93)"
! 257: An API function was called from inside a callback.
! 258: .IP "CURLE_AUTH_ERROR (94)"
! 259: An authentication function returned an error.
! 260: .IP "CURLE_HTTP3 (95)"
! 261: A problem was detected in the HTTP/3 layer. This is somewhat generic and can
! 262: be one out of several problems, see the error buffer for details.
! 263: .IP "CURLE_QUIC_CONNECT_ERROR (96)"
! 264: QUIC connection error. This error may be caused by an SSL library error. QUIC
! 265: is the protocol used for HTTP/3 transfers.
! 266: .IP "CURLE_OBSOLETE*"
! 267: These error codes will never be returned. They were used in an old libcurl
! 268: version and are currently unused.
! 269: .SH "CURLMcode"
! 270: This is the generic return code used by functions in the libcurl multi
! 271: interface. Also consider \fIcurl_multi_strerror(3)\fP.
! 272: .IP "CURLM_CALL_MULTI_PERFORM (-1)"
! 273: This is not really an error. It means you should call
! 274: \fIcurl_multi_perform(3)\fP again without doing select() or similar in
! 275: between. Before version 7.20.0 this could be returned by
! 276: \fIcurl_multi_perform(3)\fP, but in later versions this return code is never
! 277: used.
! 278: .IP "CURLM_CALL_MULTI_SOCKET (-1)"
! 279: An alias for CURLM_CALL_MULTI_PERFORM. Never returned by modern libcurl
! 280: versions.
! 281: .IP "CURLM_OK (0)"
! 282: Things are fine.
! 283: .IP "CURLM_BAD_HANDLE (1)"
! 284: The passed-in handle is not a valid CURLM handle.
! 285: .IP "CURLM_BAD_EASY_HANDLE (2)"
! 286: An easy handle was not good/valid. It could mean that it isn't an easy handle
! 287: at all, or possibly that the handle already is in use by this or another multi
! 288: handle.
! 289: .IP "CURLM_OUT_OF_MEMORY (3)"
! 290: You are doomed.
! 291: .IP "CURLM_INTERNAL_ERROR (4)"
! 292: This can only be returned if libcurl bugs. Please report it to us!
! 293: .IP "CURLM_BAD_SOCKET (5)"
! 294: The passed-in socket is not a valid one that libcurl already knows about.
! 295: (Added in 7.15.4)
! 296: .IP "CURLM_UNKNOWN_OPTION (6)"
! 297: curl_multi_setopt() with unsupported option
! 298: (Added in 7.15.4)
! 299: .IP "CURLM_ADDED_ALREADY (7)"
! 300: An easy handle already added to a multi handle was attempted to get added a
! 301: second time. (Added in 7.32.1)
! 302: .IP "CURLM_RECURSIVE_API_CALL (8)"
! 303: An API function was called from inside a callback.
! 304: .IP "CURLM_WAKEUP_FAILURE (9)"
! 305: Wakeup is unavailable or failed.
! 306: .IP "CURLM_BAD_FUNCTION_ARGUMENT (10)"
! 307: A function was called with a bad parameter.
! 308: .SH "CURLSHcode"
! 309: The "share" interface will return a CURLSHcode to indicate when an error has
! 310: occurred. Also consider \fIcurl_share_strerror(3)\fP.
! 311: .IP "CURLSHE_OK (0)"
! 312: All fine. Proceed as usual.
! 313: .IP "CURLSHE_BAD_OPTION (1)"
! 314: An invalid option was passed to the function.
! 315: .IP "CURLSHE_IN_USE (2)"
! 316: The share object is currently in use.
! 317: .IP "CURLSHE_INVALID (3)"
! 318: An invalid share object was passed to the function.
! 319: .IP "CURLSHE_NOMEM (4)"
! 320: Not enough memory was available.
! 321: (Added in 7.12.0)
! 322: .IP "CURLSHE_NOT_BUILT_IN (5)"
! 323: The requested sharing could not be done because the library you use don't have
! 324: that particular feature enabled. (Added in 7.23.0)
! 325: .SH "CURLUcode"
! 326: .IP "CURLUE_BAD_HANDLE (1)"
! 327: An argument that should be a CURLU pointer was passed in as a NULL.
! 328: .IP "CURLUE_BAD_PARTPOINTER (2)"
! 329: A NULL pointer was passed to the 'part' argument of \fIcurl_url_get(3)\fP.
! 330: .IP "CURLUE_MALFORMED_INPUT (3)"
! 331: A malformed input was passed to a URL API function.
! 332: .IP "CURLUE_BAD_PORT_NUMBER (4)"
! 333: The port number was not a decimal number between 0 and 65535.
! 334: .IP "CURLUE_UNSUPPORTED_SCHEME (5)"
! 335: This libcurl build doesn't support the given URL scheme.
! 336: .IP "CURLUE_URLDECODE (6)"
! 337: URL decode error, most likely because of rubbish in the input.
! 338: .IP "CURLUE_OUT_OF_MEMORY (7)"
! 339: A memory function failed.
! 340: .IP "CURLUE_USER_NOT_ALLOWED (8)"
! 341: Credentials was passed in the URL when prohibited.
! 342: .IP "CURLUE_UNKNOWN_PART (9)"
! 343: An unknown part ID was passed to a URL API function.
! 344: .IP "CURLUE_NO_SCHEME (10)"
! 345: There is no scheme part in the URL.
! 346: .IP "CURLUE_NO_USER (11)"
! 347: There is no user part in the URL.
! 348: .IP "CURLUE_NO_PASSWORD (12)"
! 349: There is no password part in the URL.
! 350: .IP "CURLUE_NO_OPTIONS (13)"
! 351: There is no options part in the URL.
! 352: .IP "CURLUE_NO_HOST (14)"
! 353: There is no host part in the URL.
! 354: .IP "CURLUE_NO_PORT (15)"
! 355: There is no port part in the URL.
! 356: .IP "CURLUE_NO_QUERY (16)"
! 357: There is no query part in the URL.
! 358: .IP "CURLUE_NO_FRAGMENT (17)"
! 359: There is no fragment part in the URL.
! 360: .SH "SEE ALSO"
! 361: .BR curl_easy_strerror "(3), " curl_multi_strerror "(3), "
! 362: .BR curl_share_strerror "(3), " CURLOPT_ERRORBUFFER "(3), "
! 363: .BR CURLOPT_VERBOSE "(3), " CURLOPT_DEBUGFUNCTION "(3) "
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to libcurl-errors.3 CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / curl / docs / libcurl