xref: /aosp_15_r20/external/curl/docs/cmdline-opts/_OPTIONS.md (revision 6236dae45794135f37c4eb022389c904c8b0090d)
1*6236dae4SAndroid Build Coastguard Worker<!-- Copyright (C) Daniel Stenberg, <[email protected]>, et al. -->
2*6236dae4SAndroid Build Coastguard Worker<!-- SPDX-License-Identifier: curl -->
3*6236dae4SAndroid Build Coastguard Worker# OPTIONS
4*6236dae4SAndroid Build Coastguard Worker
5*6236dae4SAndroid Build Coastguard WorkerOptions start with one or two dashes. Many of the options require an
6*6236dae4SAndroid Build Coastguard Workeradditional value next to them. If provided text does not start with a dash, it
7*6236dae4SAndroid Build Coastguard Workeris presumed to be and treated as a URL.
8*6236dae4SAndroid Build Coastguard Worker
9*6236dae4SAndroid Build Coastguard WorkerThe short "single-dash" form of the options, -d for example, may be used with
10*6236dae4SAndroid Build Coastguard Workeror without a space between it and its value, although a space is a recommended
11*6236dae4SAndroid Build Coastguard Workerseparator. The long double-dash form, --data for example, requires a space
12*6236dae4SAndroid Build Coastguard Workerbetween it and its value.
13*6236dae4SAndroid Build Coastguard Worker
14*6236dae4SAndroid Build Coastguard WorkerShort version options that do not need any additional values can be used
15*6236dae4SAndroid Build Coastguard Workerimmediately next to each other, like for example you can specify all the
16*6236dae4SAndroid Build Coastguard Workeroptions *-O*, *-L* and *-v* at once as *-OLv*.
17*6236dae4SAndroid Build Coastguard Worker
18*6236dae4SAndroid Build Coastguard WorkerIn general, all boolean options are enabled with --**option** and yet again
19*6236dae4SAndroid Build Coastguard Workerdisabled with --**no-**option. That is, you use the same option name but
20*6236dae4SAndroid Build Coastguard Workerprefix it with `no-`. However, in this list we mostly only list and show the
21*6236dae4SAndroid Build Coastguard Worker--**option** version of them.
22*6236dae4SAndroid Build Coastguard Worker
23*6236dae4SAndroid Build Coastguard WorkerWhen --next is used, it resets the parser state and you start again with a
24*6236dae4SAndroid Build Coastguard Workerclean option state, except for the options that are global. Global options
25*6236dae4SAndroid Build Coastguard Workerretain their values and meaning even after --next.
26*6236dae4SAndroid Build Coastguard Worker
27*6236dae4SAndroid Build Coastguard WorkerThe following options are global: `%GLOBALS`.
28*6236dae4SAndroid Build Coastguard Worker
29*6236dae4SAndroid Build Coastguard Worker# ALL OPTIONS
30