~ubuntu-branches/ubuntu/vivid/curl/vivid

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. <a name="CURLcode"></a><h2 class="nroffsh">CURLcode</h2>

Almost all "easy" interface functions return a CURLcode error code. No matter what, using the <a class="emphasis" href="./curl_easy_setopt.html">curl_easy_setopt(3)</a> option CURLOPT_ERRORBUFFER 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. <a class="emphasis" href="./curl_easy_strerror.html">curl_easy_strerror(3)</a> can be called to get an error string from a given CURLcode number.

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 are also included. <a name="CURLcode"></a><h2 class="nroffsh">CURLcode</h2>

Almost all "easy" interface functions return a CURLcode error code. No matter what, using the <a class="emphasis" href="./curl_easy_setopt.html">curl_easy_setopt(3)</a> option CURLOPT_ERRORBUFFER is a good idea as it will give you a human readable error string that may offer more details about the cause of the error than just the error code. <a class="emphasis" href="./curl_easy_strerror.html">curl_easy_strerror(3)</a> can be called to get an error string from a given CURLcode number.

CURLcode is one of the following:

<a name="CURLEOK"></a>CURLE_OK (0)

All fine. Proceed as usual.

<a name="CURLECOULDNTCONNECT"></a>CURLE_COULDNT_CONNECT (7)

Failed to connect() to host or proxy.

<a name="CURLEFTPWEIRDSERVERREPLY"></a>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 got a strange or bad reply. The given remote server is probably not an OK FTP server.

After connecting to a FTP server, libcurl expects to get a certain reply back. This error code implies that it got a strange or bad reply. The given remote server is probably not an OK FTP server.

<a name="CURLEREMOTEACCESSDENIED"></a>CURLE_REMOTE_ACCESS_DENIED (9)

We were denied access to the resource given in the URL. For FTP, this occurs while trying to change to the remote directory.

<a name="CURLEFTPWEIRDPASSREPLY"></a>CURLE_FTP_WEIRD_PASS_REPLY (11)

<a name="CURLEFTPCANTGETHOST"></a>CURLE_FTP_CANT_GET_HOST (15)

An internal failure to lookup the host used for the new connection.

<a name="CURLEFTPCOULDNTSETTYPE"></a>CURLE_FTP_COULDNT_SET_TYPE (17)

Received an error when trying to set the transfer mode to binary or ascii.

Received an error when trying to set the transfer mode to binary or ASCII.

<a name="CURLEPARTIALFILE"></a>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.

<a name="CURLEFTPCOULDNTRETRFILE"></a>CURLE_FTP_COULDNT_RETR_FILE (19)

<a name="CURLEWRITEERROR"></a>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.

<a name="CURLEUPLOADFAILED"></a>CURLE_UPLOAD_FAILED (25)

Failed starting the upload. For FTP, the server typically denied the STOR command. The error buffer usually contains the server's explanation to this. (This error code was formerly known as CURLE_FTP_COULDNT_STOR_FILE.)

Failed starting the upload. For FTP, the server typically denied the STOR command. The error buffer usually contains the server's explanation for this. (This error code was formerly known as CURLE_FTP_COULDNT_STOR_FILE.)

<a name="CURLEREADERROR"></a>CURLE_READ_ERROR (26)

There was a problem reading a local file or an error returned by the read callback.

<a name="CURLEOUTOFMEMORY"></a>CURLE_OUT_OF_MEMORY (27)

A memory allocation request failed. This is serious badness and things are severely screwed up if this ever occur.

A memory allocation request failed. This is serious badness and things are severely screwed up if this ever occurs.

<a name="CURLEOPERATIONTIMEDOUT"></a>CURLE_OPERATION_TIMEDOUT (28)

Operation timeout. The specified time-out period was reached according to the conditions.

<a name="CURLEFTPPORTFAILED"></a>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 CURLOPT_FTPPORT.

The FTP PORT command returned error. This mostly happens when you haven't specified a good enough address for libcurl to use. See CURLOPT_FTPPORT.

<a name="CURLEFTPCOULDNTUSEREST"></a>CURLE_FTP_COULDNT_USE_REST (31)

100

The FTP REST command returned error. This should never happen if the server is sane.

101

<a name="CURLERANGEERROR"></a>CURLE_RANGE_ERROR (33)

139

<a name="CURLERECVERROR"></a>CURLE_RECV_ERROR (56)

140

Failure with receiving network data.

141

<a name="CURLESSLCERTPROBLEM"></a>CURLE_SSL_CERTPROBLEM (58)

142

problem with the local client certificate

142

problem with the local client certificate.

143

<a name="CURLESSLCIPHER"></a>CURLE_SSL_CIPHER (59)

144

Couldn't use specified cipher

144

Couldn't use specified cipher.

145

<a name="CURLESSLCACERT"></a>CURLE_SSL_CACERT (60)

146

Peer certificate cannot be authenticated with known CA certificates

146

Peer certificate cannot be authenticated with known CA certificates.

147

<a name="CURLEBADCONTENTENCODING"></a>CURLE_BAD_CONTENT_ENCODING (61)

148

Unrecognized transfer encoding

148

Unrecognized transfer encoding.

149

<a name="CURLELDAPINVALIDURL"></a>CURLE_LDAP_INVALID_URL (62)

