771b6d46996ddb0b830cc31c7e8678b9be247057
[platform/upstream/curl.git] / docs / cmdline-opts / remote-header-name.d
1 Long: remote-header-name
2 Short: J
3 Protocols: HTTP
4 Help: Use the header-provided filename
5 ---
6 This option tells the --remote-name option to use the server-specified
7 Content-Disposition filename instead of extracting a filename from the URL.
8
9 If the server specifies a file name and a file with that name already exists
10 in the current working directory it will not be overwritten and an error will
11 occur. If the server doesn't specify a file name then this option has no
12 effect.
13
14 There's no attempt to decode %-sequences (yet) in the provided file name, so
15 this option may provide you with rather unexpected file names.
16
17 \fBWARNING\fP: Exercise judicious use of this option, especially on Windows. A
18 rogue server could send you the name of a DLL or other file that could possibly
19 be loaded automatically by Windows or some third party software.