← Commit list

ef305de95c

Daniel Stenberg
Daniel Stenberg
2022-10-18
SUCCESS Duration: 93s

Subject

cmdline/docs: add a required 'multi' keyword for each option

Binary

Download Binary (742 KB)

Architecture & Compiler Flags

Architecture: x86_64-linux-gnu Compiler: gcc (Ubuntu 11.4.0-1ubuntu1~22.04.3) 11.4.0

—

Build Log

$ git checkout -f ef305de95c08004e62acc3937670c416538b1d4d
Previous HEAD position was 357649c477 amigaos: add missing curl header [ci skip]
HEAD is now at ef305de95c cmdline/docs: add a required 'multi' keyword for each option

$ git clean -fdx
Removing Makefile
Removing Makefile.in
Removing aclocal.m4
Removing autom4te.cache/
Removing compile
Removing config.guess
Removing config.log
Removing config.status
Removing config.sub
Removing configure
Removing curl-config
Removing depcomp
Removing docs/Makefile
Removing docs/Makefile.in
Removing docs/cmdline-opts/Makefile
Removing docs/cmdline-opts/Makefile.in
Removing docs/curl.1
Removing docs/examples/.deps/
Removing docs/examples/Makefile
Removing docs/examples/Makefile.in
Removing docs/libcurl/Makefile
Removing docs/libcurl/Makefile.in
Removing docs/libcurl/opts/Makefile
Removing docs/libcurl/opts/Makefile.in
Removing include/Makefile
Removing include/Makefile.in
Removing include/curl/Makefile
Removing include/curl/Makefile.in
Removing install-sh
Removing lib/.deps/
Removing lib/.dirstamp
Removing lib/.libs/
Removing lib/Makefile
Removing lib/Makefile.in
Removing lib/curl_config.h
Removing lib/curl_config.h.in
Removing lib/curl_multibyte.o
Removing lib/dynbuf.o
Removing lib/libcurl.la
Removing lib/libcurl.plist
Removing lib/libcurl.vers
Removing lib/libcurl_la-altsvc.lo
Removing lib/libcurl_la-altsvc.o
Removing lib/libcurl_la-amigaos.lo
Removing lib/libcurl_la-amigaos.o
Removing lib/libcurl_la-asyn-ares.lo
Removing lib/libcurl_la-asyn-ares.o
Removing lib/libcurl_la-asyn-thread.lo
Removing lib/libcurl_la-asyn-thread.o
Removing lib/libcurl_la-base64.lo
Removing lib/libcurl_la-base64.o
Removing lib/libcurl_la-bufref.lo
Removing lib/libcurl_la-bufref.o
Removing lib/libcurl_la-c-hyper.lo
Removing lib/libcurl_la-c-hyper.o
Removing lib/libcurl_la-conncache.lo
Removing lib/libcurl_la-conncache.o
Removing lib/libcurl_la-connect.lo
Removing lib/libcurl_la-connect.o
Removing lib/libcurl_la-content_encoding.lo
Removing lib/libcurl_la-content_encoding.o
Removing lib/libcurl_la-cookie.lo
Removing lib/libcurl_la-cookie.o
Removing lib/libcurl_la-curl_addrinfo.lo
Removing lib/libcurl_la-curl_addrinfo.o
Removing lib/libcurl_la-curl_des.lo
Removing lib/libcurl_la-curl_des.o
Removing lib/libcurl_la-curl_endian.lo
Removing lib/libcurl_la-curl_endian.o
Removing lib/libcurl_la-curl_fnmatch.lo
Removing lib/libcurl_la-curl_fnmatch.o
Removing lib/libcurl_la-curl_get_line.lo
Removing lib/libcurl_la-curl_get_line.o
Removing lib/libcurl_la-curl_gethostname.lo
Removing lib/libcurl_la-curl_gethostname.o
Removing lib/libcurl_la-curl_gssapi.lo
Removing lib/libcurl_la-curl_gssapi.o
Removing lib/libcurl_la-curl_memrchr.lo
Removing lib/libcurl_la-curl_memrchr.o
Removing lib/libcurl_la-curl_multibyte.lo
Removing lib/libcurl_la-curl_multibyte.o
Removing lib/libcurl_la-curl_ntlm_core.lo
Removing lib/libcurl_la-curl_ntlm_core.o
Removing lib/libcurl_la-curl_ntlm_wb.lo
Removing lib/libcurl_la-curl_ntlm_wb.o
Removing lib/libcurl_la-curl_path.lo
Removing lib/libcurl_la-curl_path.o
Removing lib/libcurl_la-curl_range.lo
Removing lib/libcurl_la-curl_range.o
Removing lib/libcurl_la-curl_rtmp.lo
Removing lib/libcurl_la-curl_rtmp.o
Removing lib/libcurl_la-curl_sasl.lo
Removing lib/libcurl_la-curl_sasl.o
Removing lib/libcurl_la-curl_sspi.lo
Removing lib/libcurl_la-curl_sspi.o
Removing lib/libcurl_la-curl_threads.lo
Removing lib/libcurl_la-curl_threads.o
Removing lib/libcurl_la-dict.lo
Removing lib/libcurl_la-dict.o
Removing lib/libcurl_la-doh.lo
Removing lib/libcurl_la-doh.o
Removing lib/libcurl_la-dynbuf.lo
Removing lib/libcurl_la-dynbuf.o
Removing lib/libcurl_la-easy.lo
Removing lib/libcurl_la-easy.o
Removing lib/libcurl_la-easygetopt.lo
Removing lib/libcurl_la-easygetopt.o
Removing lib/libcurl_la-easyoptions.lo
Removing lib/libcurl_la-easyoptions.o
Removing lib/libcurl_la-escape.lo
Removing lib/libcurl_la-escape.o
Removing lib/libcurl_la-file.lo
Removing lib/libcurl_la-file.o
Removing lib/libcurl_la-fileinfo.lo
Removing lib/libcurl_la-fileinfo.o
Removing lib/libcurl_la-fopen.lo
Removing lib/libcurl_la-fopen.o
Removing lib/libcurl_la-formdata.lo
Removing lib/libcurl_la-formdata.o
Removing lib/libcurl_la-ftp.lo
Removing lib/libcurl_la-ftp.o
Removing lib/libcurl_la-ftplistparser.lo
Removing lib/libcurl_la-ftplistparser.o
Removing lib/libcurl_la-getenv.lo
Removing lib/libcurl_la-getenv.o
Removing lib/libcurl_la-getinfo.lo
Removing lib/libcurl_la-getinfo.o
Removing lib/libcurl_la-gopher.lo
Removing lib/libcurl_la-gopher.o
Removing lib/libcurl_la-h2h3.lo
Removing lib/libcurl_la-h2h3.o
Removing lib/libcurl_la-hash.lo
Removing lib/libcurl_la-hash.o
Removing lib/libcurl_la-headers.lo
Removing lib/libcurl_la-headers.o
Removing lib/libcurl_la-hmac.lo
Removing lib/libcurl_la-hmac.o
Removing lib/libcurl_la-hostasyn.lo
Removing lib/libcurl_la-hostasyn.o
Removing lib/libcurl_la-hostip.lo
Removing lib/libcurl_la-hostip.o
Removing lib/libcurl_la-hostip4.lo
Removing lib/libcurl_la-hostip4.o
Removing lib/libcurl_la-hostip6.lo
Removing lib/libcurl_la-hostip6.o
Removing lib/libcurl_la-hostsyn.lo
Removing lib/libcurl_la-hostsyn.o
Removing lib/libcurl_la-hsts.lo
Removing lib/libcurl_la-hsts.o
Removing lib/libcurl_la-http.lo
Removing lib/libcurl_la-http.o
Removing lib/libcurl_la-http2.lo
Removing lib/libcurl_la-http2.o
Removing lib/libcurl_la-http_aws_sigv4.lo
Removing lib/libcurl_la-http_aws_sigv4.o
Removing lib/libcurl_la-http_chunks.lo
Removing lib/libcurl_la-http_chunks.o
Removing lib/libcurl_la-http_digest.lo
Removing lib/libcurl_la-http_digest.o
Removing lib/libcurl_la-http_negotiate.lo
Removing lib/libcurl_la-http_negotiate.o
Removing lib/libcurl_la-http_ntlm.lo
Removing lib/libcurl_la-http_ntlm.o
Removing lib/libcurl_la-http_proxy.lo
Removing lib/libcurl_la-http_proxy.o
Removing lib/libcurl_la-idn_win32.lo
Removing lib/libcurl_la-idn_win32.o
Removing lib/libcurl_la-if2ip.lo
Removing lib/libcurl_la-if2ip.o
Removing lib/libcurl_la-imap.lo
Removing lib/libcurl_la-imap.o
Removing lib/libcurl_la-inet_ntop.lo
Removing lib/libcurl_la-inet_ntop.o
Removing lib/libcurl_la-inet_pton.lo
Removing lib/libcurl_la-inet_pton.o
Removing lib/libcurl_la-krb5.lo
Removing lib/libcurl_la-krb5.o
Removing lib/libcurl_la-ldap.lo
Removing lib/libcurl_la-ldap.o
Removing lib/libcurl_la-llist.lo
Removing lib/libcurl_la-llist.o
Removing lib/libcurl_la-md4.lo
Removing lib/libcurl_la-md4.o
Removing lib/libcurl_la-md5.lo
Removing lib/libcurl_la-md5.o
Removing lib/libcurl_la-memdebug.lo
Removing lib/libcurl_la-memdebug.o
Removing lib/libcurl_la-mime.lo
Removing lib/libcurl_la-mime.o
Removing lib/libcurl_la-mprintf.lo
Removing lib/libcurl_la-mprintf.o
Removing lib/libcurl_la-mqtt.lo
Removing lib/libcurl_la-mqtt.o
Removing lib/libcurl_la-multi.lo
Removing lib/libcurl_la-multi.o
Removing lib/libcurl_la-netrc.lo
Removing lib/libcurl_la-netrc.o
Removing lib/libcurl_la-nonblock.lo
Removing lib/libcurl_la-nonblock.o
Removing lib/libcurl_la-openldap.lo
Removing lib/libcurl_la-openldap.o
Removing lib/libcurl_la-parsedate.lo
Removing lib/libcurl_la-parsedate.o
Removing lib/libcurl_la-pingpong.lo
Removing lib/libcurl_la-pingpong.o
Removing lib/libcurl_la-pop3.lo
Removing lib/libcurl_la-pop3.o
Removing lib/libcurl_la-progress.lo
Removing lib/libcurl_la-progress.o
Removing lib/libcurl_la-psl.lo
Removing lib/libcurl_la-psl.o
Removing lib/libcurl_la-rand.lo
Removing lib/libcurl_la-rand.o
Removing lib/libcurl_la-rename.lo
Removing lib/libcurl_la-rename.o
Removing lib/libcurl_la-rtsp.lo
Removing lib/libcurl_la-rtsp.o
Removing lib/libcurl_la-select.lo
Removing lib/libcurl_la-select.o
Removing lib/libcurl_la-sendf.lo
Removing lib/libcurl_la-sendf.o
Removing lib/libcurl_la-setopt.lo
Removing lib/libcurl_la-setopt.o
Removing lib/libcurl_la-sha256.lo
Removing lib/libcurl_la-sha256.o
Removing lib/libcurl_la-share.lo
Removing lib/libcurl_la-share.o
Removing lib/libcurl_la-slist.lo
Removing lib/libcurl_la-slist.o
Removing lib/libcurl_la-smb.lo
Removing lib/libcurl_la-smb.o
Removing lib/libcurl_la-smtp.lo
Removing lib/libcurl_la-smtp.o
Removing lib/libcurl_la-socketpair.lo
Removing lib/libcurl_la-socketpair.o
Removing lib/libcurl_la-socks.lo
Removing lib/libcurl_la-socks.o
Removing lib/libcurl_la-socks_gssapi.lo
Removing lib/libcurl_la-socks_gssapi.o
Removing lib/libcurl_la-socks_sspi.lo
Removing lib/libcurl_la-socks_sspi.o
Removing lib/libcurl_la-speedcheck.lo
Removing lib/libcurl_la-speedcheck.o
Removing lib/libcurl_la-splay.lo
Removing lib/libcurl_la-splay.o
Removing lib/libcurl_la-strcase.lo
Removing lib/libcurl_la-strcase.o
Removing lib/libcurl_la-strdup.lo
Removing lib/libcurl_la-strdup.o
Removing lib/libcurl_la-strerror.lo
Removing lib/libcurl_la-strerror.o
Removing lib/libcurl_la-strtok.lo
Removing lib/libcurl_la-strtok.o
Removing lib/libcurl_la-strtoofft.lo
Removing lib/libcurl_la-strtoofft.o
Removing lib/libcurl_la-system_win32.lo
Removing lib/libcurl_la-system_win32.o
Removing lib/libcurl_la-telnet.lo
Removing lib/libcurl_la-telnet.o
Removing lib/libcurl_la-tftp.lo
Removing lib/libcurl_la-tftp.o
Removing lib/libcurl_la-timediff.lo
Removing lib/libcurl_la-timediff.o
Removing lib/libcurl_la-timeval.lo
Removing lib/libcurl_la-timeval.o
Removing lib/libcurl_la-transfer.lo
Removing lib/libcurl_la-transfer.o
Removing lib/libcurl_la-url.lo
Removing lib/libcurl_la-url.o
Removing lib/libcurl_la-urlapi.lo
Removing lib/libcurl_la-urlapi.o
Removing lib/libcurl_la-version.lo
Removing lib/libcurl_la-version.o
Removing lib/libcurl_la-version_win32.lo
Removing lib/libcurl_la-version_win32.o
Removing lib/libcurl_la-warnless.lo
Removing lib/libcurl_la-warnless.o
Removing lib/libcurl_la-wildcard.lo
Removing lib/libcurl_la-wildcard.o
Removing lib/libcurl_la-ws.lo
Removing lib/libcurl_la-ws.o
Removing lib/nonblock.o
Removing lib/stamp-h1
Removing lib/strtoofft.o
Removing lib/timediff.o
Removing lib/vauth/.deps/
Removing lib/vauth/.dirstamp
Removing lib/vauth/libcurl_la-cleartext.lo
Removing lib/vauth/libcurl_la-cleartext.o
Removing lib/vauth/libcurl_la-cram.lo
Removing lib/vauth/libcurl_la-cram.o
Removing lib/vauth/libcurl_la-digest.lo
Removing lib/vauth/libcurl_la-digest.o
Removing lib/vauth/libcurl_la-digest_sspi.lo
Removing lib/vauth/libcurl_la-digest_sspi.o
Removing lib/vauth/libcurl_la-gsasl.lo
Removing lib/vauth/libcurl_la-gsasl.o
Removing lib/vauth/libcurl_la-krb5_gssapi.lo
Removing lib/vauth/libcurl_la-krb5_gssapi.o
Removing lib/vauth/libcurl_la-krb5_sspi.lo
Removing lib/vauth/libcurl_la-krb5_sspi.o
Removing lib/vauth/libcurl_la-ntlm.lo
Removing lib/vauth/libcurl_la-ntlm.o
Removing lib/vauth/libcurl_la-ntlm_sspi.lo
Removing lib/vauth/libcurl_la-ntlm_sspi.o
Removing lib/vauth/libcurl_la-oauth2.lo
Removing lib/vauth/libcurl_la-oauth2.o
Removing lib/vauth/libcurl_la-spnego_gssapi.lo
Removing lib/vauth/libcurl_la-spnego_gssapi.o
Removing lib/vauth/libcurl_la-spnego_sspi.lo
Removing lib/vauth/libcurl_la-spnego_sspi.o
Removing lib/vauth/libcurl_la-vauth.lo
Removing lib/vauth/libcurl_la-vauth.o
Removing lib/version_win32.o
Removing lib/vquic/.deps/
Removing lib/vquic/.dirstamp
Removing lib/vquic/libcurl_la-msh3.lo
Removing lib/vquic/libcurl_la-msh3.o
Removing lib/vquic/libcurl_la-ngtcp2.lo
Removing lib/vquic/libcurl_la-ngtcp2.o
Removing lib/vquic/libcurl_la-quiche.lo
Removing lib/vquic/libcurl_la-quiche.o
Removing lib/vquic/libcurl_la-vquic.lo
Removing lib/vquic/libcurl_la-vquic.o
Removing lib/vssh/.deps/
Removing lib/vssh/.dirstamp
Removing lib/vssh/libcurl_la-libssh.lo
Removing lib/vssh/libcurl_la-libssh.o
Removing lib/vssh/libcurl_la-libssh2.lo
Removing lib/vssh/libcurl_la-libssh2.o
Removing lib/vssh/libcurl_la-wolfssh.lo
Removing lib/vssh/libcurl_la-wolfssh.o
Removing lib/vtls/.deps/
Removing lib/vtls/.dirstamp
Removing lib/vtls/libcurl_la-bearssl.lo
Removing lib/vtls/libcurl_la-bearssl.o
Removing lib/vtls/libcurl_la-gskit.lo
Removing lib/vtls/libcurl_la-gskit.o
Removing lib/vtls/libcurl_la-gtls.lo
Removing lib/vtls/libcurl_la-gtls.o
Removing lib/vtls/libcurl_la-hostcheck.lo
Removing lib/vtls/libcurl_la-hostcheck.o
Removing lib/vtls/libcurl_la-keylog.lo
Removing lib/vtls/libcurl_la-keylog.o
Removing lib/vtls/libcurl_la-mbedtls.lo
Removing lib/vtls/libcurl_la-mbedtls.o
Removing lib/vtls/libcurl_la-mbedtls_threadlock.lo
Removing lib/vtls/libcurl_la-mbedtls_threadlock.o
Removing lib/vtls/libcurl_la-nss.lo
Removing lib/vtls/libcurl_la-nss.o
Removing lib/vtls/libcurl_la-openssl.lo
Removing lib/vtls/libcurl_la-openssl.o
Removing lib/vtls/libcurl_la-rustls.lo
Removing lib/vtls/libcurl_la-rustls.o
Removing lib/vtls/libcurl_la-schannel.lo
Removing lib/vtls/libcurl_la-schannel.o
Removing lib/vtls/libcurl_la-schannel_verify.lo
Removing lib/vtls/libcurl_la-schannel_verify.o
Removing lib/vtls/libcurl_la-sectransp.lo
Removing lib/vtls/libcurl_la-sectransp.o
Removing lib/vtls/libcurl_la-vtls.lo
Removing lib/vtls/libcurl_la-vtls.o
Removing lib/vtls/libcurl_la-wolfssl.lo
Removing lib/vtls/libcurl_la-wolfssl.o
Removing lib/vtls/libcurl_la-x509asn1.lo
Removing lib/vtls/libcurl_la-x509asn1.o
Removing lib/warnless.o
Removing libcurl.pc
Removing libtool
Removing ltmain.sh
Removing m4/libtool.m4
Removing m4/ltoptions.m4
Removing m4/ltsugar.m4
Removing m4/ltversion.m4
Removing m4/lt~obsolete.m4
Removing missing
Removing packages/Makefile
Removing packages/Makefile.in
Removing packages/vms/Makefile
Removing packages/vms/Makefile.in
Removing scripts/Makefile
Removing scripts/Makefile.in
Removing src/.deps/
Removing src/.libs/
Removing src/Makefile
Removing src/Makefile.in
Removing src/curl
Removing src/slist_wc.o
Removing src/tool_binmode.o
Removing src/tool_bname.o
Removing src/tool_cb_dbg.o
Removing src/tool_cb_hdr.o
Removing src/tool_cb_prg.o
Removing src/tool_cb_rea.o
Removing src/tool_cb_see.o
Removing src/tool_cb_wrt.o
Removing src/tool_cfgable.o
Removing src/tool_dirhie.o
Removing src/tool_doswin.o
Removing src/tool_easysrc.o
Removing src/tool_filetime.o
Removing src/tool_findfile.o
Removing src/tool_formparse.o
Removing src/tool_getparam.o
Removing src/tool_getpass.o
Removing src/tool_help.o
Removing src/tool_helpers.o
Removing src/tool_hugehelp.c
Removing src/tool_hugehelp.o
Removing src/tool_libinfo.o
Removing src/tool_listhelp.o
Removing src/tool_main.o
Removing src/tool_msgs.o
Removing src/tool_operate.o
Removing src/tool_operhlp.o
Removing src/tool_panykey.o
Removing src/tool_paramhlp.o
Removing src/tool_parsecfg.o
Removing src/tool_progress.o
Removing src/tool_setopt.o
Removing src/tool_sleep.o
Removing src/tool_strdup.o
Removing src/tool_urlglob.o
Removing src/tool_util.o
Removing src/tool_vms.o
Removing src/tool_writeout.o
Removing src/tool_writeout_json.o
Removing src/tool_xattr.o
Removing test-driver
Removing tests/Makefile
Removing tests/Makefile.in
Removing tests/certs/Makefile
Removing tests/certs/Makefile.in
Removing tests/certs/scripts/Makefile
Removing tests/certs/scripts/Makefile.in
Removing tests/configurehelp.pm
Removing tests/data/Makefile
Removing tests/data/Makefile.in
Removing tests/libtest/.deps/
Removing tests/libtest/Makefile
Removing tests/libtest/Makefile.in
Removing tests/server/.deps/
Removing tests/server/Makefile
Removing tests/server/Makefile.in
Removing tests/unit/.deps/
Removing tests/unit/Makefile
Removing tests/unit/Makefile.in

$ autoreconf -fi
libtoolize: putting auxiliary files in '.'.
libtoolize: copying file './ltmain.sh'
libtoolize: putting macros in AC_CONFIG_MACRO_DIRS, 'm4'.
libtoolize: copying file 'm4/libtool.m4'
libtoolize: copying file 'm4/ltoptions.m4'
libtoolize: copying file 'm4/ltsugar.m4'
libtoolize: copying file 'm4/ltversion.m4'
libtoolize: copying file 'm4/lt~obsolete.m4'
libtoolize: Remember to add 'LT_INIT' to configure.ac.
configure.ac:123: installing './compile'
configure.ac:333: installing './config.guess'
configure.ac:333: installing './config.sub'
configure.ac:123: installing './install-sh'
configure.ac:129: installing './missing'
docs/examples/Makefile.am: installing './depcomp'
parallel-tests: installing './test-driver'