150

Invalid LDAP URL

150

Invalid LDAP URL.

151

<a name="CURLEFILESIZEEXCEEDED"></a>CURLE_FILESIZE_EXCEEDED (63)

152

Maximum file size exceeded

152

Maximum file size exceeded.

153

<a name="CURLEUSESSLFAILED"></a>CURLE_USE_SSL_FAILED (64)

154

Requested FTP SSL level failed

154

Requested FTP SSL level failed.

155

<a name="CURLESENDFAILREWIND"></a>CURLE_SEND_FAIL_REWIND (65)

156

When doing a send operation curl had to rewind the data to retransmit, but the rewinding operation failed

156

When doing a send operation curl had to rewind the data to retransmit, but the rewinding operation failed.

157

<a name="CURLESSLENGINEINITFAILED"></a>CURLE_SSL_ENGINE_INITFAILED (66)

158

Initiating the SSL Engine failed

158

Initiating the SSL Engine failed.

159

<a name="CURLELOGINDENIED"></a>CURLE_LOGIN_DENIED (67)

160

The remote server denied curl to login (Added in 7.13.1)

161

<a name="CURLETFTPNOTFOUND"></a>CURLE_TFTP_NOTFOUND (68)

162

File not found on TFTP server

162

File not found on TFTP server.

163

<a name="CURLETFTPPERM"></a>CURLE_TFTP_PERM (69)

164

Permission problem on TFTP server

164

Permission problem on TFTP server.

165

<a name="CURLEREMOTEDISKFULL"></a>CURLE_REMOTE_DISK_FULL (70)

166

Out of disk space on the server

166

Out of disk space on the server.

167

<a name="CURLETFTPILLEGAL"></a>CURLE_TFTP_ILLEGAL (71)

168

Illegal TFTP operation

168

Illegal TFTP operation.

169

<a name="CURLETFTPUNKNOWNID"></a>CURLE_TFTP_UNKNOWNID (72)

170

Unknown TFTP transfer ID

170

Unknown TFTP transfer ID.

171

<a name="CURLEREMOTEFILEEXISTS"></a>CURLE_REMOTE_FILE_EXISTS (73)

172

File already exists and will not be overwritten

172

File already exists and will not be overwritten.

173

<a name="CURLETFTPNOSUCHUSER"></a>CURLE_TFTP_NOSUCHUSER (74)

174

This error should never be returned by a properly functioning TFTP server

174

This error should never be returned by a properly functioning TFTP server.

175

<a name="CURLECONVFAILED"></a>CURLE_CONV_FAILED (75)

176

Character conversion failed

176

Character conversion failed.

177

<a name="CURLECONVREQD"></a>CURLE_CONV_REQD (76)

178

Caller must register conversion callbacks

178

Caller must register conversion callbacks.

179

<a name="CURLESSLCACERTBADFILE"></a>CURLE_SSL_CACERT_BADFILE (77)

180

Problem with reading the SSL CA cert (path? access rights?)

181

<a name="CURLEREMOTEFILENOTFOUND"></a>CURLE_REMOTE_FILE_NOT_FOUND (78)

182

The resource referenced in the URL does not exist

182

The resource referenced in the URL does not exist.

183

<a name="CURLESSH"></a>CURLE_SSH (79)

184

An unspecified error occurred during the SSH session

184

An unspecified error occurred during the SSH session.

185

<a name="CURLESSLSHUTDOWNFAILED"></a>CURLE_SSL_SHUTDOWN_FAILED (80)

186

Failed to shut down the SSL connection

186

Failed to shut down the SSL connection.

187

<a name="CURLEAGAIN"></a>CURLE_AGAIN (81)

188

Socket is not ready for send/recv wait till it's ready and try again. This return code is only returned from <a class="emphasis" href="./curl_easy_recv.html">curl_easy_recv(3)</a> and <a class="emphasis" href="./curl_easy_send.html">curl_easy_send(3)</a> (Added in 7.18.2)

189

<a name="CURLESSLCRLBADFILE"></a>CURLE_SSL_CRL_BADFILE (82)

190

Failed to load CRL file (Added in 7.19.0)

191

<a name="CURLESSLISSUERERROR"></a>CURLE_SSL_ISSUER_ERROR (83)

192

Issuer check failed (Added in 7.19.0)

189

193

<a name="CURLEOBSOLETE"></a>CURLE_OBSOLETE*

190

These error codes will never be returned. They used to be used in an old libcurl version and are currently unused. <a name="CURLMcode"></a><h2 class="nroffsh">CURLMcode</h2>

194

These error codes will never be returned. They were used in an old libcurl version and are currently unused. <a name="CURLMcode"></a><h2 class="nroffsh">CURLMcode</h2>

191

195

This is the generic return code used by functions in the libcurl multi interface. Also consider <a class="emphasis" href="./curl_multi_strerror.html">curl_multi_strerror(3)</a>.

192

196

<a name="CURLMCALLMULTIPERFORM"></a>CURLM_CALL_MULTI_PERFORM (-1)

193

197

This is not really an error. It means you should call <a class="emphasis" href="./curl_multi_perform.html">curl_multi_perform(3)</a> again without doing select() or similar in between.

Older »