lh | 9ed821d | 2023-04-07 01:36:19 -0700 | [diff] [blame] | 1 | .SH FILES |
| 2 | .I ~/.curlrc |
| 3 | .RS |
| 4 | Default config file, see --config for details. |
| 5 | .SH ENVIRONMENT |
| 6 | The environment variables can be specified in lower case or upper case. The |
| 7 | lower case version has precedence. http_proxy is an exception as it is only |
| 8 | available in lower case. |
| 9 | |
| 10 | Using an environment variable to set the proxy has the same effect as using |
| 11 | the --proxy option. |
| 12 | |
| 13 | .IP "http_proxy [protocol://]<host>[:port]" |
| 14 | Sets the proxy server to use for HTTP. |
| 15 | .IP "HTTPS_PROXY [protocol://]<host>[:port]" |
| 16 | Sets the proxy server to use for HTTPS. |
| 17 | .IP "[url-protocol]_PROXY [protocol://]<host>[:port]" |
| 18 | Sets the proxy server to use for [url-protocol], where the protocol is a |
| 19 | protocol that curl supports and as specified in a URL. FTP, FTPS, POP3, IMAP, |
| 20 | SMTP, LDAP etc. |
| 21 | .IP "ALL_PROXY [protocol://]<host>[:port]" |
| 22 | Sets the proxy server to use if no protocol-specific proxy is set. |
| 23 | .IP "NO_PROXY <comma-separated list of hosts>" |
| 24 | list of host names that shouldn't go through any proxy. If set to a asterisk |
| 25 | \&'*' only, it matches all hosts. |
| 26 | |
| 27 | Since 7.53.0, this environment variable disable the proxy even if specify |
| 28 | --proxy option. That is |
| 29 | .B NO_PROXY=direct.example.com curl -x http://proxy.example.com |
| 30 | .B http://direct.example.com |
| 31 | accesses the target URL directly, and |
| 32 | .B NO_PROXY=direct.example.com curl -x http://proxy.example.com |
| 33 | .B http://somewhere.example.com |
| 34 | accesses the target URL through proxy. |
| 35 | |
| 36 | .SH "PROXY PROTOCOL PREFIXES" |
| 37 | Since curl version 7.21.7, the proxy string may be specified with a |
| 38 | protocol:// prefix to specify alternative proxy protocols. |
| 39 | |
| 40 | If no protocol is specified in the proxy string or if the string doesn't match |
| 41 | a supported one, the proxy will be treated as an HTTP proxy. |
| 42 | |
| 43 | The supported proxy protocol prefixes are as follows: |
| 44 | .IP "socks4://" |
| 45 | Makes it the equivalent of --socks4 |
| 46 | .IP "socks4a://" |
| 47 | Makes it the equivalent of --socks4a |
| 48 | .IP "socks5://" |
| 49 | Makes it the equivalent of --socks5 |
| 50 | .IP "socks5h://" |
| 51 | Makes it the equivalent of --socks5-hostname |
| 52 | .SH EXIT CODES |
| 53 | There are a bunch of different error codes and their corresponding error |
| 54 | messages that may appear during bad conditions. At the time of this writing, |
| 55 | the exit codes are: |
| 56 | .IP 1 |
| 57 | Unsupported protocol. This build of curl has no support for this protocol. |
| 58 | .IP 2 |
| 59 | Failed to initialize. |
| 60 | .IP 3 |
| 61 | URL malformed. The syntax was not correct. |
| 62 | .IP 4 |
| 63 | A feature or option that was needed to perform the desired request was not |
| 64 | enabled or was explicitly disabled at build-time. To make curl able to do |
| 65 | this, you probably need another build of libcurl! |
| 66 | .IP 5 |
| 67 | Couldn't resolve proxy. The given proxy host could not be resolved. |
| 68 | .IP 6 |
| 69 | Couldn't resolve host. The given remote host was not resolved. |
| 70 | .IP 7 |
| 71 | Failed to connect to host. |
| 72 | .IP 8 |
| 73 | Weird server reply. The server sent data curl couldn't parse. |
| 74 | .IP 9 |
| 75 | FTP access denied. The server denied login or denied access to the particular |
| 76 | resource or directory you wanted to reach. Most often you tried to change to a |
| 77 | directory that doesn't exist on the server. |
| 78 | .IP 10 |
| 79 | FTP accept failed. While waiting for the server to connect back when an active |
| 80 | FTP session is used, an error code was sent over the control connection or |
| 81 | similar. |
| 82 | .IP 11 |
| 83 | FTP weird PASS reply. Curl couldn't parse the reply sent to the PASS request. |
| 84 | .IP 12 |
| 85 | During an active FTP session while waiting for the server to connect back to |
| 86 | curl, the timeout expired. |
| 87 | .IP 13 |
| 88 | FTP weird PASV reply, Curl couldn't parse the reply sent to the PASV request. |
| 89 | .IP 14 |
| 90 | FTP weird 227 format. Curl couldn't parse the 227-line the server sent. |
| 91 | .IP 15 |
| 92 | FTP can't get host. Couldn't resolve the host IP we got in the 227-line. |
| 93 | .IP 16 |
| 94 | HTTP/2 error. A problem was detected in the HTTP2 framing layer. This is |
| 95 | somewhat generic and can be one out of several problems, see the error message |
| 96 | for details. |
| 97 | .IP 17 |
| 98 | FTP couldn't set binary. Couldn't change transfer method to binary. |
| 99 | .IP 18 |
| 100 | Partial file. Only a part of the file was transferred. |
| 101 | .IP 19 |
| 102 | FTP couldn't download/access the given file, the RETR (or similar) command |
| 103 | failed. |
| 104 | .IP 21 |
| 105 | FTP quote error. A quote command returned error from the server. |
| 106 | .IP 22 |
| 107 | HTTP page not retrieved. The requested url was not found or returned another |
| 108 | error with the HTTP error code being 400 or above. This return code only |
| 109 | appears if --fail is used. |
| 110 | .IP 23 |
| 111 | Write error. Curl couldn't write data to a local filesystem or similar. |
| 112 | .IP 25 |
| 113 | FTP couldn't STOR file. The server denied the STOR operation, used for FTP |
| 114 | uploading. |
| 115 | .IP 26 |
| 116 | Read error. Various reading problems. |
| 117 | .IP 27 |
| 118 | Out of memory. A memory allocation request failed. |
| 119 | .IP 28 |
| 120 | Operation timeout. The specified time-out period was reached according to the |
| 121 | conditions. |
| 122 | .IP 30 |
| 123 | FTP PORT failed. The PORT command failed. Not all FTP servers support the PORT |
| 124 | command, try doing a transfer using PASV instead! |
| 125 | .IP 31 |
| 126 | FTP couldn't use REST. The REST command failed. This command is used for |
| 127 | resumed FTP transfers. |
| 128 | .IP 33 |
| 129 | HTTP range error. The range "command" didn't work. |
| 130 | .IP 34 |
| 131 | HTTP post error. Internal post-request generation error. |
| 132 | .IP 35 |
| 133 | SSL connect error. The SSL handshaking failed. |
| 134 | .IP 36 |
| 135 | Bad download resume. Couldn't continue an earlier aborted download. |
| 136 | .IP 37 |
| 137 | FILE couldn't read file. Failed to open the file. Permissions? |
| 138 | .IP 38 |
| 139 | LDAP cannot bind. LDAP bind operation failed. |
| 140 | .IP 39 |
| 141 | LDAP search failed. |
| 142 | .IP 41 |
| 143 | Function not found. A required LDAP function was not found. |
| 144 | .IP 42 |
| 145 | Aborted by callback. An application told curl to abort the operation. |
| 146 | .IP 43 |
| 147 | Internal error. A function was called with a bad parameter. |
| 148 | .IP 45 |
| 149 | Interface error. A specified outgoing interface could not be used. |
| 150 | .IP 47 |
| 151 | Too many redirects. When following redirects, curl hit the maximum amount. |
| 152 | .IP 48 |
| 153 | Unknown option specified to libcurl. This indicates that you passed a weird |
| 154 | option to curl that was passed on to libcurl and rejected. Read up in the |
| 155 | manual! |
| 156 | .IP 49 |
| 157 | Malformed telnet option. |
| 158 | .IP 51 |
| 159 | The peer's SSL certificate or SSH MD5 fingerprint was not OK. |
| 160 | .IP 52 |
| 161 | The server didn't reply anything, which here is considered an error. |
| 162 | .IP 53 |
| 163 | SSL crypto engine not found. |
| 164 | .IP 54 |
| 165 | Cannot set SSL crypto engine as default. |
| 166 | .IP 55 |
| 167 | Failed sending network data. |
| 168 | .IP 56 |
| 169 | Failure in receiving network data. |
| 170 | .IP 58 |
| 171 | Problem with the local certificate. |
| 172 | .IP 59 |
| 173 | Couldn't use specified SSL cipher. |
| 174 | .IP 60 |
| 175 | Peer certificate cannot be authenticated with known CA certificates. |
| 176 | .IP 61 |
| 177 | Unrecognized transfer encoding. |
| 178 | .IP 62 |
| 179 | Invalid LDAP URL. |
| 180 | .IP 63 |
| 181 | Maximum file size exceeded. |
| 182 | .IP 64 |
| 183 | Requested FTP SSL level failed. |
| 184 | .IP 65 |
| 185 | Sending the data requires a rewind that failed. |
| 186 | .IP 66 |
| 187 | Failed to initialise SSL Engine. |
| 188 | .IP 67 |
| 189 | The user name, password, or similar was not accepted and curl failed to log in. |
| 190 | .IP 68 |
| 191 | File not found on TFTP server. |
| 192 | .IP 69 |
| 193 | Permission problem on TFTP server. |
| 194 | .IP 70 |
| 195 | Out of disk space on TFTP server. |
| 196 | .IP 71 |
| 197 | Illegal TFTP operation. |
| 198 | .IP 72 |
| 199 | Unknown TFTP transfer ID. |
| 200 | .IP 73 |
| 201 | File already exists (TFTP). |
| 202 | .IP 74 |
| 203 | No such user (TFTP). |
| 204 | .IP 75 |
| 205 | Character conversion failed. |
| 206 | .IP 76 |
| 207 | Character conversion functions required. |
| 208 | .IP 77 |
| 209 | Problem with reading the SSL CA cert (path? access rights?). |
| 210 | .IP 78 |
| 211 | The resource referenced in the URL does not exist. |
| 212 | .IP 79 |
| 213 | An unspecified error occurred during the SSH session. |
| 214 | .IP 80 |
| 215 | Failed to shut down the SSL connection. |
| 216 | .IP 82 |
| 217 | Could not load CRL file, missing or wrong format (added in 7.19.0). |
| 218 | .IP 83 |
| 219 | Issuer check failed (added in 7.19.0). |
| 220 | .IP 84 |
| 221 | The FTP PRET command failed |
| 222 | .IP 85 |
| 223 | RTSP: mismatch of CSeq numbers |
| 224 | .IP 86 |
| 225 | RTSP: mismatch of Session Identifiers |
| 226 | .IP 87 |
| 227 | unable to parse FTP file list |
| 228 | .IP 88 |
| 229 | FTP chunk callback reported error |
| 230 | .IP 89 |
| 231 | No connection available, the session will be queued |
| 232 | .IP 90 |
| 233 | SSL public key does not matched pinned public key |
| 234 | .IP XX |
| 235 | More error codes will appear here in future releases. The existing ones |
| 236 | are meant to never change. |
| 237 | .SH AUTHORS / CONTRIBUTORS |
| 238 | Daniel Stenberg is the main author, but the whole list of contributors is |
| 239 | found in the separate THANKS file. |
| 240 | .SH WWW |
| 241 | https://curl.haxx.se |
| 242 | .SH "SEE ALSO" |
| 243 | .BR ftp (1), |
| 244 | .BR wget (1) |