$ bash -c find . -name config.guess -exec cp /usr/share/misc/config.guess {} \;

$ bash -c find . -name config.sub -exec cp /usr/share/misc/config.sub {} \;

$ chmod +x configure

$ ./configure --disable-shared --without-ssl --disable-docs
checking whether to enable maintainer-specific portions of Makefiles... no
checking whether make supports nested variables... yes
checking whether to enable debug build options... no
checking whether to enable compiler optimizer... (assumed) yes
checking whether to enable strict compiler warnings... no
checking whether to enable compiler warnings as errors... no
checking whether to enable curl debug memory tracking... no
checking whether to enable hiding of library internal symbols... yes
checking whether to enable c-ares for DNS lookups... no
checking whether to disable dependency on -lrt... (assumed no)
checking whether to enable ECH support... no
checking for path separator... :
checking for sed... /usr/bin/sed
checking for grep... /usr/bin/grep
checking that grep -E works... yes
checking for ar... /usr/bin/ar
checking for a BSD-compatible install... /usr/bin/install -c
checking for gcc... ccache gcc
checking whether the C compiler works... yes
checking for C compiler default output file name... a.out
checking for suffix of executables... 
checking whether we are cross compiling... no
checking for suffix of object files... o
checking whether the compiler supports GNU C... yes
checking whether ccache gcc accepts -g... yes
checking for ccache gcc option to enable C11 features... none needed
checking whether ccache gcc understands -c and -o together... yes
checking how to run the C preprocessor... ccache gcc -E
checking for stdio.h... yes
checking for stdlib.h... yes
checking for string.h... yes
checking for inttypes.h... yes
checking for stdint.h... yes
checking for strings.h... yes
checking for sys/stat.h... yes
checking for sys/types.h... yes
checking for unistd.h... yes
checking for stdatomic.h... yes
checking if _Atomic is available... yes
checking for a sed that does not truncate output... (cached) /usr/bin/sed
checking for code coverage support... no
checking whether build environment is sane... yes
checking for a race-free mkdir -p... /usr/bin/mkdir -p
checking for gawk... gawk
checking whether make sets $(MAKE)... yes
checking whether make supports the include directive... yes (GNU style)
checking dependency style of ccache gcc... gcc3
checking curl version... 7.86.0-DEV
checking build system type... x86_64-pc-linux-gnu
checking host system type... x86_64-pc-linux-gnu
checking for grep that handles long lines and -e... (cached) /usr/bin/grep
checking for egrep... /usr/bin/grep -E
checking if OS is AIX (to define _ALL_SOURCE)... no
checking if _THREAD_SAFE is already defined... no
checking if _THREAD_SAFE is actually needed... no
checking if _THREAD_SAFE is onwards defined... no
checking if _REENTRANT is already defined... no
checking if _REENTRANT is actually needed... no
checking if _REENTRANT is onwards defined... no
checking for special C compiler options needed for large files... no
checking for _FILE_OFFSET_BITS value needed for large files... no
checking how to print strings... printf
checking for a sed that does not truncate output... (cached) /usr/bin/sed
checking for fgrep... /usr/bin/grep -F
checking for ld used by ccache gcc... /usr/bin/ld
checking if the linker (/usr/bin/ld) is GNU ld... yes
checking for BSD- or MS-compatible name lister (nm)... /usr/bin/nm -B
checking the name lister (/usr/bin/nm -B) interface... BSD nm
checking whether ln -s works... yes
checking the maximum length of command line arguments... 1572864
checking how to convert x86_64-pc-linux-gnu file names to x86_64-pc-linux-gnu format... func_convert_file_noop
checking how to convert x86_64-pc-linux-gnu file names to toolchain format... func_convert_file_noop
checking for /usr/bin/ld option to reload object files... -r
checking for objdump... objdump
checking how to recognize dependent libraries... pass_all
checking for dlltool... no
checking how to associate runtime and link libraries... printf %s\n
checking for archiver @FILE support... @
checking for strip... strip
checking for ranlib... ranlib
checking command to parse /usr/bin/nm -B output from ccache gcc object... ok
checking for sysroot... no
checking for a working dd... /usr/bin/dd
checking how to truncate binary pipes... /usr/bin/dd bs=4096 count=1
checking for mt... mt
checking if mt is a manifest tool... no
checking for dlfcn.h... yes
checking for objdir... .libs
checking if ccache gcc supports -fno-rtti -fno-exceptions... no
checking for ccache gcc option to produce PIC... -fPIC -DPIC
checking if ccache gcc PIC flag -fPIC -DPIC works... yes
checking if ccache gcc static flag -static works... yes
checking if ccache gcc supports -c -o file.o... yes
checking if ccache gcc supports -c -o file.o... (cached) yes
checking whether the ccache gcc linker (/usr/bin/ld -m elf_x86_64) supports shared libraries... yes
checking dynamic linker characteristics... GNU/Linux ld.so
checking how to hardcode library paths into programs... immediate
checking whether stripping libraries is possible... yes
checking if libtool supports shared libraries... yes
checking whether to build shared libraries... no
checking whether to build static libraries... yes
checking whether to build shared libraries with -version-info... yes
checking whether to build shared libraries with -no-undefined... no
checking whether to build shared libraries with -mimpure-text... no
checking whether to build shared libraries with PIC... yes
checking whether to build static libraries with PIC... yes
checking whether to build shared libraries only... no
checking whether to build static libraries only... yes
checking for windres... no
checking for inline... inline
checking if cpp -P is needed... yes
checking if cpp -P works... yes
checking if compiler is DEC/Compaq/HP C... no
checking if compiler is HP-UX C... no
checking if compiler is IBM C... no
checking if compiler is Intel C... no
checking if compiler is clang... no
checking if compiler is GNU C... yes
checking if compiler is LCC... no
checking if compiler is SGI MIPSpro C... no
checking if compiler is SGI MIPS C... no
checking if compiler is SunPro C... no
checking if compiler is Tiny C... no
checking if compiler accepts some basic options... yes
configure: compiler options added: -Werror-implicit-function-declaration 
checking if compiler optimizer assumed setting might be used... yes
checking if compiler accepts optimizer enabling options... yes
configure: compiler options added: -O2
checking if compiler accepts strict warning options... yes
configure: compiler options added: -Wno-system-headers 
checking if compiler halts on compilation errors... yes
checking if compiler halts on negative sized arrays... yes
checking if compiler halts on function prototype mismatch... yes
checking if compiler supports hiding library internal symbols... yes
checking for windows.h... no
checking whether build target is a native Windows one... no
checking whether build target supports WIN32 file API... no
checking whether build target supports WIN32 crypto API... no
checking for good-to-use Darwin CFLAGS... no
checking whether to link macOS CoreFoundation and SystemConfiguration framework... no
checking to see if the compiler supports __builtin_available()... no
checking whether to support http... yes
checking whether to support ftp... yes
checking whether to support file... yes
checking whether to support ldap... yes
checking whether to support ldaps... yes
checking whether to support rtsp... yes
checking whether to support proxies... yes
checking whether to support dict... yes
checking whether to support telnet... yes
checking whether to support tftp... yes
checking whether to support pop3... yes
checking whether to support imap... yes
checking whether to support smb... yes
checking whether to support smtp... yes
checking whether to support gopher... yes
checking whether to support mqtt... no
checking whether to provide built-in manual... yes
checking whether to enable generation of C code... yes
checking whether to use libgcc... no
checking if X/Open network library is required... no
checking for gethostbyname... yes
checking for windows.h... (cached) no
checking for winsock2.h... (cached) no
checking for proto/bsdsocket.h... no
checking for connect in libraries... yes
checking for sys/types.h... (cached) yes
checking for sys/time.h... yes
checking for monotonic clock_gettime... yes
checking for clock_gettime in libraries... no additional lib required
checking if monotonic clock_gettime works... yes
checking for pkg-config... /usr/bin/pkg-config
checking for zlib options with pkg-config... found
checking for zlib.h... yes
configure: found both libz and libz.h header
checking for BrotliDecoderDecompress in -lbrotlidec... no
checking for brotli/decode.h... no
checking for ZSTD_createDStream in -lzstd... no
checking for zstd.h... no
checking for lber.h... no
checking for ldap.h... no
checking for ldap_ssl.h... no
checking for LDAP libraries... cannot find LDAP libraries
checking whether to enable IPv6... yes
checking if struct sockaddr_in6 has sin6_scope_id member... yes
checking if argv can be written to... yes
checking if GSS-API support is requested... no
checking whether to enable Windows native SSL/TLS... no
checking whether to enable Secure Transport... no
checking whether to enable Amiga native SSL/TLS (AmiSSL v5)... no
checking for library containing psl_builtin... -lpsl
checking for library containing gsasl_init... no
checking for RTMP_Init in -lrtmp... no
checking whether versioned symbols are wanted... no
checking whether to enable Windows native IDN (Windows native builds only)... no
checking whether to build with libidn2... (assumed) yes
checking for pkg-config... (cached) /usr/bin/pkg-config
checking for libidn2 options with pkg-config... no
configure: IDN_LIBS: "-lidn2"
configure: IDN_LDFLAGS: ""
configure: IDN_CPPFLAGS: ""
configure: IDN_DIR: ""
checking if idn2_lookup_ul can be linked... no
checking for idn2.h... no
checking for pkg-config... (cached) /usr/bin/pkg-config
checking for libnghttp2 options with pkg-config... no
checking for nghttp2_session_set_local_window_size in -lnghttp2... no
checking for pkg-config... (cached) /usr/bin/pkg-config
checking for fish options with pkg-config... no
checking for sys/types.h... (cached) yes
checking for sys/time.h... (cached) yes
checking for sys/select.h... yes
checking for sys/socket.h... yes
checking for sys/ioctl.h... yes
checking for sys/uio.h... yes
checking for assert.h... yes
checking for unistd.h... (cached) yes
checking for stdlib.h... (cached) yes
checking for arpa/inet.h... yes
checking for net/if.h... yes
checking for netinet/in.h... yes
checking for netinet/in6.h... no
checking for sys/un.h... yes
checking for linux/tcp.h... yes
checking for netinet/tcp.h... yes
checking for netinet/udp.h... yes
checking for netdb.h... yes
checking for sys/sockio.h... no
checking for sys/stat.h... (cached) yes
checking for sys/param.h... yes
checking for termios.h... yes
checking for termio.h... yes
checking for fcntl.h... yes
checking for io.h... no
checking for pwd.h... yes
checking for utime.h... yes
checking for sys/utime.h... no
checking for sys/poll.h... yes
checking for poll.h... yes
checking for socket.h... no
checking for sys/resource.h... yes
checking for libgen.h... yes
checking for locale.h... yes
checking for errno.h... yes
checking for stdbool.h... yes
checking for arpa/tftp.h... yes
checking for sys/filio.h... no
checking for sys/wait.h... yes
checking for setjmp.h... yes
checking for an ANSI C-conforming const... yes
checking for compiler support of C99 variadic macro style... yes
checking for compiler support of old gcc variadic macro style... yes
checking for size_t... yes
checking for sys/types.h... (cached) yes
checking for sys/time.h... (cached) yes
checking for sys/socket.h... (cached) yes
checking for struct timeval... yes
checking run-time libs availability... fine
checking size of size_t... 8
checking size of long... 8
checking size of int... 4
checking size of time_t... 8
checking size of off_t... 8
checking size of curl_off_t... 8
checking for long long... yes
checking for ssize_t... yes
checking for bool... yes
checking for sa_family_t... yes
checking for suseconds_t... yes
checking if time_t is unsigned... no
checking for sys/types.h... (cached) yes
checking for poll.h... (cached) yes
checking for sys/poll.h... (cached) yes
checking for in_addr_t... yes
checking for struct sockaddr_storage... yes
checking for sys/select.h... (cached) yes
checking for sys/socket.h... (cached) yes
checking for select... yes
checking for sys/types.h... (cached) yes
checking for sys/socket.h... (cached) yes
checking for recv... yes
checking for sys/types.h... (cached) yes
checking for sys/socket.h... (cached) yes
checking for send... yes
checking for sys/types.h... (cached) yes
checking for sys/socket.h... (cached) yes
checking for MSG_NOSIGNAL... yes
checking for sys/types.h... (cached) yes
checking for unistd.h... (cached) yes
checking if alarm can be linked... yes
checking if alarm is prototyped... yes
checking if alarm is compilable... yes
checking if alarm usage allowed... yes
checking if alarm might be used... yes
checking for sys/types.h... (cached) yes
checking for string.h... (cached) yes
checking for strings.h... (cached) yes
checking for sys/types.h... (cached) yes
checking for libgen.h... (cached) yes
checking if basename can be linked... yes
checking if basename is prototyped... yes
checking if basename is compilable... yes
checking if basename usage allowed... yes
checking if basename might be used... yes
checking for sys/types.h... (cached) yes
checking for socket.h... (cached) no
checking if closesocket can be linked... no
checking if closesocket might be used... no
checking for sys/types.h... (cached) yes
checking for sys/socket.h... (cached) yes
checking if CloseSocket can be linked... no
checking if CloseSocket might be used... no
checking if connect can be linked... yes
checking if connect is prototyped... yes
checking if connect is compilable... yes
checking if connect usage allowed... yes
checking if connect might be used... yes
checking for sys/types.h... (cached) yes
checking for unistd.h... (cached) yes
checking for fcntl.h... (cached) yes
checking if fcntl can be linked... yes
checking if fcntl is prototyped... yes
checking if fcntl is compilable... yes
checking if fcntl usage allowed... yes
checking if fcntl might be used... yes
checking if fcntl O_NONBLOCK is compilable... yes
checking if fcntl O_NONBLOCK usage allowed... yes
checking if fcntl O_NONBLOCK might be used... yes
checking for windows.h... (cached) no
checking for winsock2.h... (cached) no
checking for ws2tcpip.h... (cached) no
checking for sys/types.h... (cached) yes
checking for netdb.h... (cached) yes
checking if freeaddrinfo can be linked... yes
checking if freeaddrinfo is prototyped... yes
checking if freeaddrinfo is compilable... yes
checking if freeaddrinfo usage allowed... yes
checking if freeaddrinfo might be used... yes
checking for sys/types.h... (cached) yes
checking for sys/xattr.h... yes
checking if fsetxattr can be linked... yes
checking if fsetxattr is prototyped... yes
checking if fsetxattr takes 5 args.... yes
checking if fsetxattr is compilable... yes
checking if fsetxattr usage allowed... yes
checking if fsetxattr might be used... yes
checking if ftruncate can be linked... yes
checking if ftruncate is prototyped... yes
checking if ftruncate is compilable... yes
checking if ftruncate usage allowed... yes
checking if ftruncate might be used... yes
checking for sys/types.h... (cached) yes
checking for stdlib.h... (cached) yes
checking if getaddrinfo can be linked... yes
checking if getaddrinfo is prototyped... yes
checking if getaddrinfo is compilable... yes
checking if getaddrinfo seems to work... yes
checking if getaddrinfo usage allowed... yes
checking if getaddrinfo might be used... yes
checking if getaddrinfo is threadsafe... yes
checking if gethostbyname can be linked... yes
checking if gethostbyname is prototyped... yes
checking if gethostbyname is compilable... yes
checking if gethostbyname usage allowed... yes
checking if gethostbyname might be used... yes
checking if gethostbyname_r can be linked... yes
checking if gethostbyname_r is prototyped... yes
checking if gethostbyname_r takes 3 args.... no
checking if gethostbyname_r takes 5 args.... no
checking if gethostbyname_r takes 6 args.... yes
checking if gethostbyname_r is compilable... yes
checking if gethostbyname_r usage allowed... yes
checking if gethostbyname_r might be used... yes
checking if gethostname can be linked... yes
checking if gethostname is prototyped... yes
checking if gethostname is compilable... yes
checking for gethostname arg 2 data type... size_t
checking if gethostname usage allowed... yes
checking if gethostname might be used... yes
checking if getpeername can be linked... yes
checking if getpeername is prototyped... yes
checking if getpeername is compilable... yes
checking if getpeername usage allowed... yes
checking if getpeername might be used... yes
checking if getsockname can be linked... yes
checking if getsockname is prototyped... yes
checking if getsockname is compilable... yes
checking if getsockname usage allowed... yes
checking if getsockname might be used... yes
checking for net/if.h... (cached) yes
checking if if_nametoindex can be linked... yes
checking if if_nametoindex is prototyped... yes
checking if if_nametoindex is compilable... yes
checking if if_nametoindex usage allowed... yes
checking if if_nametoindex might be used... yes
checking for sys/types.h... (cached) yes
checking for sys/socket.h... (cached) yes
checking for netinet/in.h... (cached) yes
checking for ifaddrs.h... yes
checking if getifaddrs can be linked... yes
checking if getifaddrs is prototyped... yes
checking if getifaddrs is compilable... yes
checking if getifaddrs seems to work... yes
checking if getifaddrs usage allowed... yes
checking if getifaddrs might be used... yes
checking for sys/types.h... (cached) yes
checking for sys/time.h... (cached) yes
checking if gmtime_r can be linked... yes
checking if gmtime_r is prototyped... yes
checking if gmtime_r is compilable... yes
checking if gmtime_r seems to work... yes
checking if gmtime_r usage allowed... yes
checking if gmtime_r might be used... yes
checking for sys/types.h... (cached) yes
checking for sys/socket.h... (cached) yes
checking for netinet/in.h... (cached) yes
checking for arpa/inet.h... (cached) yes
checking if inet_ntop can be linked... yes
checking if inet_ntop is prototyped... yes
checking if inet_ntop is compilable... yes
checking if inet_ntop seems to work... yes
checking if inet_ntop usage allowed... yes
checking if inet_ntop might be used... yes
checking if inet_pton can be linked... yes
checking if inet_pton is prototyped... yes
checking if inet_pton is compilable... yes
checking if inet_pton seems to work... yes
checking if inet_pton usage allowed... yes
checking if inet_pton might be used... yes
checking if ioctlsocket can be linked... no
checking if ioctlsocket might be used... no
checking if IoctlSocket can be linked... no
checking if IoctlSocket might be used... no
checking if memrchr can be linked... yes
checking if memrchr is prototyped... no
checking if memrchr might be used... no
checking if poll can be linked... yes
checking if poll is prototyped... yes
checking if poll is compilable... yes
checking if poll seems to work... yes
checking if poll usage allowed... yes
checking if poll might be used... yes
checking for sys/types.h... (cached) yes
checking for signal.h... yes
checking if sigaction can be linked... yes
checking if sigaction is prototyped... yes
checking if sigaction is compilable... yes
checking if sigaction usage allowed... yes
checking if sigaction might be used... yes
checking if siginterrupt can be linked... yes
checking if siginterrupt is prototyped... yes
checking if siginterrupt is compilable... yes
checking if siginterrupt usage allowed... yes
checking if siginterrupt might be used... yes
checking if signal can be linked... yes
checking if signal is prototyped... yes
checking if signal is compilable... yes
checking if signal usage allowed... yes
checking if signal might be used... yes
checking for sys/types.h... (cached) yes
checking for setjmp.h... (cached) yes
checking if sigsetjmp can be linked... no
checking if sigsetjmp seems a macro... yes
checking if sigsetjmp is compilable... yes
checking if sigsetjmp usage allowed... yes
checking if sigsetjmp might be used... yes
checking if socket can be linked... yes
checking if socket is prototyped... yes
checking if socket is compilable... yes
checking if socket usage allowed... yes
checking if socket might be used... yes
checking if socketpair can be linked... yes
checking if socketpair is prototyped... yes
checking if socketpair is compilable... yes
checking if socketpair usage allowed... yes
checking if socketpair might be used... yes
checking if strcasecmp can be linked... yes
checking if strcasecmp is prototyped... yes
checking if strcasecmp is compilable... yes
checking if strcasecmp usage allowed... yes
checking if strcasecmp might be used... yes
checking if strcmpi can be linked... no
checking if strcmpi might be used... no
checking if strdup can be linked... yes
checking if strdup is prototyped... yes
checking if strdup is compilable... yes
checking if strdup usage allowed... yes
checking if strdup might be used... yes
checking if strerror_r can be linked... yes
checking if strerror_r is prototyped... yes
checking if strerror_r is compilable... yes
checking if strerror_r is glibc like... no
checking if strerror_r is POSIX like... yes
checking if strerror_r seems to work... yes
checking if strerror_r usage allowed... yes
checking if strerror_r might be used... yes
checking if stricmp can be linked... no
checking if stricmp might be used... no
checking if strtok_r can be linked... yes
checking if strtok_r is prototyped... yes
checking if strtok_r is compilable... yes
checking if strtok_r usage allowed... yes
checking if strtok_r might be used... yes
checking if strtoll can be linked... yes
checking if strtoll is prototyped... yes
checking if strtoll is compilable... yes
checking if strtoll usage allowed... yes
checking if strtoll might be used... yes
checking for ccache gcc options needed to detect all undeclared functions... none needed
checking whether getpwuid_r is declared... yes
checking for fnmatch... yes
checking for fchmod... yes
checking for geteuid... yes
checking for getpass_r... no
checking deeper for getpass_r... but still no
checking for getppid... yes
checking for getpwuid... yes
checking for getpwuid_r... yes
checking for getrlimit... yes
checking for gettimeofday... yes
checking for if_nametoindex... yes
checking for mach_absolute_time... no
checking deeper for mach_absolute_time... but still no
checking for pipe... yes
checking for sched_yield... yes
checking for sendmsg... yes
checking for setlocale... yes
checking for setmode... no
checking deeper for setmode... but still no
checking for setrlimit... yes
checking for snprintf... yes
checking for utime... yes
checking for utimes... yes
checking how to set a socket into non-blocking mode... fcntl O_NONBLOCK
checking for perl... /usr/bin/perl
checking for gnroff... no
checking for nroff... /usr/bin/nroff
checking how to use *nroff to get plain text from man pages... -man
checking whether to enable the threaded resolver... yes
checking whether to use POSIX threads for threaded resolver... auto
checking for pthread.h... yes
checking for pthread_create... yes
checking convert -I options to -isystem... yes
checking whether to enable verbose strings... yes
checking whether to enable SSPI support (Windows native builds only)... no
checking whether to enable cryptographic authentication methods... yes
checking whether to support NTLM... yes
checking whether to enable NTLM delegation to winbind's helper... no
checking whether to enable TLS-SRP authentication... yes
checking whether to enable Unix domain sockets... auto
checking for struct sockaddr_un.sun_path... yes
checking whether to support cookies... yes
checking whether to support socketpair... yes
checking whether to support HTTP authentication... yes
checking whether to support DoH... yes
checking whether to support the MIME API... yes
checking whether to support date parsing... yes
checking whether to support netrc parsing... yes
checking whether to support progress-meter... yes
checking whether to support DNS shuffling... yes
checking whether to support curl_easy_option*... yes
checking whether to support alt-svc... yes
checking whether to support headers-api... yes
configure: disables HSTS due to lack of SSL
checking whether to support WebSockets... no
checking whether hiding of library internal symbols will actually happen... yes
checking that generated files are newer than configure... done
configure: creating ./config.status
config.status: creating Makefile
config.status: creating docs/Makefile
config.status: creating docs/examples/Makefile
config.status: creating docs/libcurl/Makefile
config.status: creating docs/libcurl/opts/Makefile
config.status: creating docs/cmdline-opts/Makefile
config.status: creating include/Makefile
config.status: creating include/curl/Makefile
config.status: creating src/Makefile
config.status: creating lib/Makefile
config.status: creating scripts/Makefile
config.status: creating lib/libcurl.vers
config.status: creating lib/libcurl.plist
config.status: creating tests/Makefile
config.status: creating tests/certs/Makefile
config.status: creating tests/certs/scripts/Makefile
config.status: creating tests/data/Makefile
config.status: creating tests/server/Makefile
config.status: creating tests/libtest/Makefile
config.status: creating tests/unit/Makefile
config.status: creating packages/Makefile
config.status: creating packages/vms/Makefile
config.status: creating curl-config
config.status: creating libcurl.pc
config.status: creating lib/curl_config.h
config.status: executing depfiles commands
config.status: executing libtool commands
configure: amending lib/Makefile
configure: amending src/Makefile
configure: amending tests/unit/Makefile
configure: amending tests/server/Makefile
configure: amending tests/libtest/Makefile
configure: amending docs/examples/Makefile
configure: Configured to build curl/libcurl:

  Host setup:       x86_64-pc-linux-gnu
  Install prefix:   /usr/local
  Compiler:         ccache gcc
   CFLAGS:          -Werror-implicit-function-declaration -O2 -Wno-system-headers
   CPPFLAGS:        
   LDFLAGS:         
   LIBS:            -lpsl -lz

  curl version:     7.86.0-DEV
  SSL:              no      (--with-{openssl,gnutls,nss,mbedtls,wolfssl,schannel,secure-transport,amissl,bearssl,rustls} )
  SSH:              no      (--with-{libssh,libssh2})
  zlib:             enabled
  brotli:           no      (--with-brotli)
  zstd:             no      (--with-zstd)
  GSS-API:          no      (--with-gssapi)
  GSASL:            no      (libgsasl not found)
  TLS-SRP:          no      (--enable-tls-srp)
  resolver:         POSIX threaded
  IPv6:             enabled
  Unix sockets:     enabled
  IDN:              no      (--with-{libidn2,winidn})
  Build libcurl:    Shared=no, Static=yes
  Built-in manual:  enabled
  --libcurl option: enabled (--disable-libcurl-option)
  Verbose errors:   enabled (--disable-verbose)
  Code coverage:    disabled
  SSPI:             no      (--enable-sspi)
  ca cert bundle:   no
  ca cert path:     
  ca fallback:      
  LDAP:             no      (--enable-ldap / --with-ldap-lib / --with-lber-lib)
  LDAPS:            no      (--enable-ldaps)
  RTSP:             enabled
  RTMP:             no      (--with-librtmp)
  PSL:              enabled
  Alt-svc:          enabled (--disable-alt-svc)
  Headers API:      enabled (--disable-headers-api)
  HSTS:             no      (--enable-hsts)
  HTTP1:            enabled (internal)
  HTTP2:            no      (--with-nghttp2, --with-hyper)
  HTTP3:            no      (--with-ngtcp2, --with-quiche --with-msh3)
  ECH:              no      (--enable-ech)
  WebSockets:       no      (--enable-websockets)
  Protocols:        DICT FILE FTP GOPHER HTTP IMAP MQTT POP3 RTSP SMTP TELNET TFTP
  Features:         AsynchDNS IPv6 Largefile PSL UnixSockets alt-svc libz threadsafe

