Return to request.d CVS log

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

Annotation of embedaddon/curl/docs/cmdline-opts/request.d, revision 1.1

1.1     ! misho       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.