dada880fc5
curl offers a `--user-agent` option for modifying the `User-Agent` header supplied in its requests. The man page section for this option explains how to use the `--user-agent` option, but does not explain which `User-Agent` curl uses by default. By default, curl uses curl/VERSION, such as `User-Agent: curl/8.11.0`. Note that this appears to be different from the libcurl default (no User-Agent header). This commit documents the default `User-Agent` in the man page section for the `--user-agent` option, as well as on the "Art of Scripting" page. The `%VERSION` placeholder will be used to insert the current version as described in the man page generator docs. Closes #15608
30 lines
792 B
Markdown
30 lines
792 B
Markdown
---
|
|
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
SPDX-License-Identifier: curl
|
|
Short: A
|
|
Long: user-agent
|
|
Arg: <name>
|
|
Help: Send User-Agent <name> to server
|
|
Protocols: HTTP
|
|
Category: important http
|
|
Added: 4.5.1
|
|
Multi: single
|
|
See-also:
|
|
- header
|
|
- proxy-header
|
|
Example:
|
|
- -A "Agent 007" $URL
|
|
---
|
|
|
|
# `--user-agent`
|
|
|
|
Specify the User-Agent string to send to the HTTP server. To encode blanks in
|
|
the string, surround the string with single quote marks. This header can also
|
|
be set with the --header or the --proxy-header options.
|
|
|
|
If you give an empty argument to --user-agent (""), it removes the header
|
|
completely from the request. If you prefer a blank header, you can set it to a
|
|
single space (" ").
|
|
|
|
By default, curl uses curl/VERSION, such as User-Agent: curl/`%VERSION`.
|