configure: WARNING: unrecognized options: --disable-docs
configure: WARNING: Cannot find libraries for LDAP support: LDAP disabled
configure: WARNING: libgsasl was not found
configure: WARNING: Cannot find libraries for IDN support: IDN disabled
configure: WARNING: unrecognized options: --disable-docs

$ make -j3
Making all in lib
make[1]: Entering directory '/root/asi_db/builds/curl/_worktrees/w0/lib'
make  all-am
make[2]: Entering directory '/root/asi_db/builds/curl/_worktrees/w0/lib'
  CC       libcurl_la-altsvc.lo
  CC       libcurl_la-amigaos.lo
  CC       libcurl_la-asyn-ares.lo
  CC       libcurl_la-asyn-thread.lo
  CC       libcurl_la-base64.lo
  CC       libcurl_la-bufref.lo
  CC       libcurl_la-c-hyper.lo
  CC       libcurl_la-conncache.lo
  CC       libcurl_la-connect.lo
  CC       libcurl_la-content_encoding.lo
  CC       libcurl_la-cookie.lo
  CC       libcurl_la-curl_addrinfo.lo
  CC       libcurl_la-curl_des.lo
  CC       libcurl_la-curl_endian.lo
  CC       libcurl_la-curl_fnmatch.lo
  CC       libcurl_la-curl_get_line.lo
  CC       libcurl_la-curl_gethostname.lo
  CC       libcurl_la-curl_gssapi.lo
  CC       libcurl_la-curl_memrchr.lo
  CC       libcurl_la-curl_multibyte.lo
  CC       libcurl_la-curl_ntlm_core.lo
  CC       libcurl_la-curl_ntlm_wb.lo
  CC       libcurl_la-curl_path.lo
  CC       libcurl_la-curl_range.lo
  CC       libcurl_la-curl_rtmp.lo
  CC       libcurl_la-curl_sasl.lo
  CC       libcurl_la-curl_sspi.lo
  CC       libcurl_la-curl_threads.lo
  CC       libcurl_la-dict.lo
  CC       libcurl_la-doh.lo
  CC       libcurl_la-dynbuf.lo
  CC       libcurl_la-easy.lo
  CC       libcurl_la-easygetopt.lo
  CC       libcurl_la-easyoptions.lo
  CC       libcurl_la-escape.lo
  CC       libcurl_la-file.lo
  CC       libcurl_la-fileinfo.lo
  CC       libcurl_la-fopen.lo
  CC       libcurl_la-formdata.lo
  CC       libcurl_la-ftp.lo
  CC       libcurl_la-ftplistparser.lo
  CC       libcurl_la-getenv.lo
  CC       libcurl_la-getinfo.lo
  CC       libcurl_la-gopher.lo
  CC       libcurl_la-h2h3.lo
  CC       libcurl_la-hash.lo
  CC       libcurl_la-headers.lo
  CC       libcurl_la-hmac.lo
  CC       libcurl_la-hostasyn.lo
  CC       libcurl_la-hostip.lo
  CC       libcurl_la-hostip4.lo
  CC       libcurl_la-hostip6.lo
  CC       libcurl_la-hostsyn.lo
  CC       libcurl_la-hsts.lo
  CC       libcurl_la-http.lo
  CC       libcurl_la-http2.lo
  CC       libcurl_la-http_chunks.lo
  CC       libcurl_la-http_digest.lo
  CC       libcurl_la-http_negotiate.lo
  CC       libcurl_la-http_ntlm.lo
  CC       libcurl_la-http_proxy.lo
  CC       libcurl_la-http_aws_sigv4.lo
  CC       libcurl_la-idn_win32.lo
  CC       libcurl_la-if2ip.lo
  CC       libcurl_la-imap.lo
  CC       libcurl_la-inet_ntop.lo
  CC       libcurl_la-inet_pton.lo
  CC       libcurl_la-krb5.lo
  CC       libcurl_la-ldap.lo
  CC       libcurl_la-llist.lo
  CC       libcurl_la-md4.lo
  CC       libcurl_la-md5.lo
  CC       libcurl_la-memdebug.lo
  CC       libcurl_la-mime.lo
  CC       libcurl_la-mprintf.lo
  CC       libcurl_la-mqtt.lo
  CC       libcurl_la-multi.lo
  CC       libcurl_la-netrc.lo
  CC       libcurl_la-nonblock.lo
  CC       libcurl_la-openldap.lo
  CC       libcurl_la-parsedate.lo
  CC       libcurl_la-pingpong.lo
  CC       libcurl_la-pop3.lo
  CC       libcurl_la-progress.lo
  CC       libcurl_la-psl.lo
  CC       libcurl_la-rand.lo
  CC       libcurl_la-rename.lo
  CC       libcurl_la-rtsp.lo
  CC       libcurl_la-select.lo
  CC       libcurl_la-sendf.lo
  CC       libcurl_la-setopt.lo
  CC       libcurl_la-sha256.lo
  CC       libcurl_la-share.lo
  CC       libcurl_la-slist.lo
  CC       libcurl_la-smb.lo
  CC       libcurl_la-smtp.lo
  CC       libcurl_la-socketpair.lo
  CC       libcurl_la-socks.lo
  CC       libcurl_la-socks_gssapi.lo
  CC       libcurl_la-socks_sspi.lo
  CC       libcurl_la-speedcheck.lo
  CC       libcurl_la-splay.lo
  CC       libcurl_la-strcase.lo
  CC       libcurl_la-strdup.lo
  CC       libcurl_la-strerror.lo
  CC       libcurl_la-strtok.lo
  CC       libcurl_la-strtoofft.lo
  CC       libcurl_la-system_win32.lo
  CC       libcurl_la-telnet.lo
  CC       libcurl_la-tftp.lo
  CC       libcurl_la-timediff.lo
  CC       libcurl_la-timeval.lo
  CC       libcurl_la-transfer.lo
  CC       libcurl_la-url.lo
  CC       libcurl_la-urlapi.lo
  CC       libcurl_la-version.lo
  CC       libcurl_la-version_win32.lo
  CC       libcurl_la-warnless.lo
  CC       libcurl_la-wildcard.lo
  CC       libcurl_la-ws.lo
  CC       vauth/libcurl_la-cleartext.lo
  CC       vauth/libcurl_la-cram.lo
  CC       vauth/libcurl_la-digest.lo
  CC       vauth/libcurl_la-digest_sspi.lo
  CC       vauth/libcurl_la-gsasl.lo
  CC       vauth/libcurl_la-krb5_gssapi.lo
  CC       vauth/libcurl_la-krb5_sspi.lo
  CC       vauth/libcurl_la-ntlm.lo
  CC       vauth/libcurl_la-ntlm_sspi.lo
  CC       vauth/libcurl_la-oauth2.lo
  CC       vauth/libcurl_la-spnego_gssapi.lo
  CC       vauth/libcurl_la-spnego_sspi.lo
  CC       vauth/libcurl_la-vauth.lo
  CC       vtls/libcurl_la-bearssl.lo
  CC       vtls/libcurl_la-gskit.lo
  CC       vtls/libcurl_la-gtls.lo
  CC       vtls/libcurl_la-hostcheck.lo
  CC       vtls/libcurl_la-keylog.lo
  CC       vtls/libcurl_la-mbedtls.lo
  CC       vtls/libcurl_la-mbedtls_threadlock.lo
  CC       vtls/libcurl_la-nss.lo
  CC       vtls/libcurl_la-openssl.lo
  CC       vtls/libcurl_la-rustls.lo
  CC       vtls/libcurl_la-schannel.lo
  CC       vtls/libcurl_la-schannel_verify.lo
  CC       vtls/libcurl_la-sectransp.lo
  CC       vtls/libcurl_la-vtls.lo
  CC       vtls/libcurl_la-wolfssl.lo
  CC       vtls/libcurl_la-x509asn1.lo
  CC       vquic/libcurl_la-msh3.lo
  CC       vquic/libcurl_la-ngtcp2.lo
  CC       vquic/libcurl_la-quiche.lo
  CC       vquic/libcurl_la-vquic.lo
  CC       vssh/libcurl_la-libssh.lo
  CC       vssh/libcurl_la-libssh2.lo
  CC       vssh/libcurl_la-wolfssh.lo
  CCLD     libcurl.la
make[2]: Leaving directory '/root/asi_db/builds/curl/_worktrees/w0/lib'
make[1]: Leaving directory '/root/asi_db/builds/curl/_worktrees/w0/lib'
Making all in src
make[1]: Entering directory '/root/asi_db/builds/curl/_worktrees/w0/src'
Making all in ../docs
make[2]: Entering directory '/root/asi_db/builds/curl/_worktrees/w0/docs'
Making all in .
make[3]: Entering directory '/root/asi_db/builds/curl/_worktrees/w0/docs'
if test "..x" != "..x" -a -e "./curl.1"; then \
	/usr/bin/install -c -m 644 "./curl.1" /root/asi_db/builds/curl/_worktrees/w0/docs/curl.1; fi
cd cmdline-opts && make
make[4]: Entering directory '/root/asi_db/builds/curl/_worktrees/w0/docs/cmdline-opts'
generate ../../docs/curl.1
make[4]: Leaving directory '/root/asi_db/builds/curl/_worktrees/w0/docs/cmdline-opts'
make[3]: Leaving directory '/root/asi_db/builds/curl/_worktrees/w0/docs'
Making all in cmdline-opts
make[3]: Entering directory '/root/asi_db/builds/curl/_worktrees/w0/docs/cmdline-opts'
make[3]: Nothing to be done for 'all'.
make[3]: Leaving directory '/root/asi_db/builds/curl/_worktrees/w0/docs/cmdline-opts'
make[2]: Leaving directory '/root/asi_db/builds/curl/_worktrees/w0/docs'
make[2]: Entering directory '/root/asi_db/builds/curl/_worktrees/w0/src'
  CC       slist_wc.o
  CC       tool_binmode.o
  CC       tool_bname.o
  CC       tool_cb_dbg.o
  CC       tool_cb_hdr.o
  CC       tool_cb_prg.o
  CC       tool_cb_rea.o
  CC       tool_cb_see.o
  CC       tool_cb_wrt.o
  CC       tool_cfgable.o
  CC       tool_dirhie.o
  CC       tool_doswin.o
  CC       tool_easysrc.o
  CC       tool_filetime.o
  CC       tool_findfile.o
  CC       tool_formparse.o
  CC       tool_getparam.o
  CC       tool_getpass.o
  CC       tool_help.o
  HUGE     tool_hugehelp.c
  CC       tool_helpers.o
  CC       tool_libinfo.o
  CC       tool_listhelp.o
  CC       tool_main.o
  CC       tool_msgs.o
  CC       tool_operate.o
  CC       tool_operhlp.o
  CC       tool_panykey.o
  CC       tool_parsecfg.o
  CC       tool_paramhlp.o
  CC       tool_progress.o
  CC       tool_strdup.o
  CC       tool_setopt.o
  CC       tool_sleep.o
  CC       tool_urlglob.o
  CC       tool_util.o
  CC       tool_vms.o
  CC       tool_writeout.o
  CC       tool_writeout_json.o
  CC       tool_xattr.o
  CC       ../lib/strtoofft.o
  CC       ../lib/timediff.o
  CC       ../lib/nonblock.o
  CC       ../lib/warnless.o
  CC       ../lib/curl_multibyte.o
  CC       ../lib/version_win32.o
  CC       ../lib/dynbuf.o
  CC       tool_hugehelp.o
  CCLD     curl
make[2]: Leaving directory '/root/asi_db/builds/curl/_worktrees/w0/src'
make[1]: Leaving directory '/root/asi_db/builds/curl/_worktrees/w0/src'
make[1]: Entering directory '/root/asi_db/builds/curl/_worktrees/w0'
make[1]: Nothing to be done for 'all-am'.
make[1]: Leaving directory '/root/asi_db/builds/curl/_worktrees/w0'

Commit Diff GitHub →

