mirror of
https://github.com/moparisthebest/curl
synced 2025-02-28 09:21:50 -05:00
docs/options-in-versions: which version added each cmdline option
Added test 971 to verify that the list is in sync with the files in cmdline-opts. The check also verifies that .d-files that uses Added: specify the same version number as the options-in-versions file does. Closes #5381
This commit is contained in:
Daniel Stenberg
parent
72b1aaf9da
commit
f3f5d82e28
@ -73,6 +73,7 @@ EXTRA_DIST = \
|
||||
LICENSE-MIXING.md \
|
||||
MAIL-ETIQUETTE \
|
||||
MQTT.md \
|
||||
options-in-versions \
|
||||
PARALLEL-TRANSFERS.md \
|
||||
README.md \
|
||||
RELEASE-PROCEDURE.md \
|
||||
|
||||
244
docs/options-in-versions
Normal file
244
docs/options-in-versions
Normal file
@ -0,0 +1,244 @@
|
||||
_ _ ____ _
|
||||
___| | | | _ \| |
|
||||
/ __| | | | |_) | |
|
||||
| (__| |_| | _ <| |___
|
||||
\___|\___/|_| \_\_____|
|
||||
|
||||
This document lists all command line options present in curl, together with
|
||||
exact information about the first curl version that supports it. The options
|
||||
are sorted alphabetically on the long name.
|
||||
|
||||
Long (short) Introduced
|
||||
|
||||
--abstract-unix-socket 7.53.0
|
||||
--alt-svc 7.64.1
|
||||
--anyauth 7.10.6
|
||||
--append (-a) 4.8
|
||||
--basic 7.10.6
|
||||
--cacert 7.5
|
||||
--capath 7.9.8
|
||||
--cert (-E) 5.0
|
||||
--cert-status 7.41.0
|
||||
--cert-type 7.9.3
|
||||
--ciphers 7.9
|
||||
--compressed 7.10
|
||||
--compressed-ssh 7.56.0
|
||||
--config (-K) 4.10
|
||||
--connect-timeout 7.7
|
||||
--connect-to 7.49.0
|
||||
--continue-at (-C) 4.8
|
||||
--cookie (-b) 4.9
|
||||
--cookie-jar (-c) 7.9
|
||||
--create-dirs 7.10.3
|
||||
--crlf 5.7
|
||||
--crlfile 7.19.7
|
||||
--data (-d) 4.0
|
||||
--data-ascii 7.2
|
||||
--data-binary 7.2
|
||||
--data-raw 7.43.0
|
||||
--data-urlencode 7.18.0
|
||||
--delegation 7.22.0
|
||||
--digest 7.10.6
|
||||
--disable (-q) 5.0
|
||||
--disable-eprt 7.10.5
|
||||
--disable-epsv 7.9.2
|
||||
--disallow-username-in-url 7.61.0
|
||||
--dns-interface 7.33.0
|
||||
--dns-ipv4-addr 7.33.0
|
||||
--dns-ipv6-addr 7.33.0
|
||||
--dns-servers 7.33.0
|
||||
--doh-url 7.62.0
|
||||
--dump-header (-D) 5.7
|
||||
--egd-file 7.7
|
||||
--engine 7.9.3
|
||||
--etag-compare 7.68.0
|
||||
--etag-save 7.68.0
|
||||
--expect100-timeout 7.47.0
|
||||
--fail (-f) 4.0
|
||||
--fail-early 7.52.0
|
||||
--false-start 7.42.0
|
||||
--form (-F) 5.0
|
||||
--form-string 7.13.2
|
||||
--ftp-account 7.13.0
|
||||
--ftp-alternative-to-user 7.15.5
|
||||
--ftp-create-dirs 7.10.7
|
||||
--ftp-method 7.15.1
|
||||
--ftp-pasv 7.11.0
|
||||
--ftp-port (-P) 4.0
|
||||
--ftp-pret 7.20.0
|
||||
--ftp-skip-pasv-ip 7.14.2
|
||||
--ftp-ssl-ccc 7.16.1
|
||||
--ftp-ssl-ccc-mode 7.16.2
|
||||
--ftp-ssl-control 7.16.0
|
||||
--get (-G) 7.8.1
|
||||
--globoff (-g) 7.6
|
||||
--happy-eyeballs-timeout-ms 7.59.0
|
||||
--haproxy-protocol 7.60.0
|
||||
--head (-I) 4.0
|
||||
--header (-H) 5.0
|
||||
--help (-h) 4.0
|
||||
--hostpubmd5 7.17.1
|
||||
--http0.9 7.64.0
|
||||
--http1.0 (-0) 7.9.1
|
||||
--http1.1 7.33.0
|
||||
--http2 7.33.0
|
||||
--http2-prior-knowledge 7.49.0
|
||||
--http3 7.66.0
|
||||
--ignore-content-length 7.14.1
|
||||
--include (-i) 4.8
|
||||
--insecure (-k) 7.10
|
||||
--interface 7.3
|
||||
--ipv4 (-4) 7.10.8
|
||||
--ipv6 (-6) 7.10.8
|
||||
--junk-session-cookies (-j) 7.9.7
|
||||
--keepalive-time 7.18.0
|
||||
--key 7.9.3
|
||||
--key-type 7.9.3
|
||||
--krb 7.3
|
||||
--libcurl 7.16.1
|
||||
--limit-rate 7.10
|
||||
--list-only (-l) 4.0
|
||||
--local-port 7.15.2
|
||||
--location (-L) 4.9
|
||||
--location-trusted 7.10.4
|
||||
--login-options 7.34.0
|
||||
--mail-auth 7.25.0
|
||||
--mail-from 7.20.0
|
||||
--mail-rcpt 7.20.0
|
||||
--mail-rcpt-allowfails 7.69.0
|
||||
--manual (-M) 5.2
|
||||
--max-filesize 7.10.8
|
||||
--max-redirs 7.5
|
||||
--max-time (-m) 4.0
|
||||
--metalink 7.27.0
|
||||
--negotiate 7.10.6
|
||||
--netrc (-n) 4.6
|
||||
--netrc-file 7.21.5
|
||||
--netrc-optional 7.9.8
|
||||
--next (-:) 7.36.0
|
||||
--no-alpn 7.36.0
|
||||
--no-buffer (-N) 6.5
|
||||
--no-keepalive 7.18.0
|
||||
--no-npn 7.36.0
|
||||
--no-progress-meter 7.67.0
|
||||
--no-sessionid 7.16.0
|
||||
--noproxy 7.19.4
|
||||
--ntlm 7.10.6
|
||||
--ntlm-wb 7.22.0
|
||||
--oauth2-bearer 7.33.0
|
||||
--output (-o) 4.0
|
||||
--parallel (-Z) 7.66.0
|
||||
--parallel-immediate 7.68.0
|
||||
--parallel-max 7.66.0
|
||||
--pass 7.9.3
|
||||
--path-as-is 7.42.0
|
||||
--pinnedpubkey 7.39.0
|
||||
--post301 7.17.1
|
||||
--post302 7.19.1
|
||||
--post303 7.26.0
|
||||
--preproxy 7.52.0
|
||||
--progress-bar (-#) 5.10
|
||||
--proto 7.20.2
|
||||
--proto-default 7.45.0
|
||||
--proto-redir 7.20.2
|
||||
--proxy (-x) 4.0
|
||||
--proxy-anyauth 7.13.2
|
||||
--proxy-basic 7.12.0
|
||||
--proxy-cacert 7.52.0
|
||||
--proxy-capath 7.52.0
|
||||
--proxy-cert 7.52.0
|
||||
--proxy-cert-type 7.52.0
|
||||
--proxy-ciphers 7.52.0
|
||||
--proxy-crlfile 7.52.0
|
||||
--proxy-digest 7.12.0
|
||||
--proxy-header 7.37.0
|
||||
--proxy-insecure 7.52.0
|
||||
--proxy-key 7.52.0
|
||||
--proxy-key-type 7.52.0
|
||||
--proxy-negotiate 7.17.1
|
||||
--proxy-ntlm 7.10.7
|
||||
--proxy-pass 7.52.0
|
||||
--proxy-pinnedpubkey 7.59.0
|
||||
--proxy-service-name 7.43.0
|
||||
--proxy-ssl-allow-beast 7.52.0
|
||||
--proxy-tls13-ciphers 7.61.0
|
||||
--proxy-tlsauthtype 7.52.0
|
||||
--proxy-tlspassword 7.52.0
|
||||
--proxy-tlsuser 7.52.0
|
||||
--proxy-tlsv1 7.52.0
|
||||
--proxy-user (-U) 4.0
|
||||
--proxy1.0 7.19.4
|
||||
--proxytunnel (-p) 7.3
|
||||
--pubkey 7.16.2
|
||||
--quote (-Q) 5.3
|
||||
--random-file 7.7
|
||||
--range (-r) 4.0
|
||||
--raw 7.16.2
|
||||
--referer (-e) 4.0
|
||||
--remote-header-name (-J) 7.20.0
|
||||
--remote-name (-O) 4.0
|
||||
--remote-name-all 7.19.0
|
||||
--remote-time (-R) 7.9
|
||||
--request (-X) 6.0
|
||||
--request-target 7.55.0
|
||||
--resolve 7.21.3
|
||||
--retry 7.12.3
|
||||
--retry-all-errors 7.71.0
|
||||
--retry-connrefused 7.52.0
|
||||
--retry-delay 7.12.3
|
||||
--retry-max-time 7.12.3
|
||||
--sasl-authzid 7.66.0
|
||||
--sasl-ir 7.31.0
|
||||
--service-name 7.43.0
|
||||
--show-error (-S) 5.9
|
||||
--silent (-s) 4.0
|
||||
--socks4 7.15.2
|
||||
--socks4a 7.18.0
|
||||
--socks5 7.18.0
|
||||
--socks5-basic 7.55.0
|
||||
--socks5-gssapi 7.55.0
|
||||
--socks5-gssapi-nec 7.19.4
|
||||
--socks5-gssapi-service 7.19.4
|
||||
--socks5-hostname 7.18.0
|
||||
--speed-limit (-Y) 4.7
|
||||
--speed-time (-y) 4.7
|
||||
--ssl 7.20.0
|
||||
--ssl-allow-beast 7.25.0
|
||||
--ssl-no-revoke 7.44.0
|
||||
--ssl-reqd 7.20.0
|
||||
--ssl-revoke-best-effort 7.70.0
|
||||
--sslv2 (-2) 5.9
|
||||
--sslv3 (-3) 5.9
|
||||
--stderr 6.2
|
||||
--styled-output 7.61.0
|
||||
--suppress-connect-headers 7.54.0
|
||||
--tcp-fastopen 7.49.0
|
||||
--tcp-nodelay 7.11.2
|
||||
--telnet-option (-t) 7.7
|
||||
--tftp-blksize 7.20.0
|
||||
--tftp-no-options 7.48.0
|
||||
--time-cond (-z) 5.8
|
||||
--tls-max 7.54.0
|
||||
--tls13-ciphers 7.61.0
|
||||
--tlsauthtype 7.21.4
|
||||
--tlspassword 7.21.4
|
||||
--tlsuser 7.21.4
|
||||
--tlsv1 (-1) 7.9.2
|
||||
--tlsv1.0 7.34.0
|
||||
--tlsv1.1 7.34.0
|
||||
--tlsv1.2 7.34.0
|
||||
--tlsv1.3 7.52.0
|
||||
--tr-encoding 7.21.6
|
||||
--trace 7.9.7
|
||||
--trace-ascii 7.9.7
|
||||
--trace-time 7.14.0
|
||||
--unix-socket 7.40.0
|
||||
--upload-file (-T) 4.0
|
||||
--url 7.5
|
||||
--use-ascii (-B) 5.0
|
||||
--user (-u) 4.0
|
||||
--user-agent (-A) 4.5.1
|
||||
--verbose (-v) 4.0
|
||||
--version (-V) 4.0
|
||||
--write-out (-w) 6.5
|
||||
--xattr 7.21.3
|
||||
@ -33,7 +33,7 @@ EXTRA_DIST = ftpserver.pl httpserver.pl secureserver.pl runtests.pl \
|
||||
negtelnetserver.py smbserver.py curl_test_data.py \
|
||||
objnames-test08.sh objnames-test10.sh objnames.inc \
|
||||
disable-scan.pl manpage-syntax.pl error-codes.pl badsymbols.pl \
|
||||
azure.pm appveyor.pm version-scan.pl
|
||||
azure.pm appveyor.pm version-scan.pl options-scan.pl
|
||||
|
||||
DISTCLEANFILES = configurehelp.pm
|
||||
|
||||
|
||||
@ -113,7 +113,7 @@ test927 test928 test929 test930 test931 test932 test933 test934 test935 \
|
||||
test936 test937 test938 test939 test940 test941 test942 test943 test944 \
|
||||
test945 test946 test947 test948 test949 test950 test951 test952 test953 \
|
||||
test954 test955 test956 test957 test958 test959 test960 test961 test962 \
|
||||
test963 test964 test965 test966 test967 test968 test969 test970 \
|
||||
test963 test964 test965 test966 test967 test968 test969 test970 test971 \
|
||||
\
|
||||
test1000 test1001 test1002 test1003 test1004 test1005 test1006 test1007 \
|
||||
test1008 test1009 test1010 test1011 test1012 test1013 test1014 test1015 \
|
||||
|
||||
25
tests/data/test971
Normal file
25
tests/data/test971
Normal file
@ -0,0 +1,25 @@
|
||||
<testcase>
|
||||
<info>
|
||||
<keywords>
|
||||
source analysis
|
||||
options-in-versions
|
||||
</keywords>
|
||||
</info>
|
||||
|
||||
#
|
||||
# Client-side
|
||||
<client>
|
||||
<server>
|
||||
none
|
||||
</server>
|
||||
|
||||
<name>
|
||||
Verify that options-in-versions and docs/cmdline-opts are in sync
|
||||
</name>
|
||||
|
||||
<command type="perl">
|
||||
%SRCDIR/options-scan.pl %SRCDIR/../docs/options-in-versions %SRCDIR/../docs/cmdline-opts
|
||||
</command>
|
||||
</client>
|
||||
|
||||
</testcase>
|
||||
120
tests/options-scan.pl
Normal file
120
tests/options-scan.pl
Normal file
@ -0,0 +1,120 @@
|
||||
#!/usr/bin/env perl
|
||||
#***************************************************************************
|
||||
# _ _ ____ _
|
||||
# Project ___| | | | _ \| |
|
||||
# / __| | | | |_) | |
|
||||
# | (__| |_| | _ <| |___
|
||||
# \___|\___/|_| \_\_____|
|
||||
#
|
||||
# Copyright (C) 2010 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al.
|
||||
#
|
||||
# This software is licensed as described in the file COPYING, which
|
||||
# you should have received as part of this distribution. The terms
|
||||
# are also available at https://curl.haxx.se/docs/copyright.html.
|
||||
#
|
||||
# You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
||||
# copies of the Software, and permit persons to whom the Software is
|
||||
# furnished to do so, under the terms of the COPYING file.
|
||||
#
|
||||
# This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
||||
# KIND, either express or implied.
|
||||
#
|
||||
###########################################################################
|
||||
#
|
||||
#
|
||||
# - Get all options mentioned in the $cmddir.
|
||||
# - Make sure they're all mentioned inthe $opts document
|
||||
# - Make usre that the version in $opts matches the version in the file in
|
||||
# $cmddir
|
||||
#
|
||||
|
||||
my $opts = $ARGV[0];
|
||||
my $cmddir = $ARGV[1];
|
||||
|
||||
sub cmdfiles {
|
||||
my ($dir)=@_;
|
||||
|
||||
opendir(my $dh, $dir) || die "Can't opendir $dir: $!";
|
||||
my @opts = grep { /\.d$/ && -f "$dir/$_" } readdir($dh);
|
||||
closedir $dh;
|
||||
|
||||
for(@opts) {
|
||||
$_ =~ s/\.d$//;
|
||||
$file{$_}=1;
|
||||
}
|
||||
return @opts;
|
||||
}
|
||||
|
||||
sub mentions {
|
||||
my ($f) = @_;
|
||||
my @options;
|
||||
open(F, "<$f");
|
||||
while(<F>) {
|
||||
chomp;
|
||||
if(/(.*) +([0-9.]+)/) {
|
||||
my ($flag, $version)=($1, $2);
|
||||
|
||||
# store the name without the leading dashes
|
||||
$flag =~ s/^--//;
|
||||
|
||||
# cut out short option (if present)
|
||||
$flag =~ s/ \(-.\)//;
|
||||
|
||||
# store the name without trailing space
|
||||
$flag =~ s/ +$//;
|
||||
|
||||
push @options, $flag;
|
||||
|
||||
# options-in-versions says...
|
||||
$oiv{$flag} = $version;
|
||||
}
|
||||
}
|
||||
return @options;
|
||||
}
|
||||
|
||||
sub versioncheck {
|
||||
my ($f, $v)=@_;
|
||||
open(F, "<$cmddir/$f.d");
|
||||
while(<F>) {
|
||||
chomp;
|
||||
if(/^Added: ([0-9.]+)/) {
|
||||
if($1 ne $v) {
|
||||
print STDERR "$f lists $v in doc but $1 in file\n";
|
||||
$error++;
|
||||
}
|
||||
last;
|
||||
}
|
||||
}
|
||||
close(F);
|
||||
}
|
||||
|
||||
# get all the files
|
||||
my @cmdopts = cmdfiles($cmddir);
|
||||
|
||||
# get all the options mentioned in $o
|
||||
my @veropts = mentions($opts);
|
||||
|
||||
# check if all files are in the doc
|
||||
for my $c (sort @cmdopts) {
|
||||
if($oiv{$c}) {
|
||||
# present, but at same version?
|
||||
versioncheck($c, $oiv{$c});
|
||||
}
|
||||
else {
|
||||
print STDERR "$c is in the directory but not in file!\n";
|
||||
$error++;
|
||||
}
|
||||
}
|
||||
|
||||
# check if the all options in the doc have files
|
||||
for my $v (sort @veropts) {
|
||||
if($file{$v}) {
|
||||
# present
|
||||
}
|
||||
else {
|
||||
print STDERR "$v is in the doc but NOT as a file!\n";
|
||||
$error++;
|
||||
}
|
||||
}
|
||||
|
||||
exit $error;
|
||||
Loading…
x
Reference in New Issue
Block a user