aboutsummaryrefslogtreecommitdiff
path: root/docs/libcurl
diff options
context:
space:
mode:
Diffstat (limited to 'docs/libcurl')
-rw-r--r--docs/libcurl/libcurl-errors.3197
1 files changed, 66 insertions, 131 deletions
diff --git a/docs/libcurl/libcurl-errors.3 b/docs/libcurl/libcurl-errors.3
index e25932250..84dc5dd03 100644
--- a/docs/libcurl/libcurl-errors.3
+++ b/docs/libcurl/libcurl-errors.3
@@ -18,240 +18,175 @@ This man page is meant to describe libcurl 7.9.6 and later. Earlier versions
might have had quirks not mentioned here.
CURLcode is one of the following:
-.RS 1
-.TP 5
-.B CURLE_OK (0)
+.RS 0
+.IP "CURLE_OK (0)"
All fine. Proceed as usual.
-.TP
-.B CURLE_UNSUPPORTED_PROTOCOL (1)
+.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.
-.TP
-.B CURLE_FAILED_INIT (2)
+.IP "CURLE_FAILED_INIT (2)"
Very early initialization code failed. This is likely to be an internal error
or problem.
-.TP
-.B CURLE_URL_MALFORMAT (3)
+.IP "CURLE_URL_MALFORMAT (3)"
The URL was not properly formatted.
-.TP
-.B CURLE_URL_MALFORMAT_USER (4)
+.IP "CURLE_URL_MALFORMAT_USER (4)"
URL user malformatted. The user-part of the URL syntax was not correct.
-.TP
-.B CURLE_COULDNT_RESOLVE_PROXY (5)
+.IP "CURLE_COULDNT_RESOLVE_PROXY (5)"
Couldn't resolve proxy. The given proxy host could not be resolved.
-.TP
-.B CURLE_COULDNT_RESOLVE_HOST (6)
+.IP "CURLE_COULDNT_RESOLVE_HOST (6)"
Couldn't resolve host. The given remote host was not resolved.
-.TP
-.B CURLE_COULDNT_CONNECT (7)
+.IP "CURLE_COULDNT_CONNECT (7)"
Failed to connect() to host or proxy.
-.TP
-.B CURLE_FTP_WEIRD_SERVER_REPLY (8)
+.IP "CURLE_FTP_WEIRD_SERVER_REPLY (8)"
After connecting to a 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.
-.TP
-.B CURLE_FTP_ACCESS_DENIED (9)
+.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.
-.TP
-.B CURLE_FTP_USER_PASSWORD_INCORRECT (10)
+.IP "CURLE_FTP_USER_PASSWORD_INCORRECT (10)"
The username and/or the password were incorrect when trying to login to an FTP
server.
-.TP
-.B CURLE_FTP_WEIRD_PASS_REPLY (11)
+.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.
-.TP
-.B CURLE_FTP_WEIRD_USER_REPLY (12)
+.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.
-.TP
-.B CURLE_FTP_WEIRD_PASV_REPLY (13)
+.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.
-.TP
-.B CURLE_FTP_WEIRD_227_FORMAT (14)
+.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.
-.TP
-.B CURLE_FTP_CANT_GET_HOST (15)
+.IP "CURLE_FTP_CANT_GET_HOST (15)"
An internal failure to lookup the host used for the new connection.
-.TP
-.B CURLE_FTP_CANT_RECONNECT (16)
+.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.
-.TP
-.B CURLE_FTP_COULDNT_SET_BINARY (17)
+.IP "CURLE_FTP_COULDNT_SET_BINARY (17)"
Received an error when trying to set the transfer mode to binary.
-.TP
-.B CURLE_PARTIAL_FILE (18)
+.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.
-.TP
-.B CURLE_FTP_COULDNT_RETR_FILE (19)
+.IP "CURLE_FTP_COULDNT_RETR_FILE (19)"
This was either a weird reply to a 'RETR' command or a zero byte transfer
complete.
-.TP
-.B CURLE_FTP_WRITE_ERROR (20)
+.IP "CURLE_FTP_WRITE_ERROR (20)"
After a completed file transfer, the FTP server did not respond a proper
\"transfer successful\" code.
-.TP
-.B CURLE_FTP_QUOTE_ERROR (21)
+.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.
-.TP
-.B CURLE_HTTP_RETURNED_ERROR (22)
+.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.
-.TP
-.B CURLE_WRITE_ERROR (23)
+.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.
-.TP
-.B CURLE_MALFORMAT_USER (24)
+.IP "CURLE_MALFORMAT_USER (24)"
Malformat user. User name badly specified. *Not currently used*
-.TP
-.B CURLE_FTP_COULDNT_STOR_FILE (25)
+.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.
-.TP
-.B CURLE_READ_ERROR (26)
+.IP "CURLE_READ_ERROR (26)"
There was a problem reading a local file or an error returned by the read
callback.
-.TP
-.B CURLE_OUT_OF_MEMORY (27)
+.IP "CURLE_OUT_OF_MEMORY (27)"
Out of memory. A memory allocation request failed. This is serious badness and
things are severly screwed up if this ever occur.
-.TP
-.B CURLE_OPERATION_TIMEOUTED (28)
+.IP "CURLE_OPERATION_TIMEOUTED (28)"
Operation timeout. The specified time-out period was reached according to the
conditions.
-.TP
-.B CURLE_FTP_COULDNT_SET_ASCII (29)
+.IP "CURLE_FTP_COULDNT_SET_ASCII (29)"
libcurl failed to set ASCII transfer type (TYPE A).
-.TP
-.B CURLE_FTP_PORT_FAILED (30)
+.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.
-.TP
-.B CURLE_FTP_COULDNT_USE_REST (31)
+.IP "CURLE_FTP_COULDNT_USE_REST (31)"
The FTP REST command returned error. This should never happen if the server is
sane.
-.TP
-.B CURLE_FTP_COULDNT_GET_SIZE (32)
+.IP "CURLE_FTP_COULDNT_GET_SIZE (32)"
The FTP SIZE command returned errror. SIZE is not a kosher FTP command, it is
an extension and not all servers support it. This is not a surprising error.
-.TP
-.B CURLE_HTTP_RANGE_ERROR (33)
+.IP "CURLE_HTTP_RANGE_ERROR (33)"
The HTTP server does not support or accept range requests.
-.TP
-.B CURLE_HTTP_POST_ERROR (34)
+.IP "CURLE_HTTP_POST_ERROR (34)"
This is an odd error that mainly occurs due to internal confusion.
-.TP
-.B CURLE_SSL_CONNECT_ERROR (35)
+.IP "CURLE_SSL_CONNECT_ERROR (35)"
A problem occured 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.
-.TP
-.B CURLE_FTP_BAD_DOWNLOAD_RESUME (36)
+.IP "CURLE_FTP_BAD_DOWNLOAD_RESUME (36)"
Attempting FTP resume beyond file size.
-.TP
-.B CURLE_FILE_COULDNT_READ_FILE (37)
+.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?
-.TP
-.B CURLE_LDAP_CANNOT_BIND (38)
+.IP "CURLE_LDAP_CANNOT_BIND (38)"
LDAP cannot bind. LDAP bind operation failed.
-.TP
-.B CURLE_LDAP_SEARCH_FAILED (39)
+.IP "CURLE_LDAP_SEARCH_FAILED (39)"
LDAP search failed.
-.TP
-.B CURLE_LIBRARY_NOT_FOUND (40)
+.IP "CURLE_LIBRARY_NOT_FOUND (40)"
Library not found. The LDAP library was not found.
-.TP
-.B CURLE_FUNCTION_NOT_FOUND (41)
+.IP "CURLE_FUNCTION_NOT_FOUND (41)"
Function not found. A required LDAP function was not found.
-.TP
-.B CURLE_ABORTED_BY_CALLBACK (42)
+.IP "CURLE_ABORTED_BY_CALLBACK (42)"
Aborted by callback. A callback returned "abort" to libcurl.
-.TP
-.B CURLE_BAD_FUNCTION_ARGUMENT (43)
+.IP "CURLE_BAD_FUNCTION_ARGUMENT (43)"
Internal error. A function was called with a bad parameter.
-.TP
-.B CURLE_BAD_CALLING_ORDER (44)
+.IP "CURLE_BAD_CALLING_ORDER (44)"
Internal error. A function was called in a bad order.
-.TP
-.B CURLE_HTTP_PORT_FAILED (45)
+.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.
-.TP
-.B CURLE_BAD_PASSWORD_ENTERED (46)
+.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.
-.TP
-.B CURLE_TOO_MANY_REDIRECTS (47)
+.IP "CURLE_TOO_MANY_REDIRECTS (47)"
Too many redirects. When following redirects, libcurl hit the maximum amount.
Set your limit with CURLOPT_MAXREDIRS.
-.TP
-.B CURLE_UNKNOWN_TELNET_OPTION (48)
+.IP "CURLE_UNKNOWN_TELNET_OPTION (48)"
An option set with CURLOPT_TELNETOPTIONS was not recognized/known. Refer to
the appropriate documentation.
-.TP
-.B CURLE_TELNET_OPTION_SYNTAX (49)
+.IP "CURLE_TELNET_OPTION_SYNTAX (49)"
A telnet option string was Illegally formatted.
-.TP
-.B CURLE_OBSOLETE (50)
+.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.
-.TP
-.B CURLE_SSL_PEER_CERTIFICATE (51)
+.IP "CURLE_SSL_PEER_CERTIFICATE (51)"
The remote server's SSL certificate was deemed not OK.
-.TP
-.B CURLE_GOT_NOTHING (52)
+.IP "CURLE_GOT_NOTHING (52)"
Nothing was returned from the server, and under the circumstances, getting
nothing is considered an error.
-.TP
-.B CURLE_SSL_ENGINE_NOTFOUND (53)
+.IP "CURLE_SSL_ENGINE_NOTFOUND (53)"
The specified crypto engine wasn't found.
-.TP
-.B CURLE_SSL_ENGINE_SETFAILED (54)
+.IP "CURLE_SSL_ENGINE_SETFAILED (54)"
Failed setting the selected SSL crypto engine as default!
-.TP
-.B CURLE_SEND_ERROR (55)
+.IP "CURLE_SEND_ERROR (55)"
Failed sending network data.
-.TP
-.B CURLE_RECV_ERROR (56)
+.IP "CURLE_RECV_ERROR (56)"
Failure with receiving network data.
-.TP
-.B CURLE_RECV_ERROR (57)
+.IP "CURLE_RECV_ERROR (57)"
Failure with receiving network data.
-.TP
-.B CURLE_SSL_CERTPROBLEM (58)
+.IP "CURLE_SSL_CERTPROBLEM (58)"
problem with the local certificate
-.TP
-.B CURLE_SSL_CIPHER (59)
+.IP "CURLE_SSL_CIPHER (59)"
couldn't use specified cipher
-.TP
-.B CURLE_SSL_CACERT (60)
+.IP "CURLE_SSL_CACERT (60)"
problem with the CA cert (path? access rights?)
-.TP
-.B CURLE_BAD_CONTENT_ENCODING (61)
+.IP "CURLE_BAD_CONTENT_ENCODING (61)"
Unrecognized transfer encoding
-.TP
-.B CURLE_LDAP_INVALID_URL (62)
+.IP "CURLE_LDAP_INVALID_URL (62)"
Invalid LDAP URL
-.TP
-.B CURLE_FILESIZE_EXCEEDED (63)
+.IP "CURLE_FILESIZE_EXCEEDED (63)"
Maximum file size exceeded
-.TP
-.B CURL_LAST
+.IP "CURL_LAST"
This is not an error, but in the curl/curl.h file this can be used to know how
many existing error codes there are.
.RE