docs/cmdline-opts/MANPAGE.md +10 -8docs/cmdline-opts/abstract-unix-socket.d +1 -0docs/cmdline-opts/alt-svc.d +1 -0docs/cmdline-opts/anyauth.d +1 -0docs/cmdline-opts/append.d +1 -0docs/cmdline-opts/aws-sigv4.d +1 -0docs/cmdline-opts/basic.d +1 -0docs/cmdline-opts/cacert.d +1 -2docs/cmdline-opts/capath.d +2 -2docs/cmdline-opts/cert-status.d +3 -2docs/cmdline-opts/cert-type.d +1 -2docs/cmdline-opts/cert.d +1 -2docs/cmdline-opts/ciphers.d +1 -2docs/cmdline-opts/compressed-ssh.d +1 -0docs/cmdline-opts/compressed.d +1 -0docs/cmdline-opts/config.d +1 -2docs/cmdline-opts/connect-timeout.d +1 -2docs/cmdline-opts/connect-to.d +1 -2docs/cmdline-opts/continue-at.d +1 -2docs/cmdline-opts/cookie-jar.d +1 -3docs/cmdline-opts/cookie.d +1 -2docs/cmdline-opts/create-dirs.d +1 -0docs/cmdline-opts/create-file-mode.d +1 -2docs/cmdline-opts/crlf.d +1 -0docs/cmdline-opts/crlfile.d +1 -2docs/cmdline-opts/curves.d +1 -0docs/cmdline-opts/data-ascii.d +1 -0docs/cmdline-opts/data-binary.d +1 -0docs/cmdline-opts/data-raw.d +1 -0docs/cmdline-opts/data-urlencode.d +1 -0docs/cmdline-opts/data.d +1 -0docs/cmdline-opts/delegation.d +1 -2docs/cmdline-opts/digest.d +1 -2docs/cmdline-opts/disable-eprt.d +1 -0docs/cmdline-opts/disable-epsv.d +1 -0docs/cmdline-opts/disable.d +1 -0docs/cmdline-opts/disallow-username-in-url.d +1 -0docs/cmdline-opts/dns-interface.d +1 -0docs/cmdline-opts/dns-ipv4-addr.d +1 -2docs/cmdline-opts/dns-ipv6-addr.d +1 -2docs/cmdline-opts/dns-servers.d +1 -2docs/cmdline-opts/doh-cert-status.d +1 -0docs/cmdline-opts/doh-insecure.d +1 -0docs/cmdline-opts/doh-url.d +1 -2docs/cmdline-opts/dump-header.d +1 -2docs/cmdline-opts/egd-file.d +1 -0docs/cmdline-opts/engine.d +1 -0docs/cmdline-opts/etag-compare.d +1 -0docs/cmdline-opts/etag-save.d +1 -0docs/cmdline-opts/expect100-timeout.d +1 -0docs/cmdline-opts/fail-early.d +1 -0docs/cmdline-opts/fail-with-body.d +1 -0docs/cmdline-opts/fail.d +1 -0docs/cmdline-opts/false-start.d +1 -0docs/cmdline-opts/form-escape.d +1 -0docs/cmdline-opts/form-string.d +1 -0docs/cmdline-opts/form.d +1 -2docs/cmdline-opts/ftp-account.d +1 -2docs/cmdline-opts/ftp-alternative-to-user.d +1 -0docs/cmdline-opts/ftp-create-dirs.d +1 -0docs/cmdline-opts/ftp-method.d +1 -0docs/cmdline-opts/ftp-pasv.d +3 -3docs/cmdline-opts/ftp-port.d +3 -3docs/cmdline-opts/ftp-pret.d +1 -0docs/cmdline-opts/ftp-skip-pasv-ip.d +1 -0docs/cmdline-opts/ftp-ssl-ccc-mode.d +1 -0docs/cmdline-opts/ftp-ssl-ccc.d +1 -0docs/cmdline-opts/ftp-ssl-control.d +1 -0docs/cmdline-opts/gen.pl +38 -0docs/cmdline-opts/get.d +1 -4docs/cmdline-opts/globoff.d +1 -0docs/cmdline-opts/happy-eyeballs-timeout-ms.d +1 -2docs/cmdline-opts/haproxy-protocol.d +1 -0docs/cmdline-opts/head.d +1 -0docs/cmdline-opts/header.d +1 -2docs/cmdline-opts/help.d +1 -0docs/cmdline-opts/hostpubmd5.d +1 -0docs/cmdline-opts/hostpubsha256.d +1 -0docs/cmdline-opts/hsts.d +1 -0docs/cmdline-opts/http0.9.d +1 -0docs/cmdline-opts/http1.0.d +1 -0docs/cmdline-opts/http1.1.d +1 -0docs/cmdline-opts/http2-prior-knowledge.d +1 -0docs/cmdline-opts/http2.d +1 -0docs/cmdline-opts/http3.d +2 -2docs/cmdline-opts/ignore-content-length.d +1 -0docs/cmdline-opts/include.d +1 -0docs/cmdline-opts/insecure.d +1 -0docs/cmdline-opts/interface.d +1 -2docs/cmdline-opts/ipv4.d +1 -0docs/cmdline-opts/ipv6.d +1 -0docs/cmdline-opts/json.d +1 -0docs/cmdline-opts/junk-session-cookies.d +1 -0docs/cmdline-opts/keepalive-time.d +2 -2docs/cmdline-opts/key-type.d +1 -2docs/cmdline-opts/key.d +1 -2docs/cmdline-opts/krb.d +1 -2docs/cmdline-opts/libcurl.d +1 -3docs/cmdline-opts/limit-rate.d +1 -2docs/cmdline-opts/list-only.d +1 -0docs/cmdline-opts/local-port.d +1 -0docs/cmdline-opts/location-trusted.d +1 -0docs/cmdline-opts/location.d +1 -0docs/cmdline-opts/login-options.d +1 -2docs/cmdline-opts/mail-auth.d +1 -0docs/cmdline-opts/mail-from.d +1 -0docs/cmdline-opts/mail-rcpt-allowfails.d +1 -0docs/cmdline-opts/mail-rcpt.d +1 -0docs/cmdline-opts/manual.d +1 -0docs/cmdline-opts/max-filesize.d +1 -0docs/cmdline-opts/max-redirs.d +1 -2docs/cmdline-opts/max-time.d +1 -2docs/cmdline-opts/metalink.d +1 -0docs/cmdline-opts/negotiate.d +1 -0docs/cmdline-opts/netrc-file.d +2 -2docs/cmdline-opts/netrc-optional.d +1 -0docs/cmdline-opts/netrc.d +1 -0docs/cmdline-opts/next.d +1 -0docs/cmdline-opts/no-alpn.d +1 -0docs/cmdline-opts/no-buffer.d +1 -3docs/cmdline-opts/no-clobber.d +1 -0docs/cmdline-opts/no-keepalive.d +1 -0docs/cmdline-opts/no-npn.d +1 -0docs/cmdline-opts/no-progress-meter.d +1 -0docs/cmdline-opts/no-sessionid.d +1 -0docs/cmdline-opts/noproxy.d +1 -0docs/cmdline-opts/ntlm-wb.d +1 -0docs/cmdline-opts/ntlm.d +1 -0docs/cmdline-opts/oauth2-bearer.d +1 -2docs/cmdline-opts/output-dir.d +1 -4docs/cmdline-opts/output.d +1 -0docs/cmdline-opts/parallel-immediate.d +1 -0docs/cmdline-opts/parallel-max.d +1 -0docs/cmdline-opts/parallel.d +1 -0docs/cmdline-opts/pass.d +1 -2docs/cmdline-opts/path-as-is.d +1 -0docs/cmdline-opts/pinnedpubkey.d +1 -2docs/cmdline-opts/post301.d +1 -0docs/cmdline-opts/post302.d +1 -0docs/cmdline-opts/post303.d +1 -0docs/cmdline-opts/preproxy.d +1 -2docs/cmdline-opts/progress-bar.d +1 -0docs/cmdline-opts/proto-default.d +1 -0docs/cmdline-opts/proto-redir.d +1 -0docs/cmdline-opts/proto.d +1 -0docs/cmdline-opts/proxy-anyauth.d +1 -0docs/cmdline-opts/proxy-basic.d +1 -0docs/cmdline-opts/proxy-cacert.d +1 -0docs/cmdline-opts/proxy-capath.d +1 -0docs/cmdline-opts/proxy-cert-type.d +1 -0docs/cmdline-opts/proxy-cert.d +1 -0docs/cmdline-opts/proxy-ciphers.d +1 -0docs/cmdline-opts/proxy-crlfile.d +1 -0docs/cmdline-opts/proxy-digest.d +1 -0docs/cmdline-opts/proxy-header.d +1 -0docs/cmdline-opts/proxy-insecure.d +1 -0docs/cmdline-opts/proxy-key-type.d +1 -0docs/cmdline-opts/proxy-key.d +1 -0docs/cmdline-opts/proxy-negotiate.d +1 -0docs/cmdline-opts/proxy-ntlm.d +1 -0docs/cmdline-opts/proxy-pass.d +1 -0docs/cmdline-opts/proxy-pinnedpubkey.d +1 -2docs/cmdline-opts/proxy-service-name.d +1 -0docs/cmdline-opts/proxy-ssl-allow-beast.d +1 -0docs/cmdline-opts/proxy-ssl-auto-client-cert.d +1 -0docs/cmdline-opts/proxy-tls13-ciphers.d +1 -2docs/cmdline-opts/proxy-tlsauthtype.d +1 -0docs/cmdline-opts/proxy-tlspassword.d +1 -0docs/cmdline-opts/proxy-tlsuser.d +1 -0docs/cmdline-opts/proxy-tlsv1.d +1 -0docs/cmdline-opts/proxy-user.d +1 -2docs/cmdline-opts/proxy.d +1 -2docs/cmdline-opts/proxy1.0.d +1 -0docs/cmdline-opts/proxytunnel.d +1 -0docs/cmdline-opts/pubkey.d +1 -2docs/cmdline-opts/quote.d +1 -0docs/cmdline-opts/random-file.d +1 -0docs/cmdline-opts/range.d +1 -2docs/cmdline-opts/rate.d +1 -2docs/cmdline-opts/raw.d +1 -0docs/cmdline-opts/referer.d +1 -2docs/cmdline-opts/remote-header-name.d +1 -0docs/cmdline-opts/remote-name-all.d +1 -0docs/cmdline-opts/remote-name.d +1 -0docs/cmdline-opts/remote-time.d +1 -0docs/cmdline-opts/remove-on-error.d +1 -0docs/cmdline-opts/request-target.d +1 -0docs/cmdline-opts/request.d +1 -2docs/cmdline-opts/resolve.d +1 -0docs/cmdline-opts/retry-all-errors.d +1 -0docs/cmdline-opts/retry-connrefused.d +1 -0docs/cmdline-opts/retry-delay.d +1 -2docs/cmdline-opts/retry-max-time.d +1 -2docs/cmdline-opts/retry.d +1 -2docs/cmdline-opts/sasl-authzid.d +1 -0docs/cmdline-opts/sasl-ir.d +1 -0docs/cmdline-opts/service-name.d +1 -0docs/cmdline-opts/show-error.d +1 -0docs/cmdline-opts/silent.d +1 -0docs/cmdline-opts/socks4.d +1 -2docs/cmdline-opts/socks4a.d +1 -2docs/cmdline-opts/socks5-basic.d +1 -0docs/cmdline-opts/socks5-gssapi-nec.d +1 -0docs/cmdline-opts/socks5-gssapi-service.d +1 -0docs/cmdline-opts/socks5-gssapi.d +1 -0docs/cmdline-opts/socks5-hostname.d +1 -2docs/cmdline-opts/socks5.d +1 -2docs/cmdline-opts/speed-limit.d +1 -2docs/cmdline-opts/speed-time.d +1 -2docs/cmdline-opts/ssl-allow-beast.d +1 -0docs/cmdline-opts/ssl-auto-client-cert.d +1 -0docs/cmdline-opts/ssl-no-revoke.d +1 -0docs/cmdline-opts/ssl-reqd.d +1 -0docs/cmdline-opts/ssl-revoke-best-effort.d +1 -0docs/cmdline-opts/ssl.d +1 -0docs/cmdline-opts/sslv2.d +1 -0docs/cmdline-opts/sslv3.d +1 -0docs/cmdline-opts/stderr.d +1 -2docs/cmdline-opts/styled-output.d +1 -0docs/cmdline-opts/suppress-connect-headers.d +1 -0docs/cmdline-opts/tcp-fastopen.d +1 -0docs/cmdline-opts/tcp-nodelay.d +1 -0docs/cmdline-opts/telnet-option.d +1 -0docs/cmdline-opts/tftp-blksize.d +1 -2docs/cmdline-opts/tftp-no-options.d +1 -0docs/cmdline-opts/time-cond.d +1 -2docs/cmdline-opts/tls-max.d +1 -0docs/cmdline-opts/tls13-ciphers.d +1 -2docs/cmdline-opts/tlsauthtype.d +1 -0docs/cmdline-opts/tlspassword.d +1 -0docs/cmdline-opts/tlsuser.d +1 -0docs/cmdline-opts/tlsv1.0.d +1 -0docs/cmdline-opts/tlsv1.1.d +1 -0docs/cmdline-opts/tlsv1.2.d +1 -0docs/cmdline-opts/tlsv1.3.d +1 -0docs/cmdline-opts/tlsv1.d +1 -0docs/cmdline-opts/tr-encoding.d +1 -0docs/cmdline-opts/trace-ascii.d +1 -2docs/cmdline-opts/trace-time.d +1 -0docs/cmdline-opts/trace.d +1 -2docs/cmdline-opts/unix-socket.d +1 -0docs/cmdline-opts/upload-file.d +1 -0docs/cmdline-opts/url.d +3 -2docs/cmdline-opts/use-ascii.d +1 -0docs/cmdline-opts/user-agent.d +1 -2docs/cmdline-opts/user.d +1 -2docs/cmdline-opts/verbose.d +1 -0docs/cmdline-opts/version.d +1 -0docs/cmdline-opts/write-out.d +1 -1docs/cmdline-opts/xattr.d +1 -0
docs/cmdline-opts/MANPAGE.md+10 -8
@@ -23,20 +23,22 @@ Each file has a set of meta-data and a body of text.
### Meta-data
- Short: (single letter, without dash)
- Long: (long form name, without dashes)
+ Added: (version number in which this was added)
Arg: (the argument the option takes)
+ c: (copyright line)
+ Example: (example command line, without "curl" and can use `$URL`)
+ Experimental: yes (if so)
+ Help: (short text for the --help output for this option)
+ Long: (long form name, without dashes)
Magic: (description of "magic" options)
- Tags: (space separated list)
- Protocols: (space separated list for which protocols this option works)
- Added: (version number in which this was added)
+ Multi: single/append/boolean/mutex (if used more than once)
Mutexed: (space separated list of options this overrides, no dashes)
+ Protocols: (space separated list for which protocols this option works)
Requires: (space separated list of features this requires, no dashes)
See-also: (space separated list of related options, no dashes)
- Help: (short text for the --help output for this option)
- Example: (example command line, without "curl" and can use `$URL`)
- c: (copyright line)
+ Short: (single letter, without dash)
SPDX-License-Identifier: curl
+ Tags: (space separated list)
--- (end of meta-data)
### Body
docs/cmdline-opts/abstract-unix-socket.d+1 -0
@@ -8,6 +8,7 @@ Protocols: HTTP
Category: connection
See-also: unix-socket
Example: --abstract-unix-socket socketpath $URL
+Multi: single
---
Connect through an abstract Unix domain socket, instead of using the network.
Note: netstat shows the path of an abstract socket prefixed with '@', however
docs/cmdline-opts/alt-svc.d+1 -0
@@ -8,6 +8,7 @@ Added: 7.64.1
Category: http
See-also: resolve connect-to
Example: --alt-svc svc.txt $URL
+Multi: append
---
This option enables the alt-svc parser in curl. If the file name points to an
existing alt-svc cache file, that will be used. After a completed transfer,
docs/cmdline-opts/anyauth.d+1 -0
@@ -7,6 +7,7 @@ See-also: proxy-anyauth basic digest
Category: http proxy auth
Example: --anyauth --user me:pwd $URL
Added: 7.10.6
+Multi: mutex
---
Tells curl to figure out authentication method by itself, and use the most
secure one the remote site claims to support. This is done by first doing a
docs/cmdline-opts/append.d+1 -0
@@ -8,6 +8,7 @@ Category: ftp sftp
See-also: range continue-at
Example: --upload-file local --append ftp://example.com/
Added: 4.8
+Multi: boolean
---
When used in an upload, this makes curl append to the target file instead of
overwriting it. If the remote file does not exist, it will be created. Note
docs/cmdline-opts/aws-sigv4.d+1 -0
@@ -7,6 +7,7 @@ Category: auth http
Added: 7.75.0
See-also: basic user
Example: --aws-sigv4 "aws:amz:east-2:es" --user "key:secret" $URL
+Multi: single
---
Use AWS V4 signature authentication in the transfer.
docs/cmdline-opts/basic.d+1 -0
@@ -7,6 +7,7 @@ Protocols: HTTP
Category: auth
Example: -u name:password --basic $URL
Added: 7.10.6
+Multi: mutex
---
Tells curl to use HTTP Basic authentication with the remote host. This is the
default and this option is usually pointless, unless you use it to override a
docs/cmdline-opts/cacert.d+1 -2
@@ -8,6 +8,7 @@ Category: tls
See-also: capath insecure
Example: --cacert CA-file.txt $URL
Added: 7.5
+Multi: single
---
Tells curl to use the specified certificate file to verify the peer. The file
may contain multiple CA certificates. The certificate(s) must be in PEM
@@ -35,5 +36,3 @@ preferred method of verifying the peer's certificate chain.
with libcurl 7.60 or later. This option is supported for backward
compatibility with other SSL engines; instead it is recommended to use
Windows' store of root certificates (the default for Schannel).
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/capath.d+2 -2
@@ -8,6 +8,7 @@ Category: tls
See-also: cacert insecure
Example: --capath /local/directory $URL
Added: 7.9.8
+Multi: single
---
Tells curl to use the specified certificate directory to verify the
peer. Multiple paths can be provided by separating them with ":" (e.g.
@@ -17,5 +18,4 @@ c_rehash utility supplied with OpenSSL. Using --capath can allow
OpenSSL-powered curl to make SSL-connections much more efficiently than using
--cacert if the --cacert file contains many CA certificates.
-If this option is set, the default capath value will be ignored, and if it is
-used several times, the last one will be used.
+If this option is set, the default capath value will be ignored.
docs/cmdline-opts/cert-status.d+3 -2
@@ -7,12 +7,13 @@ Help: Verify the status of the server cert via OCSP-staple
Category: tls
See-also: pinnedpubkey
Example: --cert-status $URL
+Multi: boolean
---
Tells curl to verify the status of the server certificate by using the
Certificate Status Request (aka. OCSP stapling) TLS extension.
If this option is enabled and the server sends an invalid (e.g. expired)
-response, if the response suggests that the server certificate has been revoked,
-or no response at all is received, the verification fails.
+response, if the response suggests that the server certificate has been
+revoked, or no response at all is received, the verification fails.
This is currently only implemented in the OpenSSL, GnuTLS and NSS backends.
docs/cmdline-opts/cert-type.d+1 -2
@@ -8,6 +8,7 @@ See-also: cert key key-type
Category: tls
Example: --cert-type PEM --cert file $URL
Added: 7.9.3
+Multi: single
---
Tells curl what type the provided client certificate is using. PEM, DER, ENG
and P12 are recognized types.
@@ -15,5 +16,3 @@ and P12 are recognized types.
The default type depends on the TLS backend and is usually PEM, however for
Secure Transport and Schannel it is P12. If --cert is a pkcs11: URI then ENG is
the default type.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/cert.d+1 -2
@@ -9,6 +9,7 @@ See-also: cert-type key key-type
Category: tls
Example: --cert certfile --key keyfile $URL
Added: 5.0
+Multi: single
---
Tells curl to use the specified client certificate file when getting a file
with HTTPS, FTPS or another SSL-based protocol. The certificate must be in
@@ -55,5 +56,3 @@ usually a SHA-1 hex string which you can see in certificate details. Following
store locations are supported: CurrentUser, LocalMachine, CurrentService,
Services, CurrentUserGroupPolicy, LocalMachineGroupPolicy,
LocalMachineEnterprise.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/ciphers.d+1 -2
@@ -8,10 +8,9 @@ Category: tls
See-also: tlsv1.3
Example: --ciphers ECDHE-ECDSA-AES256-CCM8 $URL
Added: 7.9
+Multi: single
---
Specifies which ciphers to use in the connection. The list of ciphers must
specify valid ciphers. Read up on SSL cipher list details on this URL:
https://curl.se/docs/ssl-ciphers.html
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/compressed-ssh.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.56.0
Category: scp ssh
See-also: compressed
Example: --compressed-ssh sftp://example.com/
+Multi: boolean
---
Enables built-in SSH compression.
This is a request, not an order; the server may or may not do it.
docs/cmdline-opts/compressed.d+1 -0
@@ -7,6 +7,7 @@ Category: http
Example: --compressed $URL
See-also: compressed-ssh
Added: 7.10
+Multi: boolean
---
Request a compressed response using one of the algorithms curl supports, and
automatically decompress the content. Headers are not modified.
docs/cmdline-opts/config.d+1 -2
@@ -8,6 +8,7 @@ Category: curl
Example: --config file.txt $URL
Added: 4.10
See-also: disable
+Multi: append
---
Specify a text file to read curl arguments from. The command line arguments
found in the text file will be used as if they were provided on the command
@@ -73,5 +74,3 @@ checks for one in the same dir the curl executable is placed.
On Windows two filenames are checked per location: .curlrc and _curlrc,
preferring the former. Older versions on Windows checked for _curlrc only.
-
-This option can be used multiple times to load multiple config files.
docs/cmdline-opts/connect-timeout.d+1 -2
@@ -8,10 +8,9 @@ Category: connection
Example: --connect-timeout 20 $URL
Example: --connect-timeout 3.14 $URL
Added: 7.7
+Multi: single
---
Maximum time in seconds that you allow curl's connection to take. This only
limits the connection phase, so if curl connects within the given period it
will continue - if not it will exit. Since version 7.32.0, this option
accepts decimal values.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/connect-to.d+1 -2
@@ -7,6 +7,7 @@ Added: 7.49.0
See-also: resolve header
Category: connection
Example: --connect-to example.com:443:example.net:8443 $URL
+Multi: append
---
For a request to the given HOST1:PORT1 pair, connect to HOST2:PORT2 instead.
@@ -21,5 +22,3 @@ request's original host/port".
A "host" specified to this option is compared as a string, so it needs to
match the name used in request URL. It can be either numerical such as
"127.0.0.1" or the full host name such as "example.org".
-
-This option can be used many times to add many connect rules.
docs/cmdline-opts/continue-at.d+1 -2
@@ -9,6 +9,7 @@ Category: connection
Example: -C - $URL
Example: -C 400 $URL
Added: 4.8
+Multi: single
---
Continue/Resume a previous file transfer at the given offset. The given offset
is the exact number of bytes that will be skipped, counting from the beginning
@@ -17,5 +18,3 @@ uploads, the FTP server command SIZE will not be used by curl.
Use "-C -" to tell curl to automatically find out where/how to resume the
transfer. It then uses the given output/input files to figure that out.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/cookie-jar.d+1 -3
@@ -10,6 +10,7 @@ Example: -c store-here.txt $URL
Example: -c store-here.txt -b read-these $URL
Added: 7.9
See-also: cookie
+Multi: single
---
Specify to which file you want curl to write all cookies after a completed
operation. Curl writes all cookies from its in-memory cookie storage to the
@@ -26,6 +27,3 @@ If the cookie jar cannot be created or written to, the whole curl operation
will not fail or even report an error clearly. Using --verbose will get a
warning displayed, but that is the only visible feedback you get about this
possibly lethal situation.
-
-If this option is used several times, the last specified file name will be
-used.
docs/cmdline-opts/cookie.d+1 -2
@@ -10,6 +10,7 @@ Example: -b cookiefile $URL
Example: -b cookiefile -c cookiefile $URL
See-also: cookie-jar junk-session-cookies
Added: 4.9
+Multi: append
---
Pass the data to the HTTP server in the Cookie header. It is supposedly the
data previously received from the server in a "Set-Cookie:" line. The data
@@ -36,8 +37,6 @@ cookie is not sent since the domain will never match. To address this, set a
domain in Set-Cookie line (doing that will include sub-domains) or preferably:
use the Netscape format.
-This option can be used multiple times.
-
Users often want to both read cookies from a file and write updated cookies
back to a file, so using both --cookie and --cookie-jar in the same command
line is common.
docs/cmdline-opts/create-dirs.d+1 -0
@@ -6,6 +6,7 @@ Category: curl
Example: --create-dirs --output local/dir/file $URL
Added: 7.10.3
See-also: ftp-create-dirs output-dir
+Multi: boolean
---
When used in conjunction with the --output option, curl will create the
necessary local directory hierarchy as needed. This option creates the
docs/cmdline-opts/create-file-mode.d+1 -2
@@ -8,11 +8,10 @@ Category: sftp scp file upload
See-also: ftp-create-dirs
Added: 7.75.0
Example: --create-file-mode 0777 -T localfile sftp://example.com/new
+Multi: single
---
When curl is used to create files remotely using one of the supported
protocols, this option allows the user to set which 'mode' to set on the file
at creation time, instead of the default 0644.
This option takes an octal number as argument.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/crlf.d+1 -0
@@ -7,6 +7,7 @@ Category: ftp smtp
Example: --crlf -T file ftp://example.com/
Added: 5.7
See-also: use-ascii
+Multi: boolean
---
Convert LF to CRLF in upload. Useful for MVS (OS/390).
docs/cmdline-opts/crlfile.d+1 -2
@@ -8,8 +8,7 @@ Added: 7.19.7
Category: tls
Example: --crlfile rejects.txt $URL
See-also: cacert capath
+Multi: single
---
Provide a file using PEM format with a Certificate Revocation List that may
specify peer certificates that are to be considered revoked.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/curves.d+1 -0
@@ -8,6 +8,7 @@ Added: 7.73.0
Category: tls
Example: --curves X25519 $URL
See-also: ciphers
+Multi: single
---
Tells curl to request specific curves to use during SSL session establishment
according to RFC 8422, 5.1. Multiple algorithms can be provided by separating
docs/cmdline-opts/data-ascii.d+1 -0
@@ -8,5 +8,6 @@ Category: http post upload
Example: --data-ascii @file $URL
Added: 7.2
See-also: data-binary data-raw data-urlencode
+Multi: append
---
This is just an alias for --data.
docs/cmdline-opts/data-binary.d+1 -0
@@ -8,6 +8,7 @@ Category: http post upload
Example: --data-binary @filename $URL
Added: 7.2
See-also: data-ascii
+Multi: append
---
This posts data exactly as specified with no extra processing whatsoever.
docs/cmdline-opts/data-raw.d+1 -0
@@ -9,6 +9,7 @@ See-also: data
Category: http post upload
Example: --data-raw "hello" $URL
Example: --data-raw "@at@at@" $URL
+Multi: append
---
This posts data similarly to --data but without the special
interpretation of the @ character.
docs/cmdline-opts/data-urlencode.d+1 -0
@@ -11,6 +11,7 @@ Example: --data-urlencode name=val $URL
Example: --data-urlencode =encodethis $URL
Example: --data-urlencode name@file $URL
Example: --data-urlencode @fileonly $URL
+Multi: append
---
This posts data, similar to the other --data options with the exception
that this performs URL-encoding.
docs/cmdline-opts/data.d+1 -0
@@ -12,6 +12,7 @@ Example: -d "name=curl" $URL
Example: -d "name=curl" -d "tool=cmdline" $URL
Example: -d @filename $URL
Added: 4.0
+Multi: append
---
Sends the specified data in a POST request to the HTTP server, in the same way
that a browser does when a user has filled in an HTML form and presses the
docs/cmdline-opts/delegation.d+1 -2
@@ -8,6 +8,7 @@ Category: auth
Example: --delegation "none" $URL
Added: 7.22.0
See-also: insecure ssl
+Multi: single
---
Set LEVEL to tell the server what it is allowed to delegate when it
comes to user credentials.
@@ -20,5 +21,3 @@ service ticket, which is a matter of realm policy.
.IP "always"
Unconditionally allow the server to delegate.
.RE
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/digest.d+1 -2
@@ -8,9 +8,8 @@ See-also: user proxy-digest anyauth
Category: proxy auth http
Example: -u name:password --digest $URL
Added: 7.10.6
+Multi: boolean
---
Enables HTTP Digest authentication. This is an authentication scheme that
prevents the password from being sent over the wire in clear text. Use this in
combination with the normal --user option to set user name and password.
-
-If this option is used several times, only the first one is used.
docs/cmdline-opts/disable-eprt.d+1 -0
@@ -7,6 +7,7 @@ Category: ftp
Example: --disable-eprt ftp://example.com/
Added: 7.10.5
See-also: disable-epsv ftp-port
+Multi: boolean
---
Tell curl to disable the use of the EPRT and LPRT commands when doing active
FTP transfers. Curl will normally always first attempt to use EPRT, then LPRT
docs/cmdline-opts/disable-epsv.d+1 -0
@@ -7,6 +7,7 @@ Category: ftp
Example: --disable-epsv ftp://example.com/
Added: 7.9.2
See-also: disable-eprt ftp-port
+Multi: boolean
---
Tell curl to disable the use of the EPSV command when doing passive FTP
transfers. Curl will normally always first attempt to use EPSV before
docs/cmdline-opts/disable.d+1 -0
@@ -7,6 +7,7 @@ Category: curl
Example: -q $URL
Added: 5.0
See-also: config
+Multi: boolean
---
If used as the first parameter on the command line, the *curlrc* config
file will not be read and used. See the --config for details on the default
docs/cmdline-opts/disallow-username-in-url.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.61.0
See-also: proto
Category: curl http
Example: --disallow-username-in-url $URL
+Multi: boolean
---
This tells curl to exit if passed a URL containing a username. This is probably
most useful when the URL is being provided at runtime or similar.
docs/cmdline-opts/dns-interface.d+1 -0
@@ -9,6 +9,7 @@ Added: 7.33.0
Requires: c-ares
Category: dns
Example: --dns-interface eth0 $URL
+Multi: single
---
Tell curl to send outgoing DNS requests through <interface>. This option is a
counterpart to --interface (which does not affect DNS). The supplied string
docs/cmdline-opts/dns-ipv4-addr.d+1 -2
@@ -9,9 +9,8 @@ Added: 7.33.0
Requires: c-ares
Category: dns
Example: --dns-ipv4-addr 10.1.2.3 $URL
+Multi: single
---
Tell curl to bind to <ip-address> when making IPv4 DNS requests, so that
the DNS requests originate from this address. The argument should be a
single IPv4 address.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/dns-ipv6-addr.d+1 -2
@@ -9,9 +9,8 @@ Added: 7.33.0
Requires: c-ares
Category: dns
Example: --dns-ipv6-addr 2a04:4e42::561 $URL
+Multi: single
---
Tell curl to bind to <ip-address> when making IPv6 DNS requests, so that
the DNS requests originate from this address. The argument should be a
single IPv6 address.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/dns-servers.d+1 -2
@@ -8,10 +8,9 @@ Added: 7.33.0
Category: dns
Example: --dns-servers 192.168.0.1,192.168.0.2 $URL
See-also: dns-interface dns-ipv4-addr
+Multi: single
---
Set the list of DNS servers to be used instead of the system default.
The list of IP addresses should be separated with commas. Port numbers
may also optionally be given as *:<port-number>* after each IP
address.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/doh-cert-status.d+1 -0
@@ -6,5 +6,6 @@ Added: 7.76.0
Category: dns tls
Example: --doh-cert-status --doh-url https://doh.example $URL
See-also: doh-insecure
+Multi: boolean
---
Same as --cert-status but used for DoH (DNS-over-HTTPS).
docs/cmdline-opts/doh-insecure.d+1 -0
@@ -6,5 +6,6 @@ Added: 7.76.0
Category: dns tls
Example: --doh-insecure --doh-url https://doh.example $URL
See-also: doh-url
+Multi: boolean
---
Same as --insecure but used for DoH (DNS-over-HTTPS).
docs/cmdline-opts/doh-url.d+1 -2
@@ -7,6 +7,7 @@ Added: 7.62.0
Category: dns
Example: --doh-url https://doh.example $URL
See-also: doh-insecure
+Multi: single
---
Specifies which DNS-over-HTTPS (DoH) server to use to resolve hostnames,
instead of using the default name resolver mechanism. The URL must be HTTPS.
@@ -18,5 +19,3 @@ settings are not inherited and can be controlled separately via
This option is unset if an empty string "" is used as the URL. (Added in
7.85.0)
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/dump-header.d+1 -2
@@ -9,11 +9,10 @@ See-also: output
Category: http ftp
Example: --dump-header store.txt $URL
Added: 5.7
+Multi: single
---
Write the received protocol headers to the specified file. If no headers are
received, the use of this option will create an empty file.
When used in FTP, the FTP server response lines are considered being "headers"
and thus are saved there.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/egd-file.d+1 -0
@@ -8,6 +8,7 @@ See-also: random-file
Category: tls
Example: --egd-file /random/here $URL
Added: 7.7
+Multi: single
---
Deprecated option. This option is ignored by curl since 7.84.0. Prior to that
it only had an effect on curl if built to use old versions of OpenSSL.
docs/cmdline-opts/engine.d+1 -0
@@ -8,6 +8,7 @@ Category: tls
Example: --engine flavor $URL
Added: 7.9.3
See-also: ciphers curves
+Multi: single
---
Select the OpenSSL crypto engine to use for cipher operations. Use --engine
list to print a list of build-time supported engines. Note that not all (and
docs/cmdline-opts/etag-compare.d+1 -0
@@ -8,6 +8,7 @@ Added: 7.68.0
Category: http
Example: --etag-compare etag.txt $URL
See-also: etag-save time-cond
+Multi: single
---
This option makes a conditional HTTP request for the specific ETag read
from the given file by sending a custom If-None-Match header using the
docs/cmdline-opts/etag-save.d+1 -0
@@ -8,6 +8,7 @@ Added: 7.68.0
Category: http
Example: --etag-save storetag.txt $URL
See-also: etag-compare
+Multi: single
---
This option saves an HTTP ETag to the specified file. An ETag is a
caching related header, usually returned in a response.
docs/cmdline-opts/expect100-timeout.d+1 -0
@@ -8,6 +8,7 @@ Added: 7.47.0
See-also: connect-timeout
Category: http
Example: --expect100-timeout 2.5 -T file $URL
+Multi: single
---
Maximum time in seconds that you allow curl to wait for a 100-continue
response when curl emits an Expects: 100-continue header in its request. By
docs/cmdline-opts/fail-early.d+1 -0
@@ -6,6 +6,7 @@ Added: 7.52.0
Category: curl
Example: --fail-early $URL https://two.example
See-also: fail fail-with-body
+Multi: boolean
---
Fail and exit on the first detected transfer error.
docs/cmdline-opts/fail-with-body.d+1 -0
@@ -8,6 +8,7 @@ Added: 7.76.0
See-also: fail
Mutexed: fail
Example: --fail-with-body $URL
+Multi: boolean
---
Return an error on server errors where the HTTP response code is 400 or
greater). In normal cases when an HTTP server fails to deliver a document, it
docs/cmdline-opts/fail.d+1 -0
@@ -9,6 +9,7 @@ Category: important http
Example: --fail $URL
Mutexed: fail-with-body
Added: 4.0
+Multi: boolean
---
Fail fast with no output at all on server errors. This is useful to enable
scripts and users to better deal with failed attempts. In normal cases when an
docs/cmdline-opts/false-start.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.42.0
Category: tls
Example: --false-start $URL
See-also: tcp-fastopen
+Multi: boolean
---
Tells curl to use false start during the TLS handshake. False start is a mode
where a TLS client will start sending application data before verifying the
docs/cmdline-opts/form-escape.d+1 -0
@@ -7,6 +7,7 @@ See-also: form
Added: 7.81.0
Category: http upload
Example: --form-escape -F 'field\\name=curl' -F 'file=@load"this' $URL
+Multi: single
---
Tells curl to pass on names of multipart form fields and files using
backslash-escaping instead of percent-encoding.
docs/cmdline-opts/form-string.d+1 -0
@@ -8,6 +8,7 @@ See-also: form
Category: http upload
Example: --form-string "data" $URL
Added: 7.13.2
+Multi: append
---
Similar to --form except that the value string for the named parameter is used
literally. Leading '@' and '<' characters, and the ';type=' string in
docs/cmdline-opts/form.d+1 -2
@@ -10,6 +10,7 @@ Category: http upload
Example: --form "name=curl" --form "file=@loadthis" $URL
Added: 5.0
See-also: data form-string form-escape
+Multi: append
---
For HTTP protocol family, this lets curl emulate a filled-in form in which a
user has pressed the submit button. This causes curl to POST data using the
@@ -132,5 +133,3 @@ base64 attached file:
-F '=@localfile;encoder=base64' ... smtp://example.com
See further examples and details in the MANUAL.
-
-This option can be used multiple times.
docs/cmdline-opts/ftp-account.d+1 -2
@@ -8,8 +8,7 @@ Added: 7.13.0
Category: ftp auth
Example: --ftp-account "mr.robot" ftp://example.com/
See-also: user
+Multi: single
---
When an FTP server asks for "account data" after user name and password has
been provided, this data is sent off using the ACCT command.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/ftp-alternative-to-user.d+1 -0
@@ -8,6 +8,7 @@ Added: 7.15.5
Category: ftp
Example: --ftp-alternative-to-user "U53r" ftp://example.com
See-also: ftp-account user
+Multi: single
---
If authenticating with the USER and PASS commands fails, send this command.
When connecting to Tumbleweed's Secure Transport server over FTPS using a
docs/cmdline-opts/ftp-create-dirs.d+1 -0
@@ -7,6 +7,7 @@ See-also: create-dirs
Category: ftp sftp curl
Example: --ftp-create-dirs -T file ftp://example.com/remote/path/file
Added: 7.10.7
+Multi: boolean
---
When an FTP or SFTP URL/operation uses a path that does not currently exist on
the server, the standard behavior of curl is to fail. Using this option, curl
docs/cmdline-opts/ftp-method.d+1 -0
@@ -10,6 +10,7 @@ Example: --ftp-method multicwd ftp://example.com/dir1/dir2/file
Example: --ftp-method nocwd ftp://example.com/dir1/dir2/file
Example: --ftp-method singlecwd ftp://example.com/dir1/dir2/file
See-also: list-only
+Multi: single
---
Control what method curl should use to reach a file on an FTP(S)
server. The method argument should be one of the following alternatives:
docs/cmdline-opts/ftp-pasv.d+3 -3
@@ -7,14 +7,14 @@ Added: 7.11.0
See-also: disable-epsv
Category: ftp
Example: --ftp-pasv ftp://example.com/
+Multi: boolean
---
Use passive mode for the data connection. Passive is the internal default
behavior, but using this option can be used to override a previous --ftp-port
option.
-If this option is used several times, only the first one is used. Undoing an
-enforced passive really is not doable but you must then instead enforce the
-correct --ftp-port again.
+Reversing an enforced passive really is not doable but you must then instead
+enforce the correct --ftp-port again.
Passive mode means that curl will try the EPSV command first and then PASV,
unless --disable-epsv is used.
docs/cmdline-opts/ftp-port.d+3 -3
@@ -11,6 +11,7 @@ Example: -P - ftp:/example.com
Example: -P eth0 ftp:/example.com
Example: -P 192.168.0.2 ftp:/example.com
Added: 4.0
+Multi: single
---
Reverses the default initiator/listener roles when connecting with FTP. This
option makes curl use active mode. curl then tells the server to connect back
@@ -29,9 +30,8 @@ make curl pick the same IP address that is already used for the control
connection
.RE
-If this option is used several times, the last one will be used. Disable the
-use of PORT with --ftp-pasv. Disable the attempt to use the EPRT command
-instead of PORT by using --disable-eprt. EPRT is really PORT++.
+Disable the use of PORT with --ftp-pasv. Disable the attempt to use the EPRT
+command instead of PORT by using --disable-eprt. EPRT is really PORT++.
You can also append ":[start]-[end]\&" to the right of the address, to tell
curl what TCP port range to use. That means you specify a port range, from a
docs/cmdline-opts/ftp-pret.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.20.0
Category: ftp
Example: --ftp-pret ftp://example.com/
See-also: ftp-port ftp-pasv
+Multi: boolean
---
Tell curl to send a PRET command before PASV (and EPSV). Certain FTP servers,
mainly drftpd, require this non-standard command for directory listings as
docs/cmdline-opts/ftp-skip-pasv-ip.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.14.2
See-also: ftp-pasv
Category: ftp
Example: --ftp-skip-pasv-ip ftp://example.com/
+Multi: boolean
---
Tell curl to not use the IP address the server suggests in its response
to curl's PASV command when curl connects the data connection. Instead curl
docs/cmdline-opts/ftp-ssl-ccc-mode.d+1 -0
@@ -8,6 +8,7 @@ Added: 7.16.2
See-also: ftp-ssl-ccc
Category: ftp tls
Example: --ftp-ssl-ccc-mode active --ftp-ssl-ccc ftps://example.com/
+Multi: boolean
---
Sets the CCC mode. The passive mode will not initiate the shutdown, but
instead wait for the server to do it, and will not reply to the shutdown from
docs/cmdline-opts/ftp-ssl-ccc.d+1 -0
@@ -7,6 +7,7 @@ See-also: ssl ftp-ssl-ccc-mode
Added: 7.16.1
Category: ftp tls
Example: --ftp-ssl-ccc ftps://example.com/
+Multi: boolean
---
Use CCC (Clear Command Channel) Shuts down the SSL/TLS layer after
authenticating. The rest of the control channel communication will be
docs/cmdline-opts/ftp-ssl-control.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.16.0
Category: ftp tls
Example: --ftp-ssl-control ftp://example.com
See-also: ssl
+Multi: boolean
---
Require SSL/TLS for the FTP login, clear for transfer. Allows secure
authentication, but non-encrypted data transfers for efficiency. Fails the
docs/cmdline-opts/gen.pl+38 -0
@@ -204,6 +204,8 @@ sub single {
my @examples; # there can be more than one
my $magic; # cmdline special option
my $line;
+ my $multi;
+ my $experimental;
while(<F>) {
$line++;
if(/^Short: *(.)/i) {
@@ -242,6 +244,12 @@ sub single {
elsif(/^Example: *(.*)/i) {
push @examples, $1;
}
+ elsif(/^Multi: *(.*)/i) {
+ $multi=$1;
+ }
+ elsif(/^Experimental: yes/i) {
+ $experimental=1;
+ }
elsif(/^C: (.*)/i) {
$copyright=$1;
}
@@ -256,6 +264,10 @@ sub single {
print STDERR "ERROR: no 'Long:' in $f\n";
return 1;
}
+ if($multi !~ /(single|append|boolean|mutex)/) {
+ print STDERR "ERROR: bad 'Multi:' in $f\n";
+ return 1;
+ }
if(!$category) {
print STDERR "ERROR: no 'Category:' in $f\n";
return 2;
@@ -326,9 +338,35 @@ sub single {
print ".SH DESCRIPTION\n";
}
+ if($experimental) {
+ print "**WARNING**: this option is experimental. Do not use in production.\n\n";
+ }
+
printdesc(@desc);
undef @desc;
+ if($multi eq "single") {
+ print "\nIf --$long is provided several times, the last set ".
+ "value will be used.\n";
+ }
+ elsif($multi eq "append") {
+ print "\n--$long can be used several times in a command line\n";
+ }
+ elsif($multi eq "boolean") {
+ my $rev = "no-$long";
+ # for options that start with "no-" the reverse is then without
+ # the no- prefix
+ if($long =~ /^no-/) {
+ $rev = $long;
+ $rev =~ s/^no-//;
+ }
+ print "\nProviding --$long multiple times has no extra effect.\n".
+ "Disable it again with --$rev.\n";
+ }
+ elsif($multi eq "mutex") {
+ print "\nProviding --$long multiple times has no extra effect.\n";
+ }
+
my @foot;
if($seealso) {
my @m=split(/ /, $seealso);
docs/cmdline-opts/get.d+1 -4
@@ -9,6 +9,7 @@ Example: --get -d "tool=curl" -d "age=old" $URL
Example: --get -I -d "tool=curl" $URL
Added: 7.8.1
See-also: data request
+Multi: boolean
---
When used, this option will make all data specified with --data, --data-binary
or --data-urlencode to be used in an HTTP GET request instead of the POST
@@ -17,7 +18,3 @@ with a '?' separator.
If used in combination with --head, the POST data will instead be appended to
the URL with a HEAD request.
-
-If this option is used several times, only the first one is used. This is
-because undoing a GET does not make sense, but you should then instead enforce
-the alternative method you prefer.
docs/cmdline-opts/globoff.d+1 -0
@@ -7,6 +7,7 @@ Category: curl
Example: -g "https://example.com/{[]}}}}"
Added: 7.6
See-also: config disable
+Multi: boolean
---
This option switches off the "URL globbing parser". When you set this option,
you can specify URLs that contain the letters {}[] without having curl itself
docs/cmdline-opts/happy-eyeballs-timeout-ms.d+1 -2
@@ -7,6 +7,7 @@ Added: 7.59.0
Category: connection
Example: --happy-eyeballs-timeout-ms 500 $URL
See-also: max-time connect-timeout
+Multi: single
---
Happy Eyeballs is an algorithm that attempts to connect to both IPv4 and IPv6
addresses for dual-stack hosts, giving IPv6 a head-start of the specified
@@ -18,5 +19,3 @@ The range of suggested useful values is limited. Happy Eyeballs RFC 6555 says
"It is RECOMMENDED that connection attempts be paced 150-250 ms apart to
balance human factors against network load." libcurl currently defaults to
200 ms. Firefox and Chrome currently default to 300 ms.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/haproxy-protocol.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.60.0
Category: http proxy
Example: --haproxy-protocol $URL
See-also: proxy
+Multi: boolean
---
Send a HAProxy PROXY protocol v1 header at the beginning of the
connection. This is used by some load balancers and reverse proxies to
docs/cmdline-opts/head.d+1 -0
@@ -8,6 +8,7 @@ Category: http ftp file
Example: -I $URL
Added: 4.0
See-also: get verbose trace-ascii
+Multi: boolean
---
Fetch the headers only! HTTP-servers feature the command HEAD which this uses
to get nothing but the header of a document. When used on an FTP or FILE file,
docs/cmdline-opts/header.d+1 -2
@@ -11,6 +11,7 @@ Example: -H "X-First-Name: Joe" $URL
Example: -H "User-Agent: yes-please/2000" $URL
Example: -H "Host:" $URL
Added: 5.0
+Multi: append
---
Extra header to include in information sent. When used within an HTTP request,
it is added to the regular request headers.
@@ -53,5 +54,3 @@ with a request body, will make curl send the data using chunked encoding.
lead to the header being sent to other hosts than the original host, so
sensitive headers should be used with caution combined with following
redirects.
-
-This option can be used multiple times to add/replace/remove multiple headers.
docs/cmdline-opts/help.d+1 -0
@@ -8,6 +8,7 @@ Category: important curl
Example: --help all
Added: 4.0
See-also: verbose
+Multi: boolean
---
Usage help. This lists all commands of the <category>.
If no arg was provided, curl will display the most important
docs/cmdline-opts/hostpubmd5.d+1 -0
@@ -8,6 +8,7 @@ Added: 7.17.1
Category: sftp scp
Example: --hostpubmd5 e5c1c49020640a5ab0f2034854c321a8 sftp://example.com/
See-also: hostpubsha256
+Multi: single
---
Pass a string containing 32 hexadecimal digits. The string should
be the 128 bit MD5 checksum of the remote host's public key, curl will refuse
docs/cmdline-opts/hostpubsha256.d+1 -0
@@ -8,6 +8,7 @@ Added: 7.80.0
Category: sftp scp
Example: --hostpubsha256 NDVkMTQxMGQ1ODdmMjQ3MjczYjAyOTY5MmRkMjVmNDQ= sftp://example.com/
See-also: hostpubmd5
+Multi: single
---
Pass a string containing a Base64-encoded SHA256 hash of the remote
host's public key. Curl will refuse the connection with the host
docs/cmdline-opts/hsts.d+1 -0
@@ -8,6 +8,7 @@ Added: 7.74.0
Category: http
Example: --hsts cache.txt $URL
See-also: proto
+Multi: append
---
This option enables HSTS for the transfer. If the file name points to an
existing HSTS cache file, that will be used. After a completed transfer, the
docs/cmdline-opts/http0.9.d+1 -0
@@ -8,6 +8,7 @@ Category: http
Example: --http0.9 $URL
Added: 7.64.0
See-also: http1.1 http2 http3
+Multi: boolean
---
Tells curl to be fine with HTTP version 0.9 response.
docs/cmdline-opts/http1.0.d+1 -0
@@ -10,6 +10,7 @@ Help: Use HTTP 1.0
Category: http
Example: --http1.0 $URL
See-also: http0.9 http1.1
+Multi: mutex
---
Tells curl to use HTTP version 1.0 instead of using its internally preferred
HTTP version.
docs/cmdline-opts/http1.1.d+1 -0
@@ -9,5 +9,6 @@ Help: Use HTTP 1.1
Category: http
Example: --http1.1 $URL
See-also: http1.0 http0.9
+Multi: mutex
---
Tells curl to use HTTP version 1.1.
docs/cmdline-opts/http2-prior-knowledge.d+1 -0
@@ -10,6 +10,7 @@ Help: Use HTTP 2 without HTTP/1.1 Upgrade
Category: http
Example: --http2-prior-knowledge $URL
See-also: http2 http3
+Multi: boolean
---
Tells curl to issue its non-TLS HTTP requests using HTTP/2 without HTTP/1.1
Upgrade. It requires prior knowledge that the server supports HTTP/2 straight
docs/cmdline-opts/http2.d+1 -0
@@ -11,6 +11,7 @@ Help: Use HTTP 2
See-also: http1.1 http3
Category: http
Example: --http2 $URL
+Multi: mutex
---
Tells curl to use HTTP version 2.
docs/cmdline-opts/http3.d+2 -2
@@ -10,9 +10,9 @@ Help: Use HTTP v3
See-also: http1.1 http2
Category: http
Example: --http3 $URL
+Multi: mutex
+Experimental: yes
---
-**WARNING**: this option is experimental. Do not use in production.
-
Tells curl to use HTTP version 3 directly to the host and port number used in
the URL. A normal HTTP/3 transaction will be done to a host and then get
redirected via Alt-Svc, but this option allows a user to circumvent that when
docs/cmdline-opts/ignore-content-length.d+1 -0
@@ -7,6 +7,7 @@ Category: http ftp
Example: --ignore-content-length $URL
Added: 7.14.1
See-also: ftp-skip-pasv-ip
+Multi: boolean
---
For HTTP, Ignore the Content-Length header. This is particularly useful for
servers running Apache 1.x, which will report incorrect Content-Length for
docs/cmdline-opts/include.d+1 -0
@@ -7,6 +7,7 @@ See-also: verbose
Category: important verbose
Example: -i $URL
Added: 4.8
+Multi: boolean
---
Include the HTTP response headers in the output. The HTTP response headers can
include things like server name, cookies, date of the document, HTTP version
docs/cmdline-opts/insecure.d+1 -0
@@ -8,6 +8,7 @@ See-also: proxy-insecure cacert capath
Category: tls sftp scp
Example: --insecure $URL
Added: 7.10
+Multi: boolean
---
By default, every secure connection curl makes is verified to be secure before
the transfer takes place. This option makes curl skip the verification step
docs/cmdline-opts/interface.d+1 -2
@@ -7,14 +7,13 @@ See-also: dns-interface
Category: connection
Example: --interface eth0 $URL
Added: 7.3
+Multi: single
---
Perform an operation using a specified interface. You can enter interface
name, IP address or host name. An example could look like:
curl --interface eth0:1 https://www.example.com/
-If this option is used several times, the last one will be used.
-
On Linux it can be used to specify a VRF, but the binary needs to either
have CAP_NET_RAW or to be run as root. More information about Linux VRF:
https://www.kernel.org/doc/Documentation/networking/vrf.txt
docs/cmdline-opts/ipv4.d+1 -0
@@ -11,6 +11,7 @@ See-also: http1.1 http2
Help: Resolve names to IPv4 addresses
Category: connection dns
Example: --ipv4 $URL
+Multi: boolean
---
This option tells curl to use IPv4 addresses only, and not for example try
IPv6.
docs/cmdline-opts/ipv6.d+1 -0
@@ -11,6 +11,7 @@ See-also: http1.1 http2
Help: Resolve names to IPv6 addresses
Category: connection dns
Example: --ipv6 $URL
+Multi: boolean
---
This option tells curl to use IPv6 addresses only, and not for example try
IPv4.
docs/cmdline-opts/json.d+1 -0
@@ -12,6 +12,7 @@ Example: --json '{ "drink":' --json ' "coffe" }' $URL
Example: --json @prepared $URL
Example: --json @- $URL < json.txt
Added: 7.82.0
+Multi: append
---
Sends the specified JSON data in a POST request to the HTTP server. --json
works as a shortcut for passing on these three options:
docs/cmdline-opts/junk-session-cookies.d+1 -0
@@ -8,6 +8,7 @@ See-also: cookie cookie-jar
Category: http
Example: --junk-session-cookies -b cookies.txt $URL
Added: 7.9.7
+Multi: boolean
---
When curl is told to read cookies from a given file, this option will make it
discard all "session cookies". This will basically have the same effect as if
docs/cmdline-opts/keepalive-time.d+2 -2
@@ -7,6 +7,7 @@ Added: 7.18.0
Category: connection
Example: --keepalive-time 20 $URL
See-also: no-keepalive max-time
+Multi: single
---
This option sets the time a connection needs to remain idle before sending
keepalive probes and the time between individual keepalive probes. It is
@@ -17,5 +18,4 @@ connections. The number of missed keepalive probes before declaring the
connection down is OS dependent and is commonly 9 or 10. This option has no
effect if --no-keepalive is used.
-If this option is used several times, the last one will be used. If
-unspecified, the option defaults to 60 seconds.
+If unspecified, the option defaults to 60 seconds.
docs/cmdline-opts/key-type.d+1 -2
@@ -8,8 +8,7 @@ Category: tls
Example: --key-type DER --key here $URL
Added: 7.9.3
See-also: key
+Multi: single
---
Private key file type. Specify which type your --key provided private key
is. DER, PEM, and ENG are supported. If not specified, PEM is assumed.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/key.d+1 -2
@@ -8,6 +8,7 @@ Category: tls ssh
Example: --cert certificate --key here $URL
Added: 7.9.3
See-also: key-type cert
+Multi: single
---
Private key file name. Allows you to provide your private key in this separate
file. For SSH, if not specified, curl tries the following candidates in order:
@@ -24,5 +25,3 @@ If curl is built against Secure Transport or Schannel then this option is
ignored for TLS protocols (HTTPS, etc). Those backends expect the private key
to be already present in the keychain or PKCS#12 file containing the
certificate.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/krb.d+1 -2
@@ -9,9 +9,8 @@ Category: ftp
Example: --krb clear ftp://example.com/
Added: 7.3
See-also: delegation ssl
+Multi: single
---
Enable Kerberos authentication and use. The level must be entered and should
be one of 'clear', 'safe', 'confidential', or 'private'. Should you use a
level that is not one of these, 'private' will instead be used.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/libcurl.d+1 -3
@@ -7,6 +7,7 @@ Added: 7.16.1
Category: curl
Example: --libcurl client.c $URL
See-also: verbose
+Multi: single
---
Append this option to any ordinary curl command line, and you will get
libcurl-using C source code written to the file that does the equivalent
@@ -14,6 +15,3 @@ of what your command-line operation does!
This option is global and does not need to be specified for each use of
--next.
-
-If this option is used several times, the last given file name will be
-used.
docs/cmdline-opts/limit-rate.d+1 -2
@@ -9,6 +9,7 @@ Example: --limit-rate 1000 $URL
Example: --limit-rate 10M $URL
Added: 7.10
See-also: speed-limit speed-time
+Multi: single
---
Specify the maximum transfer rate you want curl to use - for both downloads
and uploads. This feature is useful if you have a limited pipe and you would like
@@ -26,5 +27,3 @@ the set threshold over a period of multiple seconds.
If you also use the --speed-limit option, that option will take precedence and
might cripple the rate-limiting slightly, to help keeping the speed-limit
logic working.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/list-only.d+1 -0
@@ -8,6 +8,7 @@ Added: 4.0
Category: ftp pop3
Example: --list-only ftp://example.com/dir/
See-also: quote request
+Multi: boolean
---
(FTP)
When listing an FTP directory, this switch forces a name-only view. This is
docs/cmdline-opts/local-port.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.15.2
Category: connection
Example: --local-port 1000-3000 $URL
See-also: globoff
+Multi: single
---
Set a preferred single number or range (FROM-TO) of local port numbers to use
for the connection(s). Note that port numbers by nature are a scarce resource
docs/cmdline-opts/location-trusted.d+1 -0
@@ -7,6 +7,7 @@ See-also: user
Category: http auth
Example: --location-trusted -u user:password $URL
Added: 7.10.4
+Multi: boolean
---
Like --location, but will allow sending the name + password to all hosts that
the site may redirect to. This may or may not introduce a security breach if
docs/cmdline-opts/location.d+1 -0
@@ -8,6 +8,7 @@ Category: http
Example: -L $URL
Added: 4.9
See-also: resolve alt-svc
+Multi: boolean
---
If the server reports that the requested page has moved to a different
location (indicated with a Location: header and a 3XX response code), this
docs/cmdline-opts/login-options.d+1 -2
@@ -8,6 +8,7 @@ Added: 7.34.0
Category: imap pop3 smtp auth
Example: --login-options 'AUTH=*' imap://example.com
See-also: user
+Multi: single
---
Specify the login options to use during server authentication.
@@ -15,5 +16,3 @@ You can use login options to specify protocol specific options that may be
used during authentication. At present only IMAP, POP3 and SMTP support
login options. For more information about login options please see RFC
2384, RFC 5092 and IETF draft draft-earhart-url-smtp-00.txt
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/mail-auth.d+1 -0
@@ -8,6 +8,7 @@ Added: 7.25.0
See-also: mail-rcpt mail-from
Category: smtp
Example: --mail-auth [email protected] -T mail smtp://example.com/
+Multi: single
---
Specify a single address. This will be used to specify the authentication
address (identity) of a submitted message that is being relayed to another
docs/cmdline-opts/mail-from.d+1 -0
@@ -8,5 +8,6 @@ Added: 7.20.0
See-also: mail-rcpt mail-auth
Category: smtp
Example: --mail-from [email protected] -T mail smtp://example.com/
+Multi: single
---
Specify a single address that the given mail should get sent from.
docs/cmdline-opts/mail-rcpt-allowfails.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.69.0
Category: smtp
Example: --mail-rcpt-allowfails --mail-rcpt [email protected] smtp://example.com
See-also: mail-rcpt
+Multi: boolean
---
When sending data to multiple recipients, by default curl will abort SMTP
conversation if at least one of the recipients causes RCPT TO command to
docs/cmdline-opts/mail-rcpt.d+1 -0
@@ -8,6 +8,7 @@ Added: 7.20.0
Category: smtp
Example: --mail-rcpt [email protected] smtp://example.com
See-also: mail-rcpt-allowfails
+Multi: append
---
Specify a single email address, user name or mailing list name. Repeat this
option several times to send to multiple recipients.
docs/cmdline-opts/manual.d+1 -0
@@ -7,5 +7,6 @@ Category: curl
Example: --manual
Added: 5.2
See-also: verbose libcurl trace
+Multi: boolean
---
Manual. Display the huge help text.
docs/cmdline-opts/max-filesize.d+1 -0
@@ -8,6 +8,7 @@ See-also: limit-rate
Category: connection
Example: --max-filesize 100K $URL
Added: 7.10.8
+Multi: single
---
Specify the maximum size (in bytes) of a file to download. If the file
requested is larger than this value, the transfer will not start and curl will
docs/cmdline-opts/max-redirs.d+1 -2
@@ -8,9 +8,8 @@ Category: http
Example: --max-redirs 3 --location $URL
Added: 7.5
See-also: location
+Multi: single
---
Set maximum number of redirections to follow. When --location is used, to
prevent curl from following too many redirects, by default, the limit is
set to 50 redirects. Set this option to -1 to make it unlimited.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/max-time.d+1 -2
@@ -9,6 +9,7 @@ Category: connection
Example: --max-time 10 $URL
Example: --max-time 2.92 $URL
Added: 4.0
+Multi: single
---
Maximum time in seconds that you allow each transfer to take. This is
useful for preventing your batch jobs from hanging for hours due to slow
@@ -19,5 +20,3 @@ timeout increases in decimal precision.
If you enable retrying the transfer (--retry) then the maximum time counter is
reset each time the transfer is retried. You can use --retry-max-time to limit
the retry time.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/metalink.d+1 -0
@@ -6,6 +6,7 @@ Added: 7.27.0
Category: misc
Example: --metalink file $URL
See-also: parallel
+Multi: single
---
This option was previously used to specify a metalink resource. Metalink
support has been disabled in curl since 7.78.0 for security reasons.
docs/cmdline-opts/negotiate.d+1 -0
@@ -7,6 +7,7 @@ See-also: basic ntlm anyauth proxy-negotiate
Category: auth http
Example: --negotiate -u : $URL
Added: 7.10.6
+Multi: mutex
---
Enables Negotiate (SPNEGO) authentication.
docs/cmdline-opts/netrc-file.d+2 -2
@@ -8,10 +8,10 @@ Mutexed: netrc
Category: curl
Example: --netrc-file netrc $URL
See-also: netrc user config
+Multi: single
---
This option is similar to --netrc, except that you provide the path (absolute
or relative) to the netrc file that curl should use. You can only specify one
-netrc file per invocation. If several --netrc-file options are provided,
-the last one will be used.
+netrc file per invocation.
It will abide by --netrc-optional if specified.
docs/cmdline-opts/netrc-optional.d+1 -0
@@ -7,6 +7,7 @@ See-also: netrc-file
Category: curl
Example: --netrc-optional $URL
Added: 7.9.8
+Multi: boolean
---
Similar to --netrc, but this option makes the .netrc usage **optional**
and not mandatory as the --netrc option does.
docs/cmdline-opts/netrc.d+1 -0
@@ -7,6 +7,7 @@ Category: curl
Example: --netrc $URL
Added: 4.6
See-also: netrc-file config user
+Multi: boolean
---
Makes curl scan the *.netrc* (*_netrc* on Windows) file in the user's home
directory for login name and password. This is typically used for FTP on
docs/cmdline-opts/next.d+1 -0
@@ -11,6 +11,7 @@ Category: curl
Example: $URL --next -d postthis www2.example.com
Example: -I $URL --next https://example.net/
See-also: parallel config
+Multi: append
---
Tells curl to use a separate operation for the following URL and associated
options. This allows you to send several URL requests, each with their own
docs/cmdline-opts/no-alpn.d+1 -0
@@ -9,6 +9,7 @@ Requires: TLS
Help: Disable the ALPN TLS extension
Category: tls http
Example: --no-alpn $URL
+Multi: boolean
---
Disable the ALPN TLS extension. ALPN is enabled by default if libcurl was built
with an SSL library that supports ALPN. ALPN is used by a libcurl that supports
docs/cmdline-opts/no-buffer.d+1 -3
@@ -7,11 +7,9 @@ Category: curl
Example: --no-buffer $URL
Added: 6.5
See-also: progress-bar
+Multi: boolean
---
Disables the buffering of the output stream. In normal work situations, curl
will use a standard buffered output stream that will have the effect that it
will output the data in chunks, not necessarily exactly when the data arrives.
Using this option will disable that buffering.
-
-Note that this is the negated option name documented. You can thus use
---buffer to enforce the buffering.
docs/cmdline-opts/no-clobber.d+1 -0
@@ -6,6 +6,7 @@ Category: curl output
Added: 7.83.0
See-also: output remote-name
Example: --no-clobber --output local/dir/file $URL
+Multi: boolean
---
When used in conjunction with the --output, --remote-header-name,
--remote-name, or --remote-name-all options, curl avoids overwriting files
docs/cmdline-opts/no-keepalive.d+1 -0
@@ -6,6 +6,7 @@ Category: connection
Example: --no-keepalive $URL
Added: 7.18.0
See-also: keepalive-time
+Multi: boolean
---
Disables the use of keepalive messages on the TCP connection. curl otherwise
enables them by default.
docs/cmdline-opts/no-npn.d+1 -0
@@ -10,6 +10,7 @@ Requires: TLS
Help: Disable the NPN TLS extension
Category: tls http
Example: --no-npn $URL
+Multi: boolean
---
In curl 7.86.0 and later, curl never uses NPN.
docs/cmdline-opts/no-progress-meter.d+1 -0
@@ -6,6 +6,7 @@ See-also: verbose silent
Added: 7.67.0
Category: verbose
Example: --no-progress-meter -o store $URL
+Multi: boolean
---
Option to switch off the progress meter output without muting or otherwise
affecting warning and informational messages like --silent does.
docs/cmdline-opts/no-sessionid.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.16.0
Category: tls
Example: --no-sessionid $URL
See-also: insecure
+Multi: boolean
---
Disable curl's use of SSL session-ID caching. By default all transfers are
done using the cache. Note that while nothing should ever get hurt by
docs/cmdline-opts/noproxy.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.19.4
Category: proxy
Example: --noproxy "www.example" $URL
See-also: proxy
+Multi: single
---
Comma-separated list of hosts for which not to use a proxy, if one is
specified. The only wildcard is a single * character, which matches all hosts,
docs/cmdline-opts/ntlm-wb.d+1 -0
@@ -7,6 +7,7 @@ See-also: ntlm proxy-ntlm
Category: auth http
Example: --ntlm-wb -u user:password $URL
Added: 7.22.0
+Multi: mutex
---
Enables NTLM much in the style --ntlm does, but hand over the authentication
to the separate binary ntlmauth application that is executed when needed.
docs/cmdline-opts/ntlm.d+1 -0
@@ -9,6 +9,7 @@ Requires: TLS
Category: auth http
Example: --ntlm -u user:password $URL
Added: 7.10.6
+Multi: mutex
---
Enables NTLM authentication. The NTLM authentication method was designed by
Microsoft and is used by IIS web servers. It is a proprietary protocol,
docs/cmdline-opts/oauth2-bearer.d+1 -2
@@ -8,11 +8,10 @@ Category: auth
Example: --oauth2-bearer "mF_9.B5f-4.1JqM" $URL
Added: 7.33.0
See-also: basic ntlm digest
+Multi: single
---
Specify the Bearer Token for OAUTH 2.0 server authentication. The Bearer Token
is used in conjunction with the user name which can be specified as part of
the --url or --user options.
The Bearer Token and user name are formatted according to RFC 6750.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/output-dir.d+1 -4
@@ -7,8 +7,8 @@ Added: 7.73.0
See-also: remote-name remote-header-name
Category: curl
Example: --output-dir "tmp" -O $URL
+Multi: single
---
-
This option specifies the directory in which files should be stored, when
--remote-name or --output are used.
@@ -17,6 +17,3 @@ command line, up until the first --next.
If the specified target directory does not exist, the operation will fail
unless --create-dirs is also used.
-
-If this option is used multiple times, the last specified directory will be
-used.
docs/cmdline-opts/output.d+1 -0
@@ -11,6 +11,7 @@ Example: "http://{one,two}.example.com" -o "file_#1.txt"
Example: "http://{site,host}.host[1-5].com" -o "#1_#2"
Example: -o file $URL -o file2 https://example.net
Added: 4.0
+Multi: append
---
Write output to <file> instead of stdout. If you are using {} or [] to fetch
multiple documents, you should quote the URL and you can use '#' followed by a
docs/cmdline-opts/parallel-immediate.d+1 -0
@@ -6,6 +6,7 @@ Added: 7.68.0
See-also: parallel parallel-max
Category: connection curl
Example: --parallel-immediate -Z $URL -o file1 $URL -o file2
+Multi: boolean
---
When doing parallel transfers, this option will instruct curl that it should
rather prefer opening up more connections in parallel at once rather than
docs/cmdline-opts/parallel-max.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.66.0
See-also: parallel
Category: connection curl
Example: --parallel-max 100 -Z $URL ftp://example.com/
+Multi: single
---
When asked to do parallel transfers, using --parallel, this option controls
the maximum amount of transfers to do simultaneously.
docs/cmdline-opts/parallel.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.66.0
Category: connection curl
Example: --parallel $URL -o file1 $URL -o file2
See-also: next verbose
+Multi: boolean
---
Makes curl perform its transfers in parallel as compared to the regular serial
manner.
docs/cmdline-opts/pass.d+1 -2
@@ -8,7 +8,6 @@ Category: ssh tls auth
Example: --pass secret --key file $URL
Added: 7.9.3
See-also: key user
+Multi: single
---
Passphrase for the private key.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/path-as-is.d+1 -0
@@ -6,6 +6,7 @@ Added: 7.42.0
Category: curl
Example: --path-as-is https://example.com/../../etc/passwd
See-also: request-target
+Multi: boolean
---
Tell curl to not handle sequences of /../ or /./ in the given URL
path. Normally curl will squash or merge them according to standards but with
docs/cmdline-opts/pinnedpubkey.d+1 -2
@@ -9,6 +9,7 @@ Example: --pinnedpubkey keyfile $URL
Example: --pinnedpubkey 'sha256//ce118b51897f4452dc' $URL
Added: 7.39.0
See-also: hostpubsha256
+Multi: single
---
Tells curl to use the specified public key file (or hashes) to verify the
peer. This can be a path to a file which contains a single public key in PEM
@@ -35,5 +36,3 @@ sha256 support:
7.47.0: mbedtls
Other SSL backends not supported.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/post301.d+1 -0
@@ -7,6 +7,7 @@ See-also: post302 post303 location
Added: 7.17.1
Category: http post
Example: --post301 --location -d "data" $URL
+Multi: boolean
---
Tells curl to respect RFC 7231/6.4.2 and not convert POST requests into GET
requests when following a 301 redirection. The non-RFC behavior is ubiquitous
docs/cmdline-opts/post302.d+1 -0
@@ -7,6 +7,7 @@ See-also: post301 post303 location
Added: 7.19.1
Category: http post
Example: --post302 --location -d "data" $URL
+Multi: boolean
---
Tells curl to respect RFC 7231/6.4.3 and not convert POST requests into GET
requests when following a 302 redirection. The non-RFC behavior is ubiquitous
docs/cmdline-opts/post303.d+1 -0
@@ -7,6 +7,7 @@ See-also: post302 post301 location
Added: 7.26.0
Category: http post
Example: --post303 --location -d "data" $URL
+Multi: boolean
---
Tells curl to violate RFC 7231/6.4.4 and not convert POST requests into GET
requests when following 303 redirections. A server may require a POST to
docs/cmdline-opts/preproxy.d+1 -2
@@ -7,6 +7,7 @@ Added: 7.52.0
Category: proxy
Example: --preproxy socks5://proxy.example -x http://http.example $URL
See-also: proxy socks5
+Multi: single
---
Use the specified SOCKS proxy before connecting to an HTTP or HTTPS --proxy. In
such a case curl first connects to the SOCKS proxy and then connects (through
@@ -23,5 +24,3 @@ If the port number is not specified in the proxy string, it is assumed to be
User and password that might be provided in the proxy string are URL decoded
by curl. This allows you to pass in special characters such as @ by using %40
or pass in a colon with %3a.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/progress-bar.d+1 -0
@@ -7,6 +7,7 @@ Category: verbose
Example: -# -O $URL
Added: 5.10
See-also: styled-output
+Multi: boolean
---
Make curl display transfer progress as a simple progress bar instead of the
standard, more informational, meter.
docs/cmdline-opts/proto-default.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.45.0
Category: connection curl
Example: --proto-default https ftp.example.com
See-also: proto proto-redir
+Multi: single
---
Tells curl to use *protocol* for any URL missing a scheme name.
docs/cmdline-opts/proto-redir.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.20.2
Category: connection curl
Example: --proto-redir =http,https $URL
See-also: proto
+Multi: single
---
Tells curl to limit what protocols it may use on redirect. Protocols denied by
--proto are not overridden by this option. See --proto for how protocols are
docs/cmdline-opts/proto.d+1 -0
@@ -7,6 +7,7 @@ See-also: proto-redir proto-default
Added: 7.20.2
Category: connection curl
Example: --proto =http,https,sftp $URL
+Multi: single
---
Tells curl to limit what protocols it may use for transfers. Protocols are
evaluated left to right, are comma separated, and are each a protocol name or
docs/cmdline-opts/proxy-anyauth.d+1 -0
@@ -6,6 +6,7 @@ Added: 7.13.2
See-also: proxy proxy-basic proxy-digest
Category: proxy auth
Example: --proxy-anyauth --proxy-user user:passwd -x proxy $URL
+Multi: mutex
---
Tells curl to pick a suitable authentication method when communicating with
the given HTTP proxy. This might cause an extra request/response round-trip.
docs/cmdline-opts/proxy-basic.d+1 -0
@@ -6,6 +6,7 @@ See-also: proxy proxy-anyauth proxy-digest
Category: proxy auth
Example: --proxy-basic --proxy-user user:passwd -x proxy $URL
Added: 7.12.0
+Multi: mutex
---
Tells curl to use HTTP Basic authentication when communicating with the given
proxy. Use --basic for enabling HTTP Basic with a remote host. Basic is the
docs/cmdline-opts/proxy-cacert.d+1 -0
@@ -7,5 +7,6 @@ Added: 7.52.0
See-also: proxy-capath cacert capath proxy
Category: proxy tls
Example: --proxy-cacert CA-file.txt -x https://proxy $URL
+Multi: single
---
Same as --cacert but used in HTTPS proxy context.
docs/cmdline-opts/proxy-capath.d+1 -0
@@ -7,5 +7,6 @@ Added: 7.52.0
See-also: proxy-cacert proxy capath
Category: proxy tls
Example: --proxy-capath /local/directory -x https://proxy $URL
+Multi: single
---
Same as --capath but used in HTTPS proxy context.
docs/cmdline-opts/proxy-cert-type.d+1 -0
@@ -7,5 +7,6 @@ Help: Client certificate type for HTTPS proxy
Category: proxy tls
Example: --proxy-cert-type PEM --proxy-cert file -x https://proxy $URL
See-also: proxy-cert
+Multi: single
---
Same as --cert-type but used in HTTPS proxy context.
docs/cmdline-opts/proxy-cert.d+1 -0
@@ -7,5 +7,6 @@ Added: 7.52.0
Category: proxy tls
Example: --proxy-cert file -x https://proxy $URL
See-also: proxy-cert-type
+Multi: single
---
Same as --cert but used in HTTPS proxy context.
docs/cmdline-opts/proxy-ciphers.d+1 -0
@@ -7,5 +7,6 @@ Added: 7.52.0
Category: proxy tls
Example: --proxy-ciphers ECDHE-ECDSA-AES256-CCM8 -x https://proxy $URL
See-also: ciphers curves proxy
+Multi: single
---
Same as --ciphers but used in HTTPS proxy context.
docs/cmdline-opts/proxy-crlfile.d+1 -0
@@ -7,5 +7,6 @@ Added: 7.52.0
Category: proxy tls
Example: --proxy-crlfile rejects.txt -x https://proxy $URL
See-also: crlfile proxy
+Multi: single
---
Same as --crlfile but used in HTTPS proxy context.
docs/cmdline-opts/proxy-digest.d+1 -0
@@ -6,6 +6,7 @@ See-also: proxy proxy-anyauth proxy-basic
Category: proxy tls
Example: --proxy-digest --proxy-user user:passwd -x proxy $URL
Added: 7.12.0
+Multi: mutex
---
Tells curl to use HTTP Digest authentication when communicating with the given
proxy. Use --digest for enabling HTTP Digest with a remote host.
docs/cmdline-opts/proxy-header.d+1 -0
@@ -10,6 +10,7 @@ Example: --proxy-header "X-First-Name: Joe" -x http://proxy $URL
Example: --proxy-header "User-Agent: surprise" -x http://proxy $URL
Example: --proxy-header "Host:" -x http://proxy $URL
See-also: proxy
+Multi: append
---
Extra header to include in the request when sending HTTP to a proxy. You may
specify any number of extra headers. This is the equivalent option to --header
docs/cmdline-opts/proxy-insecure.d+1 -0
@@ -6,5 +6,6 @@ Added: 7.52.0
Category: proxy tls
Example: --proxy-insecure -x https://proxy $URL
See-also: proxy insecure
+Multi: boolean
---
Same as --insecure but used in HTTPS proxy context.
docs/cmdline-opts/proxy-key-type.d+1 -0
@@ -7,5 +7,6 @@ Added: 7.52.0
Category: proxy tls
Example: --proxy-key-type DER --proxy-key here -x https://proxy $URL
See-also: proxy-key proxy
+Multi: single
---
Same as --key-type but used in HTTPS proxy context.
docs/cmdline-opts/proxy-key.d+1 -0
@@ -7,5 +7,6 @@ Category: proxy tls
Example: --proxy-key here -x https://proxy $URL
Added: 7.52.0
See-also: proxy-key-type proxy
+Multi: single
---
Same as --key but used in HTTPS proxy context.
docs/cmdline-opts/proxy-negotiate.d+1 -0
@@ -6,6 +6,7 @@ Added: 7.17.1
See-also: proxy-anyauth proxy-basic
Category: proxy auth
Example: --proxy-negotiate --proxy-user user:passwd -x proxy $URL
+Multi: mutex
---
Tells curl to use HTTP Negotiate (SPNEGO) authentication when communicating
with the given proxy. Use --negotiate for enabling HTTP Negotiate (SPNEGO)
docs/cmdline-opts/proxy-ntlm.d+1 -0
@@ -6,6 +6,7 @@ See-also: proxy-negotiate proxy-anyauth
Category: proxy auth
Example: --proxy-ntlm --proxy-user user:passwd -x http://proxy $URL
Added: 7.10.7
+Multi: mutex
---
Tells curl to use HTTP NTLM authentication when communicating with the given
proxy. Use --ntlm for enabling NTLM with a remote host.
docs/cmdline-opts/proxy-pass.d+1 -0
@@ -7,5 +7,6 @@ Added: 7.52.0
Category: proxy tls auth
Example: --proxy-pass secret --proxy-key here -x https://proxy $URL
See-also: proxy proxy-key
+Multi: single
---
Same as --pass but used in HTTPS proxy context.
docs/cmdline-opts/proxy-pinnedpubkey.d+1 -2
@@ -9,6 +9,7 @@ Example: --proxy-pinnedpubkey keyfile $URL
Example: --proxy-pinnedpubkey 'sha256//ce118b51897f4452dc' $URL
Added: 7.59.0
See-also: pinnedpubkey proxy
+Multi: single
---
Tells curl to use the specified public key file (or hashes) to verify the
proxy. This can be a path to a file which contains a single public key in PEM
@@ -19,5 +20,3 @@ When negotiating a TLS or SSL connection, the server sends a certificate
indicating its identity. A public key is extracted from this certificate and
if it does not exactly match the public key provided to this option, curl will
abort the connection before sending or receiving any data.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/proxy-service-name.d+1 -0
@@ -7,5 +7,6 @@ Added: 7.43.0
Category: proxy tls
Example: --proxy-service-name "shrubbery" -x proxy $URL
See-also: service-name proxy
+Multi: single
---
This option allows you to change the service name for proxy negotiation.
docs/cmdline-opts/proxy-ssl-allow-beast.d+1 -0
@@ -6,5 +6,6 @@ Added: 7.52.0
Category: proxy tls
Example: --proxy-ssl-allow-beast -x https://proxy $URL
See-also: ssl-allow-beast proxy
+Multi: boolean
---
Same as --ssl-allow-beast but used in HTTPS proxy context.
docs/cmdline-opts/proxy-ssl-auto-client-cert.d+1 -0
@@ -6,5 +6,6 @@ Added: 7.77.0
Category: proxy tls
Example: --proxy-ssl-auto-client-cert -x https://proxy $URL
See-also: ssl-auto-client-cert proxy
+Multi: boolean
---
Same as --ssl-auto-client-cert but used in HTTPS proxy context.
docs/cmdline-opts/proxy-tls13-ciphers.d+1 -2
@@ -8,6 +8,7 @@ Category: proxy tls
Example: --proxy-tls13-ciphers TLS_AES_128_GCM_SHA256 -x proxy $URL
Added: 7.61.0
See-also: tls13-ciphers curves
+Multi: single
---
Specifies which cipher suites to use in the connection to your HTTPS proxy
when it negotiates TLS 1.3. The list of ciphers suites must specify valid
@@ -18,5 +19,3 @@ ciphers. Read up on TLS 1.3 cipher suite details on this URL:
This option is currently used only when curl is built to use OpenSSL 1.1.1 or
later. If you are using a different SSL backend you can try setting TLS 1.3
cipher suites by using the --proxy-ciphers option.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/proxy-tlsauthtype.d+1 -0
@@ -7,5 +7,6 @@ Added: 7.52.0
Category: proxy tls auth
Example: --proxy-tlsauthtype SRP -x https://proxy $URL
See-also: proxy proxy-tlsuser
+Multi: single
---
Same as --tlsauthtype but used in HTTPS proxy context.
docs/cmdline-opts/proxy-tlspassword.d+1 -0
@@ -7,5 +7,6 @@ Added: 7.52.0
Category: proxy tls auth
Example: --proxy-tlspassword passwd -x https://proxy $URL
See-also: proxy proxy-tlsuser
+Multi: single
---
Same as --tlspassword but used in HTTPS proxy context.
docs/cmdline-opts/proxy-tlsuser.d+1 -0
@@ -7,5 +7,6 @@ Added: 7.52.0
Category: proxy tls auth
Example: --proxy-tlsuser smith -x https://proxy $URL
See-also: proxy proxy-tlspassword
+Multi: single
---
Same as --tlsuser but used in HTTPS proxy context.
docs/cmdline-opts/proxy-tlsv1.d+1 -0
@@ -6,5 +6,6 @@ Added: 7.52.0
Category: proxy tls auth
Example: --proxy-tlsv1 -x https://proxy $URL
See-also: proxy
+Multi: mutex
---
Same as --tlsv1 but used in HTTPS proxy context.
docs/cmdline-opts/proxy-user.d+1 -2
@@ -8,6 +8,7 @@ Category: proxy auth
Example: --proxy-user name:pwd -x proxy $URL
Added: 4.0
See-also: proxy-pass
+Multi: single
---
Specify the user name and password to use for proxy authentication.
@@ -20,5 +21,3 @@ process listings. This is not enough to protect credentials from possibly
getting seen by other users on the same system as they will still be visible
for a moment before cleared. Such sensitive data should be retrieved from a
file instead or similar and never used in clear text in a command line.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/proxy.d+1 -2
@@ -8,6 +8,7 @@ Category: proxy
Example: --proxy http://proxy.example $URL
Added: 4.0
See-also: socks5 proxy-basic
+Multi: single
---
Use the specified proxy.
@@ -44,5 +45,3 @@ or pass in a colon with %3a.
The proxy host can be specified the same way as the proxy environment
variables, including the protocol prefix (http://) and the embedded user +
password.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/proxy1.0.d+1 -0
@@ -7,6 +7,7 @@ Category: proxy
Example: --proxy1.0 -x http://proxy $URL
Added: 7.19.4
See-also: proxy socks5 preproxy
+Multi: mutex
---
Use the specified HTTP 1.0 proxy. If the port number is not specified, it is
assumed at port 1080.
docs/cmdline-opts/proxytunnel.d+1 -0
@@ -7,6 +7,7 @@ See-also: proxy
Category: proxy
Example: --proxytunnel -x http://proxy $URL
Added: 7.3
+Multi: boolean
---
When an HTTP proxy is used --proxy, this option will make curl tunnel through
the proxy. The tunnel approach is made with the HTTP proxy CONNECT request and
docs/cmdline-opts/pubkey.d+1 -2
@@ -8,12 +8,11 @@ Category: sftp scp auth
Example: --pubkey file.pub sftp://example.com/
Added: 7.16.2
See-also: pass
+Multi: single
---
Public key file name. Allows you to provide your public key in this separate
file.
-If this option is used several times, the last one will be used.
-
(As of 7.39.0, curl attempts to automatically extract the public key from the
private key file, so passing this option is generally not required. Note that
this public key extraction requires libcurl to be linked against a copy of
docs/cmdline-opts/quote.d+1 -0
@@ -9,6 +9,7 @@ Category: ftp sftp
Example: --quote "DELE file" ftp://example.com/foo
Added: 5.3
See-also: request
+Multi: append
---
Send an arbitrary command to the remote FTP or SFTP server. Quote commands are
sent BEFORE the transfer takes place (just after the initial PWD command in an
docs/cmdline-opts/random-file.d+1 -0
@@ -7,6 +7,7 @@ Category: misc
Example: --random-file rubbish $URL
Added: 7.7
See-also: egd-file
+Multi: single
---
Deprecated option. This option is ignored by curl since 7.84.0. Prior to that
it only had an effect on curl if built to use old versions of OpenSSL.
docs/cmdline-opts/range.d+1 -2
@@ -9,6 +9,7 @@ Category: http ftp sftp file
Example: --range 22-44 $URL
Added: 4.0
See-also: continue-at append
+Multi: single
---
Retrieve a byte range (i.e. a partial document) from an HTTP/1.1, FTP or SFTP
server or a local FILE. Ranges can be specified in a number of ways.
@@ -49,5 +50,3 @@ whole document.
FTP and SFTP range downloads only support the simple 'start-stop' syntax
(optionally with one of the numbers omitted). FTP use depends on the extended
FTP command SIZE.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/rate.d+1 -2
@@ -9,6 +9,7 @@ Example: --rate 3/h $URL
Example: --rate 14/m $URL
Added: 7.84.0
See-also: limit-rate retry-delay
+Multi: single
---
Specify the maximum transfer frequency you allow curl to use - in number of
transfer starts per time unit (sometimes called request rate). Without this
@@ -31,5 +32,3 @@ more than 1000 per second, it will instead run unrestricted.
When retrying transfers, enabled with --retry, the separate retry delay logic
is used and not this setting.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/raw.d+1 -0
@@ -7,6 +7,7 @@ Protocols: HTTP
Category: http
Example: --raw $URL
See-also: tr-encoding
+Multi: boolean
---
When used, it disables all internal HTTP decoding of content or transfer
encodings and instead makes them passed on unaltered, raw.
docs/cmdline-opts/referer.d+1 -2
@@ -11,11 +11,10 @@ Example: --referer "https://fake.example" $URL
Example: --referer "https://fake.example;auto" -L $URL
Example: --referer ";auto" -L $URL
Added: 4.0
+Multi: single
---
Sends the "Referrer Page" information to the HTTP server. This can also be set
with the --header flag of course. When used with --location you can append
";auto" to the --referer URL to make curl automatically set the previous URL
when it follows a Location: header. The ";auto" string can be used alone,
even if you do not set an initial --referer.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/remote-header-name.d+1 -0
@@ -8,6 +8,7 @@ Category: output
Example: -OJ https://example.com/file
Added: 7.20.0
See-also: remote-name
+Multi: boolean
---
This option tells the --remote-name option to use the server-specified
Content-Disposition filename instead of extracting a filename from the URL. If
docs/cmdline-opts/remote-name-all.d+1 -0
@@ -6,6 +6,7 @@ Added: 7.19.0
Category: output
Example: --remote-name-all ftp://example.com/file1 ftp://example.com/file2
See-also: remote-name
+Multi: boolean
---
This option changes the default action for all given URLs to be dealt with as
if --remote-name were used for each one. So if you want to disable that for a
docs/cmdline-opts/remote-name.d+1 -0
@@ -7,6 +7,7 @@ Category: important output
Example: -O https://example.com/filename
Added: 4.0
See-also: remote-name-all output-dir remote-header-name
+Multi: append
---
Write output to a local file named like the remote file we get. (Only the file
part of the remote file is used, the path is cut off.)
docs/cmdline-opts/remote-time.d+1 -0
@@ -7,6 +7,7 @@ Category: output
Example: --remote-time -o foo $URL
Added: 7.9
See-also: remote-name time-cond
+Multi: boolean
---
When used, this will make curl attempt to figure out the timestamp of the
remote file, and if that is available make the local file get that same
docs/cmdline-opts/remove-on-error.d+1 -0
@@ -6,6 +6,7 @@ See-also: fail
Category: curl
Example: --remove-on-error -o output $URL
Added: 7.83.0
+Multi: boolean
---
When curl returns an error when told to save output in a local file, this
option removes that saved file before exiting. This prevents curl from
docs/cmdline-opts/request-target.d+1 -0
@@ -8,6 +8,7 @@ Added: 7.55.0
Category: http
Example: --request-target "*" -X OPTIONS $URL
See-also: request
+Multi: single
---
Tells curl to use an alternative "target" (path) instead of using the path as
provided in the URL. Particularly useful when wanting to issue HTTP requests
docs/cmdline-opts/request.d+1 -2
@@ -9,6 +9,7 @@ Example: -X "DELETE" $URL
Example: -X NLST ftp://example.com/
Added: 6.0
See-also: request-target
+Multi: single
---
(HTTP) Specifies a custom request method to use when communicating with the
HTTP server. The specified request method will be used instead of the method
@@ -42,5 +43,3 @@ Specifies a custom IMAP command to use instead of LIST. (Added in 7.30.0)
(SMTP)
Specifies a custom SMTP command to use instead of HELP or VRFY. (Added in 7.34.0)
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/resolve.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.21.3
Category: connection dns
Example: --resolve example.com:443:127.0.0.1 $URL
See-also: connect-to alt-svc
+Multi: append
---
Provide a custom address for a specific host and port pair. Using this, you
can make the curl requests(s) use a specified address and prevent the
docs/cmdline-opts/retry-all-errors.d+1 -0
@@ -6,6 +6,7 @@ Added: 7.71.0
Category: curl
Example: --retry 5 --retry-all-errors $URL
See-also: retry
+Multi: boolean
---
Retry on any error. This option is used together with --retry.
docs/cmdline-opts/retry-connrefused.d+1 -0
@@ -6,6 +6,7 @@ Added: 7.52.0
Category: curl
Example: --retry-connrefused --retry $URL
See-also: retry retry-all-errors
+Multi: boolean
---
In addition to the other conditions, consider ECONNREFUSED as a transient
error too for --retry. This option is used together with --retry.
docs/cmdline-opts/retry-delay.d+1 -2
@@ -7,10 +7,9 @@ Added: 7.12.3
Category: curl
Example: --retry-delay 5 --retry $URL
See-also: retry
+Multi: single
---
Make curl sleep this amount of time before each retry when a transfer has
failed with a transient error (it changes the default backoff time algorithm
between retries). This option is only interesting if --retry is also
used. Setting this delay to zero will make curl use the default backoff time.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/retry-max-time.d+1 -2
@@ -7,6 +7,7 @@ Added: 7.12.3
Category: curl
Example: --retry-max-time 30 --retry 10 $URL
See-also: retry
+Multi: single
---
The retry timer is reset before the first transfer attempt. Retries will be
done as usual (see --retry) as long as the timer has not reached this given
@@ -14,5 +15,3 @@ limit. Notice that if the timer has not reached the limit, the request will be
made and while performing, it may take longer than this given time period. To
limit a single request's maximum time, use --max-time. Set this option to
zero to not timeout retries.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/retry.d+1 -2
@@ -7,6 +7,7 @@ Help: Retry request if transient problems occur
Category: curl
Example: --retry 7 $URL
See-also: retry-max-time
+Multi: single
---
If a transient error is returned when curl tries to perform a transfer, it
will retry this number of times before giving up. Setting the number to 0
@@ -22,5 +23,3 @@ using --retry-delay you disable this exponential backoff algorithm. See also
Since curl 7.66.0, curl will comply with the Retry-After: response header if
one was present to know when to issue the next retry.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/sasl-authzid.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.66.0
Category: auth
Example: --sasl-authzid zid imap://example.com/
See-also: login-options
+Multi: single
---
Use this authorization identity (authzid), during SASL PLAIN authentication,
in addition to the authentication identity (authcid) as specified by --user.
docs/cmdline-opts/sasl-ir.d+1 -0
@@ -6,5 +6,6 @@ Added: 7.31.0
Category: auth
Example: --sasl-ir imap://example.com/
See-also: sasl-authzid
+Multi: boolean
---
Enable initial response in SASL authentication.
docs/cmdline-opts/service-name.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.43.0
Category: misc
Example: --service-name sockd/server $URL
See-also: negotiate proxy-service-name
+Multi: single
---
This option allows you to change the service name for SPNEGO.
docs/cmdline-opts/show-error.d+1 -0
@@ -7,6 +7,7 @@ See-also: no-progress-meter
Category: curl
Example: --show-error --silent $URL
Added: 5.9
+Multi: boolean
---
When used with --silent, it makes curl show an error message if it fails.
docs/cmdline-opts/silent.d+1 -0
@@ -7,6 +7,7 @@ See-also: verbose stderr no-progress-meter
Category: important verbose
Example: -s $URL
Added: 4.0
+Multi: boolean
---
Silent or quiet mode. Do not show progress meter or error messages. Makes Curl
mute. It will still output the data you ask for, potentially even to the
docs/cmdline-opts/socks4.d+1 -2
@@ -7,6 +7,7 @@ Added: 7.15.2
Category: proxy
Example: --socks4 hostname:4096 $URL
See-also: socks4a socks5 socks5-hostname
+Multi: single
---
Use the specified SOCKS4 proxy. If the port number is not specified, it is
assumed at port 1080. Using this socket type make curl resolve the host name
@@ -24,5 +25,3 @@ using a socks4:// protocol prefix. (Added in 7.21.7)
Since 7.52.0, --preproxy can be used to specify a SOCKS proxy at the same time
--proxy is used with an HTTP/HTTPS proxy. In such a case curl first connects to
the SOCKS proxy and then connects (through SOCKS) to the HTTP or HTTPS proxy.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/socks4a.d+1 -2
@@ -7,6 +7,7 @@ Added: 7.18.0
Category: proxy
Example: --socks4a hostname:4096 $URL
See-also: socks4 socks5 socks5-hostname
+Multi: single
---
Use the specified SOCKS4a proxy. If the port number is not specified, it is
assumed at port 1080. This asks the proxy to resolve the host name.
@@ -23,5 +24,3 @@ using a socks4a:// protocol prefix. (Added in 7.21.7)
Since 7.52.0, --preproxy can be used to specify a SOCKS proxy at the same time
--proxy is used with an HTTP/HTTPS proxy. In such a case curl first connects to
the SOCKS proxy and then connects (through SOCKS) to the HTTP or HTTPS proxy.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/socks5-basic.d+1 -0
@@ -6,6 +6,7 @@ Added: 7.55.0
Category: proxy auth
Example: --socks5-basic --socks5 hostname:4096 $URL
See-also: socks5
+Multi: mutex
---
Tells curl to use username/password authentication when connecting to a SOCKS5
proxy. The username/password authentication is enabled by default. Use
docs/cmdline-opts/socks5-gssapi-nec.d+1 -0
@@ -6,6 +6,7 @@ Added: 7.19.4
Category: proxy auth
Example: --socks5-gssapi-nec --socks5 hostname:4096 $URL
See-also: socks5
+Multi: boolean
---
As part of the GSS-API negotiation a protection mode is negotiated. RFC 1961
says in section 4.3/4.4 it should be protected, but the NEC reference
docs/cmdline-opts/socks5-gssapi-service.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.19.4
Category: proxy auth
Example: --socks5-gssapi-service sockd --socks5 hostname:4096 $URL
See-also: socks5
+Multi: single
---
The default service name for a socks server is rcmd/server-fqdn. This option
allows you to change it.
docs/cmdline-opts/socks5-gssapi.d+1 -0
@@ -6,6 +6,7 @@ Added: 7.55.0
Category: proxy auth
Example: --socks5-gssapi --socks5 hostname:4096 $URL
See-also: socks5
+Multi: boolean
---
Tells curl to use GSS-API authentication when connecting to a SOCKS5 proxy.
The GSS-API authentication is enabled by default (if curl is compiled with
docs/cmdline-opts/socks5-hostname.d+1 -2
@@ -7,6 +7,7 @@ Added: 7.18.0
Category: proxy
Example: --socks5-hostname proxy.example:7000 $URL
See-also: socks5 socks4a
+Multi: single
---
Use the specified SOCKS5 proxy (and let the proxy resolve the host name). If
the port number is not specified, it is assumed at port 1080.
@@ -23,5 +24,3 @@ This option is superfluous since you can specify a socks5 hostname proxy with
Since 7.52.0, --preproxy can be used to specify a SOCKS proxy at the same time
--proxy is used with an HTTP/HTTPS proxy. In such a case curl first connects to
the SOCKS proxy and then connects (through SOCKS) to the HTTP or HTTPS proxy.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/socks5.d+1 -2
@@ -7,6 +7,7 @@ Added: 7.18.0
Category: proxy
Example: --socks5 proxy.example:7000 $URL
See-also: socks5-hostname socks4a
+Multi: single
---
Use the specified SOCKS5 proxy - but resolve the host name locally. If the
port number is not specified, it is assumed at port 1080.
@@ -24,6 +25,4 @@ Since 7.52.0, --preproxy can be used to specify a SOCKS proxy at the same time
--proxy is used with an HTTP/HTTPS proxy. In such a case curl first connects to
the SOCKS proxy and then connects (through SOCKS) to the HTTP or HTTPS proxy.
-If this option is used several times, the last one will be used.
-
This option (as well as --socks4) does not work with IPV6, FTPS or LDAP.
docs/cmdline-opts/speed-limit.d+1 -2
@@ -8,9 +8,8 @@ Category: connection
Example: --speed-limit 300 --speed-time 10 $URL
Added: 4.7
See-also: speed-time limit-rate max-time
+Multi: single
---
If a transfer is slower than this given speed (in bytes per second) for
speed-time seconds it gets aborted. speed-time is set with --speed-time and is
30 if not set.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/speed-time.d+1 -2
@@ -8,6 +8,7 @@ Category: connection
Example: --speed-limit 300 --speed-time 10 $URL
Added: 4.7
See-also: speed-limit limit-rate
+Multi: single
---
If a transfer runs slower than speed-limit bytes per second during a speed-time
period, the transfer is aborted. If speed-time is used, the default
@@ -15,5 +16,3 @@ speed-limit will be 1 unless set with --speed-limit.
This option controls transfers (in both directions) but will not affect slow
connects etc. If this is a concern for you, try the --connect-timeout option.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/ssl-allow-beast.d+1 -0
@@ -6,6 +6,7 @@ Added: 7.25.0
Category: tls
Example: --ssl-allow-beast $URL
See-also: proxy-ssl-allow-beast insecure
+Multi: boolean
---
This option tells curl to not work around a security flaw in the SSL3 and
TLS1.0 protocols known as BEAST. If this option is not used, the SSL layer
docs/cmdline-opts/ssl-auto-client-cert.d+1 -0
@@ -6,6 +6,7 @@ Added: 7.77.0
See-also: proxy-ssl-auto-client-cert
Category: tls
Example: --ssl-auto-client-cert $URL
+Multi: boolean
---
Tell libcurl to automatically locate and use a client certificate for
authentication, when requested by the server. This option is only supported
docs/cmdline-opts/ssl-no-revoke.d+1 -0
@@ -6,6 +6,7 @@ Added: 7.44.0
Category: tls
Example: --ssl-no-revoke $URL
See-also: crlfile
+Multi: boolean
---
(Schannel) This option tells curl to disable certificate revocation checks.
WARNING: this option loosens the SSL security, and by using this flag you ask
docs/cmdline-opts/ssl-reqd.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.20.0
Category: tls
Example: --ssl-reqd ftp://example.com
See-also: ssl insecure
+Multi: boolean
---
Require SSL/TLS for the connection. Terminates the connection if the server
does not support SSL/TLS.
docs/cmdline-opts/ssl-revoke-best-effort.d+1 -0
@@ -6,6 +6,7 @@ Added: 7.70.0
Category: tls
Example: --ssl-revoke-best-effort $URL
See-also: crlfile insecure
+Multi: boolean
---
(Schannel) This option tells curl to ignore certificate revocation checks when
they failed due to missing/offline distribution points for the revocation check
docs/cmdline-opts/ssl.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.20.0
Category: tls
Example: --ssl pop3://example.com/
See-also: ssl-reqd insecure ciphers
+Multi: boolean
---
Warning: this is considered an insecure option. Consider using --ssl-reqd
instead to be sure curl upgrades to a secure connection.
docs/cmdline-opts/sslv2.d+1 -0
@@ -11,6 +11,7 @@ See-also: http1.1 http2
Help: Use SSLv2
Category: tls
Example: --sslv2 $URL
+Multi: mutex
---
This option previously asked curl to use SSLv2, but starting in curl 7.77.0
this instruction is ignored. SSLv2 is widely considered insecure (see RFC
docs/cmdline-opts/sslv3.d+1 -0
@@ -11,6 +11,7 @@ See-also: http1.1 http2
Help: Use SSLv3
Category: tls
Example: --sslv3 $URL
+Multi: mutex
---
This option previously asked curl to use SSLv3, but starting in curl 7.77.0
this instruction is ignored. SSLv3 is widely considered insecure (see RFC
docs/cmdline-opts/stderr.d+1 -2
@@ -7,11 +7,10 @@ See-also: verbose silent
Category: verbose
Example: --stderr output.txt $URL
Added: 6.2
+Multi: single
---
Redirect all writes to stderr to the specified file instead. If the file name
is a plain '-', it is instead written to stdout.
This option is global and does not need to be specified for each use of
--next.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/styled-output.d+1 -0
@@ -6,6 +6,7 @@ Added: 7.61.0
Category: verbose
Example: --styled-output -I $URL
See-also: head verbose
+Multi: boolean
---
Enables the automatic use of bold font styles when writing HTTP headers to the
terminal. Use --no-styled-output to switch them off.
docs/cmdline-opts/suppress-connect-headers.d+1 -0
@@ -6,6 +6,7 @@ See-also: dump-header include proxytunnel
Category: proxy
Example: --suppress-connect-headers --include -x proxy $URL
Added: 7.54.0
+Multi: boolean
---
When --proxytunnel is used and a CONNECT request is made do not output proxy
CONNECT response headers. This option is meant to be used with --dump-header or
docs/cmdline-opts/tcp-fastopen.d+1 -0
@@ -6,5 +6,6 @@ Help: Use TCP Fast Open
Category: connection
Example: --tcp-fastopen $URL
See-also: false-start
+Multi: boolean
---
Enable use of TCP Fast Open (RFC7413).
docs/cmdline-opts/tcp-nodelay.d+1 -0
@@ -6,6 +6,7 @@ Added: 7.11.2
Category: connection
Example: --tcp-nodelay $URL
See-also: no-buffer
+Multi: boolean
---
Turn on the TCP_NODELAY option. See the *curl_easy_setopt(3)* man page for
details about this option.
docs/cmdline-opts/telnet-option.d+1 -0
@@ -8,6 +8,7 @@ Category: telnet
Example: -t TTYPE=vt100 telnet://example.com/
Added: 7.7
See-also: config
+Multi: append
---
Pass options to the telnet protocol. Supported options are:
docs/cmdline-opts/tftp-blksize.d+1 -2
@@ -8,9 +8,8 @@ Added: 7.20.0
Category: tftp
Example: --tftp-blksize 1024 tftp://example.com/file
See-also: tftp-no-options
+Multi: single
---
Set TFTP BLKSIZE option (must be >512). This is the block size that curl will
try to use when transferring data to or from a TFTP server. By default 512
bytes will be used.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/tftp-no-options.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.48.0
Category: tftp
Example: --tftp-no-options tftp://192.168.0.1/
See-also: tftp-blksize
+Multi: boolean
---
Tells curl not to send TFTP options requests.
docs/cmdline-opts/time-cond.d+1 -2
@@ -11,6 +11,7 @@ Example: -z "-Wed 01 Sep 2021 12:18:00" $URL
Example: -z file $URL
Added: 5.8
See-also: etag-compare remote-time
+Multi: single
---
Request a file that has been modified later than the given time and date, or
one that has been modified before that time. The <date expression> can be all
@@ -21,5 +22,3 @@ instead. See the *curl_getdate(3)* man pages for date expression details.
Start the date expression with a dash (-) to make it request for a document
that is older than the given date/time, default is a document that is newer
than the specified date/time.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/tls-max.d+1 -0
@@ -11,6 +11,7 @@ Help: Set maximum allowed TLS version
Category: tls
Example: --tls-max 1.2 $URL
Example: --tls-max 1.3 --tlsv1.2 $URL
+Multi: single
---
VERSION defines maximum supported TLS version. The minimum acceptable version
is set by tlsv1.0, tlsv1.1, tlsv1.2 or tlsv1.3.
docs/cmdline-opts/tls13-ciphers.d+1 -2
@@ -8,6 +8,7 @@ Category: tls
Example: --tls13-ciphers TLS_AES_128_GCM_SHA256 $URL
Added: 7.61.0
See-also: ciphers curves
+Multi: single
---
Specifies which cipher suites to use in the connection if it negotiates TLS
1.3. The list of ciphers suites must specify valid ciphers. Read up on TLS 1.3
@@ -18,5 +19,3 @@ cipher suite details on this URL:
This option is currently used only when curl is built to use OpenSSL 1.1.1 or
later. If you are using a different SSL backend you can try setting TLS 1.3
cipher suites by using the --ciphers option.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/tlsauthtype.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.21.4
Category: tls auth
Example: --tlsauthtype SRP $URL
See-also: tlsuser
+Multi: single
---
Set TLS authentication type. Currently, the only supported option is "SRP",
for TLS-SRP (RFC 5054). If --tlsuser and --tlspassword are specified but
docs/cmdline-opts/tlspassword.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.21.4
Category: tls auth
Example: --tlspassword pwd --tlsuser user $URL
See-also: tlsuser
+Multi: single
---
Set password for use with the TLS authentication method specified with
--tlsauthtype. Requires that --tlsuser also be set.
docs/cmdline-opts/tlsuser.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.21.4
Category: tls auth
Example: --tlspassword pwd --tlsuser user $URL
See-also: tlspassword
+Multi: single
---
Set username for use with the TLS authentication method specified with
--tlsauthtype. Requires that --tlspassword also is set.
docs/cmdline-opts/tlsv1.0.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.34.0
Category: tls
Example: --tlsv1.0 $URL
See-also: tlsv1.3
+Multi: mutex
---
Forces curl to use TLS version 1.0 or later when connecting to a remote TLS server.
docs/cmdline-opts/tlsv1.1.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.34.0
Category: tls
Example: --tlsv1.1 $URL
See-also: tlsv1.3 tls-max
+Multi: mutex
---
Forces curl to use TLS version 1.1 or later when connecting to a remote TLS server.
docs/cmdline-opts/tlsv1.2.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.34.0
Category: tls
Example: --tlsv1.2 $URL
See-also: tlsv1.3 tls-max
+Multi: mutex
---
Forces curl to use TLS version 1.2 or later when connecting to a remote TLS server.
docs/cmdline-opts/tlsv1.3.d+1 -0
@@ -7,6 +7,7 @@ Added: 7.52.0
Category: tls
Example: --tlsv1.3 $URL
See-also: tlsv1.2 tls-max
+Multi: mutex
---
Forces curl to use TLS version 1.3 or later when connecting to a remote TLS
server.
docs/cmdline-opts/tlsv1.d+1 -0
@@ -11,6 +11,7 @@ See-also: http1.1 http2
Help: Use TLSv1.0 or greater
Category: tls
Example: --tlsv1 $URL
+Multi: mutex
---
Tells curl to use at least TLS version 1.x when negotiating with a remote TLS
server. That means TLS version 1.0 or higher
docs/cmdline-opts/tr-encoding.d+1 -0
@@ -7,6 +7,7 @@ Protocols: HTTP
Category: http
Example: --tr-encoding $URL
See-also: compressed
+Multi: boolean
---
Request a compressed Transfer-Encoding response using one of the algorithms
curl supports, and uncompress the data while receiving it.
docs/cmdline-opts/trace-ascii.d+1 -2
@@ -8,6 +8,7 @@ Category: verbose
Example: --trace-ascii log.txt $URL
Added: 7.9.7
See-also: verbose trace
+Multi: single
---
Enables a full trace dump of all incoming and outgoing data, including
descriptive information, to the given output file. Use "-" as filename to have
@@ -19,5 +20,3 @@ for untrained humans.
This option is global and does not need to be specified for each use of
--next.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/trace-time.d+1 -0
@@ -6,6 +6,7 @@ Added: 7.14.0
Category: verbose
Example: --trace-time --trace-ascii output $URL
See-also: trace verbose
+Multi: boolean
---
Prepends a time stamp to each trace or verbose line that curl displays.
docs/cmdline-opts/trace.d+1 -2
@@ -8,6 +8,7 @@ Category: verbose
Example: --trace log.txt $URL
Added: 7.9.7
See-also: trace-ascii trace-time
+Multi: single
---
Enables a full trace dump of all incoming and outgoing data, including
descriptive information, to the given output file. Use "-" as filename to have
@@ -16,5 +17,3 @@ stderr.
This option is global and does not need to be specified for each use of
--next.
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/unix-socket.d+1 -0
@@ -8,5 +8,6 @@ Protocols: HTTP
Category: connection
See-also: abstract-unix-socket
Example: --unix-socket socket-path $URL
+Multi: single
---
Connect through this Unix domain socket, instead of using the network.
docs/cmdline-opts/upload-file.d+1 -0
@@ -10,6 +10,7 @@ Example: -T "img[1-1000].png" ftp://ftp.example.com/
Example: --upload-file "{file1,file2}" $URL
Added: 4.0
See-also: get head
+Multi: append
---
This transfers the specified local file to the remote URL. If there is no file
part in the specified URL, curl will append the local file name. NOTE that you
docs/cmdline-opts/url.d+3 -2
@@ -7,6 +7,7 @@ Category: curl
Example: --url $URL
Added: 7.5
See-also: next config
+Multi: append
---
Specify a URL to fetch. This option is mostly handy when you want to specify
URL(s) in a config file.
@@ -17,8 +18,8 @@ name matches DICT, FTP, IMAP, LDAP, POP3 or SMTP then that protocol will be
used, otherwise HTTP will be used. Since 7.45.0 guessing can be disabled by
setting a default protocol, see --proto-default for details.
-This option may be used any number of times. To control where this URL is
-written, use the --output or the --remote-name options.
+To control where this URL is written, use the --output or the --remote-name
+options.
**WARNING**: On Windows, particular file:// accesses can be converted to
network accesses by the operating system. Beware!
docs/cmdline-opts/use-ascii.d+1 -0
@@ -8,6 +8,7 @@ Category: misc
Example: -B ftp://example.com/README
Added: 5.0
See-also: crlf data-ascii
+Multi: boolean
---
Enable ASCII transfer. For FTP, this can also be enforced by using a URL that
ends with ";type=A". This option causes data sent to stdout to be in text mode
docs/cmdline-opts/user-agent.d+1 -2
@@ -9,6 +9,7 @@ Category: important http
Example: -A "Agent 007" $URL
Added: 4.5.1
See-also: header proxy-header
+Multi: single
---
Specify the User-Agent string to send to the HTTP server. To encode blanks in
the string, surround the string with single quote marks. This header can also
@@ -17,5 +18,3 @@ be set with the --header or the --proxy-header options.
If you give an empty argument to --user-agent (""), it will remove the header
completely from the request. If you prefer a blank header, you can set it to a
single space (" ").
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/user.d+1 -2
@@ -8,6 +8,7 @@ Category: important auth
Example: -u user:secret $URL
Added: 4.0
See-also: netrc config
+Multi: single
---
Specify the user name and password to use for server authentication. Overrides
--netrc and --netrc-optional.
@@ -41,5 +42,3 @@ If you use a Windows SSPI-enabled curl binary and perform Kerberos V5,
Negotiate, NTLM or Digest authentication then you can tell curl to select
the user name and password from your environment by specifying a single colon
with this option: "-u :".
-
-If this option is used several times, the last one will be used.
docs/cmdline-opts/verbose.d+1 -0
@@ -8,6 +8,7 @@ See-also: include
Category: important verbose
Example: --verbose $URL
Added: 4.0
+Multi: boolean
---
Makes curl verbose during the operation. Useful for debugging and seeing
what's going on "under the hood". A line starting with '>' means "header data"
docs/cmdline-opts/version.d+1 -0
@@ -7,6 +7,7 @@ Category: important curl
Example: --version
Added: 4.0
See-also: help manual
+Multi: boolean
---
Displays information about curl and the libcurl version it uses.
docs/cmdline-opts/write-out.d+1 -1
@@ -8,6 +8,7 @@ Category: verbose
Example: -w '%{http_code}\\n' $URL
Added: 6.5
See-also: verbose head
+Multi: single
---
Make curl display information on stdout after a completed transfer. The format
is a string that may contain plain text mixed with any number of
@@ -206,4 +207,3 @@ The URL that was fetched last. This is most meaningful if you have told curl
to follow location: headers.
.RE
.IP
-If this option is used several times, the last one will be used.
docs/cmdline-opts/xattr.d+1 -0
@@ -6,6 +6,7 @@ Category: misc
Example: --xattr -o storage $URL
Added: 7.21.3
See-also: remote-time write-out verbose
+Multi: boolean
---
When saving output to a file, this option tells curl to store certain file
metadata in extended file attributes. Currently, the URL is stored in the