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