xref: /aosp_15_r20/external/curl/docs/cmdline-opts/request-target.md (revision 6236dae45794135f37c4eb022389c904c8b0090d)
1*6236dae4SAndroid Build Coastguard Worker---
2*6236dae4SAndroid Build Coastguard Workerc: Copyright (C) Daniel Stenberg, <[email protected]>, et al.
3*6236dae4SAndroid Build Coastguard WorkerSPDX-License-Identifier: curl
4*6236dae4SAndroid Build Coastguard WorkerLong: request-target
5*6236dae4SAndroid Build Coastguard WorkerArg: <path>
6*6236dae4SAndroid Build Coastguard WorkerHelp: Specify the target for this request
7*6236dae4SAndroid Build Coastguard WorkerProtocols: HTTP
8*6236dae4SAndroid Build Coastguard WorkerAdded: 7.55.0
9*6236dae4SAndroid Build Coastguard WorkerCategory: http
10*6236dae4SAndroid Build Coastguard WorkerMulti: single
11*6236dae4SAndroid Build Coastguard WorkerSee-also:
12*6236dae4SAndroid Build Coastguard Worker  - request
13*6236dae4SAndroid Build Coastguard WorkerExample:
14*6236dae4SAndroid Build Coastguard Worker  - --request-target "*" -X OPTIONS $URL
15*6236dae4SAndroid Build Coastguard Worker---
16*6236dae4SAndroid Build Coastguard Worker
17*6236dae4SAndroid Build Coastguard Worker# `--request-target`
18*6236dae4SAndroid Build Coastguard Worker
19*6236dae4SAndroid Build Coastguard WorkerUse an alternative target (path) instead of using the path as provided in the
20*6236dae4SAndroid Build Coastguard WorkerURL. Particularly useful when wanting to issue HTTP requests without leading
21*6236dae4SAndroid Build Coastguard Workerslash or other data that does not follow the regular URL pattern, like
22*6236dae4SAndroid Build Coastguard Worker"OPTIONS *".
23*6236dae4SAndroid Build Coastguard Worker
24*6236dae4SAndroid Build Coastguard Workercurl passes on the verbatim string you give it its the request without any
25*6236dae4SAndroid Build Coastguard Workerfilter or other safe guards. That includes white space and control characters.
26