| 12345678910111213141516171819202122232425262728293031323334 |
- c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
- SPDX-License-Identifier: curl
- Long: remote-header-name
- Short: J
- Protocols: HTTP
- Help: Use the header-provided filename
- Category: output
- Example: -OJ https://example.com/file
- Added: 7.20.0
- See-also: remote-name
- Multi: boolean
- ---
- This option tells the --remote-name option to use the server-specified
- Content-Disposition filename instead of extracting a filename from the URL. If
- the server-provided file name contains a path, that will be stripped off
- before the file name is used.
- The file is saved in the current directory, or in the directory specified with
- --output-dir.
- If the server specifies a file name and a file with that name already exists
- in the destination directory, it will not be overwritten and an error will
- occur - unless you allow it by using the --clobber option. If the server does
- not specify a file name then this option has no effect.
- There's no attempt to decode %-sequences (yet) in the provided file name, so
- this option may provide you with rather unexpected file names.
- 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.
|
