xref: /curl/docs/cmdline-opts/_OPTIONS.md (revision 3040971d)
1<!-- Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. -->
2<!-- SPDX-License-Identifier: curl -->
3# OPTIONS
4
5Options start with one or two dashes. Many of the options require an
6additional value next to them. If provided text does not start with a dash, it
7is presumed to be and treated as a URL.
8
9The short "single-dash" form of the options, -d for example, may be used with
10or without a space between it and its value, although a space is a recommended
11separator. The long double-dash form, --data for example, requires a space
12between it and its value.
13
14Short version options that do not need any additional values can be used
15immediately next to each other, like for example you can specify all the
16options *-O*, *-L* and *-v* at once as *-OLv*.
17
18In general, all boolean options are enabled with --**option** and yet again
19disabled with --**no-**option. That is, you use the same option name but
20prefix it with `no-`. However, in this list we mostly only list and show the
21--**option** version of them.
22
23When --next is used, it resets the parser state and you start again with a
24clean option state, except for the options that are global. Global options
25retain their values and meaning even after --next.
26
27The following options are global: `%GLOBALS`.
28
29# ALL OPTIONS
30