xref: /aosp_15_r20/external/curl/docs/cmdline-opts/user-agent.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 WorkerShort: A
5*6236dae4SAndroid Build Coastguard WorkerLong: user-agent
6*6236dae4SAndroid Build Coastguard WorkerArg: <name>
7*6236dae4SAndroid Build Coastguard WorkerHelp: Send User-Agent <name> to server
8*6236dae4SAndroid Build Coastguard WorkerProtocols: HTTP
9*6236dae4SAndroid Build Coastguard WorkerCategory: important http
10*6236dae4SAndroid Build Coastguard WorkerAdded: 4.5.1
11*6236dae4SAndroid Build Coastguard WorkerMulti: single
12*6236dae4SAndroid Build Coastguard WorkerSee-also:
13*6236dae4SAndroid Build Coastguard Worker  - header
14*6236dae4SAndroid Build Coastguard Worker  - proxy-header
15*6236dae4SAndroid Build Coastguard WorkerExample:
16*6236dae4SAndroid Build Coastguard Worker  - -A "Agent 007" $URL
17*6236dae4SAndroid Build Coastguard Worker---
18*6236dae4SAndroid Build Coastguard Worker
19*6236dae4SAndroid Build Coastguard Worker# `--user-agent`
20*6236dae4SAndroid Build Coastguard Worker
21*6236dae4SAndroid Build Coastguard WorkerSpecify the User-Agent string to send to the HTTP server. To encode blanks in
22*6236dae4SAndroid Build Coastguard Workerthe string, surround the string with single quote marks. This header can also
23*6236dae4SAndroid Build Coastguard Workerbe set with the --header or the --proxy-header options.
24*6236dae4SAndroid Build Coastguard Worker
25*6236dae4SAndroid Build Coastguard WorkerIf you give an empty argument to --user-agent (""), it removes the header
26*6236dae4SAndroid Build Coastguard Workercompletely from the request. If you prefer a blank header, you can set it to a
27*6236dae4SAndroid Build Coastguard Workersingle space (" ").
28