220 lines
9.6 KiB
Groff
220 lines
9.6 KiB
Groff
.\" You can view this file with:
|
|
.\" nroff -man [file]
|
|
.\" $Id$
|
|
.\"
|
|
.TH libcurl-errors 3 "27 Apr 2004" "libcurl 7.12" "libcurl errors"
|
|
.SH NAME
|
|
libcurl-errors \- error codes in libcurl
|
|
.SH DESCRIPTION
|
|
This man page includes most, if not all, available error codes in libcurl.
|
|
Why they occur and possibly what you can do to fix the problem.
|
|
.SH "CURLcode"
|
|
Almost all "easy" interface functions return a CURLcode error code. No matter
|
|
what, using the \fIcurl_easy_setopt(3)\fP option \fICURLOPT_ERRORBUFFER\fP is
|
|
a good idea as it will give you a human readable error string that may offer
|
|
more details about the error cause than just the error code
|
|
does. \fIcurl_easy_strerror(3)\fP can be called to get an error string from a
|
|
given CURLcode number.
|
|
|
|
CURLcode is one of the following:
|
|
.IP "CURLE_OK (0)"
|
|
All fine. Proceed as usual.
|
|
.IP "CURLE_UNSUPPORTED_PROTOCOL (1)"
|
|
The URL you passed to libcurl used a protocol that this libcurl does not
|
|
support. The support might be a compile-time option that you didn't use, it
|
|
can be a misspelled protocol string or just a protocol libcurl has no code
|
|
for.
|
|
.IP "CURLE_FAILED_INIT (2)"
|
|
Very early initialization code failed. This is likely to be an internal error
|
|
or problem.
|
|
.IP "CURLE_URL_MALFORMAT (3)"
|
|
The URL was not properly formatted.
|
|
.IP "CURLE_URL_MALFORMAT_USER (4)"
|
|
URL user malformatted. The user-part of the URL syntax was not correct.
|
|
.IP "CURLE_COULDNT_RESOLVE_PROXY (5)"
|
|
Couldn't resolve proxy. The given proxy host could not be resolved.
|
|
.IP "CURLE_COULDNT_RESOLVE_HOST (6)"
|
|
Couldn't resolve host. The given remote host was not resolved.
|
|
.IP "CURLE_COULDNT_CONNECT (7)"
|
|
Failed to connect() to host or proxy.
|
|
.IP "CURLE_FTP_WEIRD_SERVER_REPLY (8)"
|
|
After connecting to an FTP server, libcurl expects to get a certain reply back.
|
|
This error code implies that it god a strange or bad reply. The given remote
|
|
server is probably not an OK FTP server.
|
|
.IP "CURLE_FTP_ACCESS_DENIED (9)"
|
|
We were denied access when trying to login to an FTP server or when trying to
|
|
change working directory to the one given in the URL.
|
|
.IP "CURLE_FTP_USER_PASSWORD_INCORRECT (10)"
|
|
The username and/or the password were incorrect when trying to login to an FTP
|
|
server.
|
|
.IP "CURLE_FTP_WEIRD_PASS_REPLY (11)"
|
|
After having sent the FTP password to the server, libcurl expects a proper
|
|
reply. This error code indicates that an unexpected code was returned.
|
|
.IP "CURLE_FTP_WEIRD_USER_REPLY (12)"
|
|
After having sent user name to the FTP server, libcurl expects a proper
|
|
reply. This error code indicates that an unexpected code was returned.
|
|
.IP "CURLE_FTP_WEIRD_PASV_REPLY (13)"
|
|
libcurl failed to get a sensible result back from the server as a response to
|
|
either a PASV or a EPSV command. The server is flawed.
|
|
.IP "CURLE_FTP_WEIRD_227_FORMAT (14)"
|
|
FTP servers return a 227-line as a response to a PASV command. If libcurl
|
|
fails to parse that line, this return code is passed back.
|
|
.IP "CURLE_FTP_CANT_GET_HOST (15)"
|
|
An internal failure to lookup the host used for the new connection.
|
|
.IP "CURLE_FTP_CANT_RECONNECT (16)"
|
|
A bad return code on either PASV or EPSV was sent by the FTP server,
|
|
preventing libcurl from being able to continue.
|
|
.IP "CURLE_FTP_COULDNT_SET_BINARY (17)"
|
|
Received an error when trying to set the transfer mode to binary.
|
|
.IP "CURLE_PARTIAL_FILE (18)"
|
|
A file transfer was shorter or larger than expected. This happens when the
|
|
server first reports an expected transfer size, and then delivers data that
|
|
doesn't match the previously given size.
|
|
.IP "CURLE_FTP_COULDNT_RETR_FILE (19)"
|
|
This was either a weird reply to a 'RETR' command or a zero byte transfer
|
|
complete.
|
|
.IP "CURLE_FTP_WRITE_ERROR (20)"
|
|
After a completed file transfer, the FTP server did not respond a proper
|
|
\"transfer successful\" code.
|
|
.IP "CURLE_FTP_QUOTE_ERROR (21)"
|
|
When sending custom "QUOTE" commands to the remote server, one of the commands
|
|
returned an error code that was 400 or higher.
|
|
.IP "CURLE_HTTP_RETURNED_ERROR (22)"
|
|
This is returned if CURLOPT_FAILONERROR is set TRUE and the HTTP server
|
|
returns an error code that is >= 400.
|
|
.IP "CURLE_WRITE_ERROR (23)"
|
|
An error occurred when writing received data to a local file, or an error was
|
|
returned to libcurl from a write callback.
|
|
.IP "CURLE_MALFORMAT_USER (24)"
|
|
Malformat user. User name badly specified. *Not currently used*
|
|
.IP "CURLE_FTP_COULDNT_STOR_FILE (25)"
|
|
FTP couldn't STOR file. The server denied the STOR operation. The error buffer
|
|
usually contains the server's explanation to this.
|
|
.IP "CURLE_READ_ERROR (26)"
|
|
There was a problem reading a local file or an error returned by the read
|
|
callback.
|
|
.IP "CURLE_OUT_OF_MEMORY (27)"
|
|
Out of memory. A memory allocation request failed. This is serious badness and
|
|
things are severely screwed up if this ever occur.
|
|
.IP "CURLE_OPERATION_TIMEOUTED (28)"
|
|
Operation timeout. The specified time-out period was reached according to the
|
|
conditions.
|
|
.IP "CURLE_FTP_COULDNT_SET_ASCII (29)"
|
|
libcurl failed to set ASCII transfer type (TYPE A).
|
|
.IP "CURLE_FTP_PORT_FAILED (30)"
|
|
The FTP PORT command returned error. This mostly happen when you haven't
|
|
specified a good enough address for libcurl to use. See \fICURLOPT_FTPPORT\fP.
|
|
.IP "CURLE_FTP_COULDNT_USE_REST (31)"
|
|
The FTP REST command returned error. This should never happen if the server is
|
|
sane.
|
|
.IP "CURLE_FTP_COULDNT_GET_SIZE (32)"
|
|
The FTP SIZE command returned error. SIZE is not a kosher FTP command, it is
|
|
an extension and not all servers support it. This is not a surprising error.
|
|
.IP "CURLE_HTTP_RANGE_ERROR (33)"
|
|
The HTTP server does not support or accept range requests.
|
|
.IP "CURLE_HTTP_POST_ERROR (34)"
|
|
This is an odd error that mainly occurs due to internal confusion.
|
|
.IP "CURLE_SSL_CONNECT_ERROR (35)"
|
|
A problem occurred somewhere in the SSL/TLS handshake. You really want the
|
|
error buffer and read the message there as it pinpoints the problem slightly
|
|
more. Could be certificates (file formats, paths, permissions), passwords, and
|
|
others.
|
|
.IP "CURLE_FTP_BAD_DOWNLOAD_RESUME (36)"
|
|
Attempting FTP resume beyond file size.
|
|
.IP "CURLE_FILE_COULDNT_READ_FILE (37)"
|
|
A file given with FILE:// couldn't be opened. Most likely because the file
|
|
path doesn't identify an existing file. Did you check file permissions?
|
|
.IP "CURLE_LDAP_CANNOT_BIND (38)"
|
|
LDAP cannot bind. LDAP bind operation failed.
|
|
.IP "CURLE_LDAP_SEARCH_FAILED (39)"
|
|
LDAP search failed.
|
|
.IP "CURLE_LIBRARY_NOT_FOUND (40)"
|
|
Library not found. The LDAP library was not found.
|
|
.IP "CURLE_FUNCTION_NOT_FOUND (41)"
|
|
Function not found. A required LDAP function was not found.
|
|
.IP "CURLE_ABORTED_BY_CALLBACK (42)"
|
|
Aborted by callback. A callback returned "abort" to libcurl.
|
|
.IP "CURLE_BAD_FUNCTION_ARGUMENT (43)"
|
|
Internal error. A function was called with a bad parameter.
|
|
.IP "CURLE_BAD_CALLING_ORDER (44)"
|
|
Internal error. A function was called in a bad order.
|
|
.IP "CURLE_HTTP_PORT_FAILED (45)"
|
|
Interface error. A specified outgoing interface could not be used. Set which
|
|
interface to use for outgoing connections' source IP address with
|
|
CURLOPT_INTERFACE.
|
|
.IP "CURLE_BAD_PASSWORD_ENTERED (46)"
|
|
Bad password entered. An error was signaled when the password was
|
|
entered. This can also be the result of a "bad password" returned from a
|
|
specified password callback.
|
|
.IP "CURLE_TOO_MANY_REDIRECTS (47)"
|
|
Too many redirects. When following redirects, libcurl hit the maximum amount.
|
|
Set your limit with CURLOPT_MAXREDIRS.
|
|
.IP "CURLE_UNKNOWN_TELNET_OPTION (48)"
|
|
An option set with CURLOPT_TELNETOPTIONS was not recognized/known. Refer to
|
|
the appropriate documentation.
|
|
.IP "CURLE_TELNET_OPTION_SYNTAX (49)"
|
|
A telnet option string was Illegally formatted.
|
|
.IP "CURLE_OBSOLETE (50)"
|
|
This is not an error. This used to be another error code in an old libcurl
|
|
version and is currently unused.
|
|
.IP "CURLE_SSL_PEER_CERTIFICATE (51)"
|
|
The remote server's SSL certificate was deemed not OK.
|
|
.IP "CURLE_GOT_NOTHING (52)"
|
|
Nothing was returned from the server, and under the circumstances, getting
|
|
nothing is considered an error.
|
|
.IP "CURLE_SSL_ENGINE_NOTFOUND (53)"
|
|
The specified crypto engine wasn't found.
|
|
.IP "CURLE_SSL_ENGINE_SETFAILED (54)"
|
|
Failed setting the selected SSL crypto engine as default!
|
|
.IP "CURLE_SEND_ERROR (55)"
|
|
Failed sending network data.
|
|
.IP "CURLE_RECV_ERROR (56)"
|
|
Failure with receiving network data.
|
|
.IP "CURLE_SHARE_IN_USE (57)"
|
|
Share is in use
|
|
.IP "CURLE_SSL_CERTPROBLEM (58)"
|
|
problem with the local certificate
|
|
.IP "CURLE_SSL_CIPHER (59)"
|
|
couldn't use specified cipher
|
|
.IP "CURLE_SSL_CACERT (60)"
|
|
problem with the CA cert (path? access rights?)
|
|
.IP "CURLE_BAD_CONTENT_ENCODING (61)"
|
|
Unrecognized transfer encoding
|
|
.IP "CURLE_LDAP_INVALID_URL (62)"
|
|
Invalid LDAP URL
|
|
.IP "CURLE_FILESIZE_EXCEEDED (63)"
|
|
Maximum file size exceeded
|
|
.IP "CURLE_FTP_SSL_FAILED (64)"
|
|
Requested FTP SSL level failed
|
|
.SH "CURLMcode"
|
|
This is the generic return code used by functions in the libcurl multi
|
|
interface. Also consider \fIcurl_multi_strerror(3)\fI.
|
|
|
|
.IP "CURLM_CALL_MULTI_PERFORM (-1)"
|
|
This is not really an error. It means you should call
|
|
\fIcurl_multi_perform(3)\fP again without doing select() or similar in between.
|
|
.IP "CURLM_OK (0)"
|
|
Things are fine.
|
|
.IP "CURLM_BAD_HANDLE (1)"
|
|
The passed-in handle is not a valid CURLM handle.
|
|
.IP "CURLM_BAD_EASY_HANDLE (2)"
|
|
An easy handle was not good/valid.
|
|
.IP "CURLM_OUT_OF_MEMORY (3)"
|
|
You are doomed.
|
|
.IP "CURLM_INTERNAL_ERROR (4)"
|
|
This can only be returned if libcurl bugs. Please report it to us!
|
|
.SH "CURLSHcode"
|
|
The "share" interface will return a CURLSHcode to indicate when an error has
|
|
occurred. Also consider \fIcurl_share_strerror(3)\fI.
|
|
|
|
CURLSHcode is one of the following:
|
|
.IP "CURLSHE_OK (0)"
|
|
All fine. Proceed as usual.
|
|
.IP "CURLSHE_BAD_OPTION (1)"
|
|
An invalid option was passed to the function.
|
|
.IP "CURLSHE_IN_USE (2)"
|
|
The share object is currently in use.
|
|
.IP "CURLSHE_INVALID (3)"
|
|
An invalid share object was passed to the function.
|
|
|