e7219c2bdc
Use imperative mood consistently for the first sentence describing an option. "Set this" instead "tell curl to set" or "this sets..." Plus some extra cleanups and rephrasing. Closes #13106
1.4 KiB
| c | SPDX-License-Identifier | Long | Short | Protocols | Help | Category | Added | Multi | See-also | Example | ||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. | curl | remote-header-name | J | HTTP | Use the header-provided filename | output | 7.20.0 | boolean |
|
|
--remote-header-name
Tell the --remote-name option to use the server-specified Content-Disposition filename instead of extracting a filename from the URL. If the server-provided filename contains a path, that is stripped off before the filename is used.
The file is saved in the current directory, or in the directory specified with --output-dir.
If the server specifies a filename and a file with that name already exists in the destination directory, it is not overwritten and an error occurs - unless you allow it by using the --clobber option. If the server does not specify a filename then this option has no effect.
There is no attempt to decode %-sequences (yet) in the provided filename, so this option may provide you with rather unexpected filenames.
This feature uses the name from the filename field, it does not yet support
the filename* field (filenames with explicit character sets).
WARNING: Exercise judicious use of this option, especially on Windows. A rogue server could send you the name of a DLL or other file that could be loaded automatically by Windows or some third party software.