Return to request.d CVS log

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

curl

    1: Long: request
    2: Short: X
    3: Arg: <command>
    4: Help: Specify request command to use
    5: ---
    6: (HTTP) Specifies a custom request method to use when communicating with the
    7: HTTP server.  The specified request method will be used instead of the method
    8: otherwise used (which defaults to GET). Read the HTTP 1.1 specification for
    9: details and explanations. Common additional HTTP requests include PUT and
   10: DELETE, but related technologies like WebDAV offers PROPFIND, COPY, MOVE and
   11: more.
   12: 
   13: Normally you don't need this option. All sorts of GET, HEAD, POST and PUT
   14: requests are rather invoked by using dedicated command line options.
   15: 
   16: This option only changes the actual word used in the HTTP request, it does not
   17: alter the way curl behaves. So for example if you want to make a proper HEAD
   18: request, using -X HEAD will not suffice. You need to use the --head option.
   19: 
   20: The method string you set with --request will be used for all requests, which
   21: if you for example use --location may cause unintended side-effects when curl
   22: doesn't change request method according to the HTTP 30x response codes - and
   23: similar.
   24: 
   25: (FTP)
   26: Specifies a custom FTP command to use instead of LIST when doing file lists
   27: with FTP.
   28: 
   29: (POP3)
   30: Specifies a custom POP3 command to use instead of LIST or RETR. (Added in
   31: 7.26.0)
   32: 
   33: (IMAP)
   34: Specifies a custom IMAP command to use instead of LIST. (Added in 7.30.0)
   35: 
   36: (SMTP)
   37: Specifies a custom SMTP command to use instead of HELP or VRFY. (Added in 7.34.0)
   38: 
   39: If this option is used several times, the last one will be used.