18
18
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
19
19
.\" * KIND, either express or implied.
21
.\" * $Id: libcurl-errors.3,v 1.31 2008-05-12 21:43:28 bagder Exp $
21
.\" * $Id: libcurl-errors.3,v 1.35 2008-12-28 21:56:56 bagder Exp $
22
22
.\" **************************************************************************
24
.TH libcurl-errors 3 "30 Aug 2007" "libcurl 7.17.0" "libcurl errors"
24
.TH libcurl-errors 3 "8 Jun 2008" "libcurl 7.19.0" "libcurl errors"
26
26
libcurl-errors \- error codes in libcurl
28
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.
29
Why they occur and possibly what you can do to fix the problem are also included.
31
31
Almost all "easy" interface functions return a CURLcode error code. No matter
32
32
what, using the \fIcurl_easy_setopt(3)\fP option \fICURLOPT_ERRORBUFFER\fP is
33
33
a good idea as it will give you a human readable error string that may offer
34
more details about the error cause than just the error code
35
does. \fIcurl_easy_strerror(3)\fP can be called to get an error string from a
34
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
36
36
given CURLcode number.
38
38
CURLcode is one of the following:
94
94
returned to libcurl from a write callback.
95
95
.IP "CURLE_UPLOAD_FAILED (25)"
96
96
Failed starting the upload. For FTP, the server typically denied the STOR
97
command. The error buffer usually contains the server's explanation to this.
97
command. The error buffer usually contains the server's explanation for this.
98
98
(This error code was formerly known as CURLE_FTP_COULDNT_STOR_FILE.)
99
99
.IP "CURLE_READ_ERROR (26)"
100
100
There was a problem reading a local file or an error returned by the read
102
102
.IP "CURLE_OUT_OF_MEMORY (27)"
103
103
A memory allocation request failed. This is serious badness and
104
things are severely screwed up if this ever occur.
104
things are severely screwed up if this ever occurs.
105
105
.IP "CURLE_OPERATION_TIMEDOUT (28)"
106
106
Operation timeout. The specified time-out period was reached according to the
108
108
.IP "CURLE_FTP_PORT_FAILED (30)"
109
The FTP PORT command returned error. This mostly happen when you haven't
109
The FTP PORT command returned error. This mostly happens when you haven't
110
110
specified a good enough address for libcurl to use. See \fICURLOPT_FTPPORT\fP.
111
111
.IP "CURLE_FTP_COULDNT_USE_REST (31)"
112
112
The FTP REST command returned error. This should never happen if the server is
162
162
.IP "CURLE_RECV_ERROR (56)"
163
163
Failure with receiving network data.
164
164
.IP "CURLE_SSL_CERTPROBLEM (58)"
165
problem with the local client certificate
165
problem with the local client certificate.
166
166
.IP "CURLE_SSL_CIPHER (59)"
167
Couldn't use specified cipher
167
Couldn't use specified cipher.
168
168
.IP "CURLE_SSL_CACERT (60)"
169
Peer certificate cannot be authenticated with known CA certificates
169
Peer certificate cannot be authenticated with known CA certificates.
170
170
.IP "CURLE_BAD_CONTENT_ENCODING (61)"
171
Unrecognized transfer encoding
171
Unrecognized transfer encoding.
172
172
.IP "CURLE_LDAP_INVALID_URL (62)"
174
174
.IP "CURLE_FILESIZE_EXCEEDED (63)"
175
Maximum file size exceeded
175
Maximum file size exceeded.
176
176
.IP "CURLE_USE_SSL_FAILED (64)"
177
Requested FTP SSL level failed
177
Requested FTP SSL level failed.
178
178
.IP "CURLE_SEND_FAIL_REWIND (65)"
179
179
When doing a send operation curl had to rewind the data to retransmit, but the
180
rewinding operation failed
180
rewinding operation failed.
181
181
.IP "CURLE_SSL_ENGINE_INITFAILED (66)"
182
Initiating the SSL Engine failed
182
Initiating the SSL Engine failed.
183
183
.IP "CURLE_LOGIN_DENIED (67)"
184
184
The remote server denied curl to login (Added in 7.13.1)
185
185
.IP "CURLE_TFTP_NOTFOUND (68)"
186
File not found on TFTP server
186
File not found on TFTP server.
187
187
.IP "CURLE_TFTP_PERM (69)"
188
Permission problem on TFTP server
188
Permission problem on TFTP server.
189
189
.IP "CURLE_REMOTE_DISK_FULL (70)"
190
Out of disk space on the server
190
Out of disk space on the server.
191
191
.IP "CURLE_TFTP_ILLEGAL (71)"
192
Illegal TFTP operation
192
Illegal TFTP operation.
193
193
.IP "CURLE_TFTP_UNKNOWNID (72)"
194
Unknown TFTP transfer ID
194
Unknown TFTP transfer ID.
195
195
.IP "CURLE_REMOTE_FILE_EXISTS (73)"
196
File already exists and will not be overwritten
196
File already exists and will not be overwritten.
197
197
.IP "CURLE_TFTP_NOSUCHUSER (74)"
198
This error should never be returned by a properly functioning TFTP server
198
This error should never be returned by a properly functioning TFTP server.
199
199
.IP "CURLE_CONV_FAILED (75)"
200
Character conversion failed
200
Character conversion failed.
201
201
.IP "CURLE_CONV_REQD (76)"
202
Caller must register conversion callbacks
202
Caller must register conversion callbacks.
203
203
.IP "CURLE_SSL_CACERT_BADFILE (77)"
204
204
Problem with reading the SSL CA cert (path? access rights?)
205
205
.IP "CURLE_REMOTE_FILE_NOT_FOUND (78)"
206
The resource referenced in the URL does not exist
206
The resource referenced in the URL does not exist.
207
207
.IP "CURLE_SSH (79)"
208
An unspecified error occurred during the SSH session
208
An unspecified error occurred during the SSH session.
209
209
.IP "CURLE_SSL_SHUTDOWN_FAILED (80)"
210
Failed to shut down the SSL connection
210
Failed to shut down the SSL connection.
211
211
.IP "CURLE_AGAIN (81)"
212
212
Socket is not ready for send/recv wait till it's ready and try again. This
213
213
return code is only returned from \fIcurl_easy_recv(3)\fP and
214
214
\fIcurl_easy_send(3)\fP (Added in 7.18.2)
215
.IP "CURLE_SSL_CRL_BADFILE (82)"
216
Failed to load CRL file (Added in 7.19.0)
217
.IP "CURLE_SSL_ISSUER_ERROR (83)"
218
Issuer check failed (Added in 7.19.0)
215
219
.IP "CURLE_OBSOLETE*"
216
These error codes will never be returned. They used to be used in an old libcurl
220
These error codes will never be returned. They were used in an old libcurl
217
221
version and are currently unused.
219
223
This is the generic return code used by functions in the libcurl multi
added
removed
docs/libcurl/libcurl-errors.3
