Return to page-footer CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / curl / docs / cmdline-opts

curl

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