constants_curl_error.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: fab7349d08516e730f5c7a82f35cc64c1e797e1a Maintainer: mumumu Status: working -->
<variablelist xml:id="constant.curl-error.constants" role="constant_list">
 <title>cURL error constants</title>
 <varlistentry xml:id="constant.curle-aborted-by-callback">
  <term>
   <constant>CURLE_ABORTED_BY_CALLBACK</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    Aborted by callback. A callback returned "abort" to libcurl.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-bad-calling-order">
  <term>
   <constant>CURLE_BAD_CALLING_ORDER</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-bad-content-encoding">
  <term>
   <constant>CURLE_BAD_CONTENT_ENCODING</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    Unrecognized transfer encoding.
   </simpara>
  </listitem>
 </varlistentry>
  <varlistentry xml:id="constant.curle-bad-download-resume">
  <term>
   <constant>CURLE_BAD_DOWNLOAD_RESUME</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    The download could not be resumed because the specified offset was out of the file boundary.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-bad-function-argument">
  <term>
   <constant>CURLE_BAD_FUNCTION_ARGUMENT</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    A function was called with a bad parameter.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-bad-password-entered">
  <term>
   <constant>CURLE_BAD_PASSWORD_ENTERED</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-couldnt-connect">
  <term>
   <constant>CURLE_COULDNT_CONNECT</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    Failed to connect to host or proxy.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-couldnt-resolve-host">
  <term>
   <constant>CURLE_COULDNT_RESOLVE_HOST</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    Could not resolve host. The given remote host was not resolved.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-couldnt-resolve-proxy">
  <term>
   <constant>CURLE_COULDNT_RESOLVE_PROXY</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    Could not resolve proxy. The given proxy host could not be resolved.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-failed-init">
  <term>
   <constant>CURLE_FAILED_INIT</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    Early initialization code failed.
    This is likely to be an internal error or problem,
    or a resource problem where something fundamental could not get done at init time.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-filesize-exceeded">
  <term>
   <constant>CURLE_FILESIZE_EXCEEDED</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    Maximum file size exceeded.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-file-couldnt-read-file">
  <term>
   <constant>CURLE_FILE_COULDNT_READ_FILE</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    A file given with FILE:// could not be opened.
    Most likely because the file path does not identify an existing file
    or due to the lack of appropriate file permissions.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ftp-access-denied">
  <term>
   <constant>CURLE_FTP_ACCESS_DENIED</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ftp-bad-download-resume">
  <term>
   <constant>CURLE_FTP_BAD_DOWNLOAD_RESUME</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ftp-cant-get-host">
  <term>
   <constant>CURLE_FTP_CANT_GET_HOST</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    An internal failure to lookup the host used for the new connection.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ftp-cant-reconnect">
  <term>
   <constant>CURLE_FTP_CANT_RECONNECT</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ftp-couldnt-get-size">
  <term>
   <constant>CURLE_FTP_COULDNT_GET_SIZE</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ftp-couldnt-retr-file">
  <term>
   <constant>CURLE_FTP_COULDNT_RETR_FILE</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    This was either a unexpected reply to a 'RETR' command
    or a zero byte transfer complete.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ftp-couldnt-set-ascii">
  <term>
   <constant>CURLE_FTP_COULDNT_SET_ASCII</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ftp-couldnt-set-binary">
  <term>
   <constant>CURLE_FTP_COULDNT_SET_BINARY</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ftp-couldnt-stor-file">
  <term>
   <constant>CURLE_FTP_COULDNT_STOR_FILE</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ftp-couldnt-use-rest">
  <term>
   <constant>CURLE_FTP_COULDNT_USE_REST</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    The FTP REST command returned error.
    This should never happen if the server is sane.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ftp-partial-file">
  <term>
   <constant>CURLE_FTP_PARTIAL_FILE</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ftp-port-failed">
  <term>
   <constant>CURLE_FTP_PORT_FAILED</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    The FTP PORT command returned error.
    This mostly happens when a good enough address has not been specified for libcurl to use.
    See <constant>CURLOPT_FTPPORT</constant>.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ftp-quote-error">
  <term>
   <constant>CURLE_FTP_QUOTE_ERROR</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ftp-ssl-failed">
  <term>
   <constant>CURLE_FTP_SSL_FAILED</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ftp-user-password-incorrect">
  <term>
   <constant>CURLE_FTP_USER_PASSWORD_INCORRECT</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ftp-weird-227-format">
  <term>
   <constant>CURLE_FTP_WEIRD_227_FORMAT</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    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.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ftp-weird-pass-reply">
  <term>
   <constant>CURLE_FTP_WEIRD_PASS_REPLY</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    After having sent the FTP password to the server, libcurl expects a proper reply.
    This error code indicates that an unexpected code was returned.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ftp-weird-pasv-reply">
  <term>
   <constant>CURLE_FTP_WEIRD_PASV_REPLY</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    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.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ftp-weird-server-reply">
  <term>
   <constant>CURLE_FTP_WEIRD_SERVER_REPLY</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    The server sent data libcurl could not parse.
    This error code is known as <constant>CURLE_WEIRD_SERVER_REPLY</constant>
    as of cURL 7.51.0.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ftp-weird-user-reply">
  <term>
   <constant>CURLE_FTP_WEIRD_USER_REPLY</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ftp-write-error">
  <term>
   <constant>CURLE_FTP_WRITE_ERROR</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-function-not-found">
  <term>
   <constant>CURLE_FUNCTION_NOT_FOUND</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    Function not found. A required zlib function was not found.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-got-nothing">
  <term>
   <constant>CURLE_GOT_NOTHING</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    Nothing was returned from the server, and under the circumstances,
    getting nothing is considered an error.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-http-not-found">
  <term>
   <constant>CURLE_HTTP_NOT_FOUND</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-http-port-failed">
  <term>
   <constant>CURLE_HTTP_PORT_FAILED</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-http-post-error">
  <term>
   <constant>CURLE_HTTP_POST_ERROR</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    This is an odd error that mainly occurs due to internal confusion.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-http-range-error">
  <term>
   <constant>CURLE_HTTP_RANGE_ERROR</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-http-returned-error">
  <term>
   <constant>CURLE_HTTP_RETURNED_ERROR</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    This is returned if <constant>CURLOPT_FAILONERROR</constant> is set &true;
    and the HTTP server returns an error code that is greater than or equal to 400.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ldap-cannot-bind">
  <term>
   <constant>CURLE_LDAP_CANNOT_BIND</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    LDAP cannot bind. LDAP bind operation failed.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ldap-invalid-url">
  <term>
   <constant>CURLE_LDAP_INVALID_URL</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ldap-search-failed">
  <term>
   <constant>CURLE_LDAP_SEARCH_FAILED</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    LDAP search failed.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-library-not-found">
  <term>
   <constant>CURLE_LIBRARY_NOT_FOUND</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-malformat-user">
  <term>
   <constant>CURLE_MALFORMAT_USER</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-obsolete">
  <term>
   <constant>CURLE_OBSOLETE</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ok">
  <term>
   <constant>CURLE_OK</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    All fine. Proceed as usual.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-operation-timedout">
  <term>
   <constant>CURLE_OPERATION_TIMEDOUT</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    Operation timeout.
    The specified time-out period was reached according to the conditions.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-operation-timeouted">
  <term>
   <constant>CURLE_OPERATION_TIMEOUTED</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-out-of-memory">
  <term>
   <constant>CURLE_OUT_OF_MEMORY</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    A memory allocation request failed.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-partial-file">
  <term>
   <constant>CURLE_PARTIAL_FILE</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    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 does not match the previously given size.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-proxy">
  <term>
   <constant>CURLE_PROXY</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    Proxy handshake error.
    <constant>CURLINFO_PROXY_ERROR</constant> provides extra details on the specific problem.
    Available as of PHP 8.2.0 and cURL 7.73.0
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-read-error">
  <term>
   <constant>CURLE_READ_ERROR</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    There was a problem reading a local file or an error returned by the read callback.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-recv-error">
  <term>
   <constant>CURLE_RECV_ERROR</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    Failure with receiving network data.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-send-error">
  <term>
   <constant>CURLE_SEND_ERROR</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    Failed sending network data.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-share-in-use">
  <term>
   <constant>CURLE_SHARE_IN_USE</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ssh">
  <term>
   <constant>CURLE_SSH</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    An unspecified error occurred during the SSH session.
    Available as of cURL 7.16.1.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ssl-cacert">
  <term>
   <constant>CURLE_SSL_CACERT</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ssl-cacert-badfile">
  <term>
   <constant>CURLE_SSL_CACERT_BADFILE</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    Problem with reading the SSL CA cert.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ssl-certproblem">
  <term>
   <constant>CURLE_SSL_CERTPROBLEM</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    Problem with the local client certificate.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ssl-cipher">
  <term>
   <constant>CURLE_SSL_CIPHER</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    Could not use specified cipher.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ssl-connect-error">
  <term>
   <constant>CURLE_SSL_CONNECT_ERROR</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    A problem occurred somewhere in the SSL/TLS handshake.
    Reading the message in the error buffer provides more details on the problem.
    Could be certificates (file formats, paths, permissions), passwords, and others.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ssl-engine-notfound">
  <term>
   <constant>CURLE_SSL_ENGINE_NOTFOUND</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    The specified crypto engine was not found.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ssl-engine-setfailed">
  <term>
   <constant>CURLE_SSL_ENGINE_SETFAILED</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    Failed setting the selected SSL crypto engine as default.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ssl-peer-certificate">
  <term>
   <constant>CURLE_SSL_PEER_CERTIFICATE</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-ssl-pinnedpubkeynotmatch">
  <term>
   <constant>CURLE_SSL_PINNEDPUBKEYNOTMATCH</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    Failed to match the pinned key specified with
    <constant>CURLOPT_PINNEDPUBLICKEY</constant>.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-telnet-option-syntax">
  <term>
   <constant>CURLE_TELNET_OPTION_SYNTAX</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-too-many-redirects">
  <term>
   <constant>CURLE_TOO_MANY_REDIRECTS</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    Too many redirects. When following redirects, libcurl hit the maximum amount.
    The limit can be set with <constant>CURLOPT_MAXREDIRS</constant>.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-unknown-telnet-option">
  <term>
   <constant>CURLE_UNKNOWN_TELNET_OPTION</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-unsupported-protocol">
  <term>
   <constant>CURLE_UNSUPPORTED_PROTOCOL</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    The URL passed to libcurl used a protocol that libcurl does not support.
    The issue might be a compile-time option that was not used,
    a misspelled protocol string or just a protocol libcurl has no code for.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-url-malformat">
  <term>
   <constant>CURLE_URL_MALFORMAT</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    The URL was not properly formatted.
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-url-malformat-user">
  <term>
   <constant>CURLE_URL_MALFORMAT_USER</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>

   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-weird-server-reply">
  <term>
   <constant>CURLE_WEIRD_SERVER_REPLY</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    The server sent data libcurl could not parse.
    This error code was known as <constant>CURLE_FTP_WEIRD_SERVER_REPLY</constant>
    before cURL 7.51.0.
    Available as of PHP 7.3.0 and cURL 7.51.0
   </simpara>
  </listitem>
 </varlistentry>
 <varlistentry xml:id="constant.curle-write-error">
  <term>
   <constant>CURLE_WRITE_ERROR</constant>
   (<type>int</type>)
  </term>
  <listitem>
   <simpara>
    An error occurred when writing received data to a local file,
    or an error was returned to libcurl from a write callback.
   </simpara>
  </listitem>
 </varlistentry>
</variablelist>