xref: /aosp_15_r20/external/curl/docs/cmdline-opts/no-clobber.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 WorkerLong: no-clobber
5*6236dae4SAndroid Build Coastguard WorkerHelp: Do not overwrite files that already exist
6*6236dae4SAndroid Build Coastguard WorkerCategory: output
7*6236dae4SAndroid Build Coastguard WorkerAdded: 7.83.0
8*6236dae4SAndroid Build Coastguard WorkerMulti: boolean
9*6236dae4SAndroid Build Coastguard WorkerSee-also:
10*6236dae4SAndroid Build Coastguard Worker  - output
11*6236dae4SAndroid Build Coastguard Worker  - remote-name
12*6236dae4SAndroid Build Coastguard WorkerExample:
13*6236dae4SAndroid Build Coastguard Worker  - --no-clobber --output local/dir/file $URL
14*6236dae4SAndroid Build Coastguard Worker---
15*6236dae4SAndroid Build Coastguard Worker
16*6236dae4SAndroid Build Coastguard Worker# `--no-clobber`
17*6236dae4SAndroid Build Coastguard Worker
18*6236dae4SAndroid Build Coastguard WorkerWhen used in conjunction with the --output, --remote-header-name,
19*6236dae4SAndroid Build Coastguard Worker--remote-name, or --remote-name-all options, curl avoids overwriting files
20*6236dae4SAndroid Build Coastguard Workerthat already exist. Instead, a dot and a number gets appended to the name of
21*6236dae4SAndroid Build Coastguard Workerthe file that would be created, up to filename.100 after which it does not
22*6236dae4SAndroid Build Coastguard Workercreate any file.
23*6236dae4SAndroid Build Coastguard Worker
24*6236dae4SAndroid Build Coastguard WorkerNote that this is the negated option name documented. You can thus use
25*6236dae4SAndroid Build Coastguard Worker--clobber to enforce the clobbering, even if --remote-header-name is
26*6236dae4SAndroid Build Coastguard Workerspecified.
27