From eaf15b1797a9b4f8fe855bbacd668cd0a4f14be5 Mon Sep 17 00:00:00 2001 From: Owen Rafferty Date: Mon, 29 Jul 2024 19:00:04 -0500 Subject: [PATCH] curl: 8.9.0 --- core/curl/checksums | 1005 +-- core/curl/files/CURLINFO_ACTIVESOCKET.3 | 6 +- core/curl/files/CURLINFO_APPCONNECT_TIME.3 | 6 +- core/curl/files/CURLINFO_APPCONNECT_TIME_T.3 | 6 +- core/curl/files/CURLINFO_CAINFO.3 | 6 +- core/curl/files/CURLINFO_CAPATH.3 | 6 +- core/curl/files/CURLINFO_CERTINFO.3 | 13 +- core/curl/files/CURLINFO_CONDITION_UNMET.3 | 6 +- core/curl/files/CURLINFO_CONNECT_TIME.3 | 6 +- core/curl/files/CURLINFO_CONNECT_TIME_T.3 | 6 +- core/curl/files/CURLINFO_CONN_ID.3 | 6 +- .../files/CURLINFO_CONTENT_LENGTH_DOWNLOAD.3 | 8 +- .../CURLINFO_CONTENT_LENGTH_DOWNLOAD_T.3 | 6 +- .../files/CURLINFO_CONTENT_LENGTH_UPLOAD.3 | 8 +- .../files/CURLINFO_CONTENT_LENGTH_UPLOAD_T.3 | 6 +- core/curl/files/CURLINFO_CONTENT_TYPE.3 | 6 +- core/curl/files/CURLINFO_COOKIELIST.3 | 6 +- core/curl/files/CURLINFO_EFFECTIVE_METHOD.3 | 6 +- core/curl/files/CURLINFO_EFFECTIVE_URL.3 | 6 +- core/curl/files/CURLINFO_FILETIME.3 | 15 +- core/curl/files/CURLINFO_FILETIME_T.3 | 20 +- core/curl/files/CURLINFO_FTP_ENTRY_PATH.3 | 8 +- core/curl/files/CURLINFO_HEADER_SIZE.3 | 6 +- core/curl/files/CURLINFO_HTTPAUTH_AVAIL.3 | 10 +- core/curl/files/CURLINFO_HTTP_CONNECTCODE.3 | 6 +- core/curl/files/CURLINFO_HTTP_VERSION.3 | 6 +- core/curl/files/CURLINFO_LASTSOCKET.3 | 6 +- core/curl/files/CURLINFO_LOCAL_IP.3 | 6 +- core/curl/files/CURLINFO_LOCAL_PORT.3 | 6 +- core/curl/files/CURLINFO_NAMELOOKUP_TIME.3 | 6 +- core/curl/files/CURLINFO_NAMELOOKUP_TIME_T.3 | 6 +- core/curl/files/CURLINFO_NUM_CONNECTS.3 | 6 +- core/curl/files/CURLINFO_OS_ERRNO.3 | 6 +- core/curl/files/CURLINFO_PRETRANSFER_TIME.3 | 6 +- core/curl/files/CURLINFO_PRETRANSFER_TIME_T.3 | 6 +- core/curl/files/CURLINFO_PRIMARY_IP.3 | 6 +- core/curl/files/CURLINFO_PRIMARY_PORT.3 | 6 +- core/curl/files/CURLINFO_PRIVATE.3 | 6 +- core/curl/files/CURLINFO_PROTOCOL.3 | 8 +- core/curl/files/CURLINFO_PROXYAUTH_AVAIL.3 | 10 +- core/curl/files/CURLINFO_PROXY_ERROR.3 | 6 +- .../files/CURLINFO_PROXY_SSL_VERIFYRESULT.3 | 6 +- core/curl/files/CURLINFO_QUEUE_TIME_T.3 | 6 +- core/curl/files/CURLINFO_REDIRECT_COUNT.3 | 6 +- core/curl/files/CURLINFO_REDIRECT_TIME.3 | 6 +- core/curl/files/CURLINFO_REDIRECT_TIME_T.3 | 6 +- core/curl/files/CURLINFO_REDIRECT_URL.3 | 20 +- core/curl/files/CURLINFO_REFERER.3 | 6 +- core/curl/files/CURLINFO_REQUEST_SIZE.3 | 6 +- core/curl/files/CURLINFO_RESPONSE_CODE.3 | 10 +- core/curl/files/CURLINFO_RETRY_AFTER.3 | 8 +- core/curl/files/CURLINFO_RTSP_CLIENT_CSEQ.3 | 6 +- core/curl/files/CURLINFO_RTSP_CSEQ_RECV.3 | 6 +- core/curl/files/CURLINFO_RTSP_SERVER_CSEQ.3 | 6 +- core/curl/files/CURLINFO_RTSP_SESSION_ID.3 | 6 +- core/curl/files/CURLINFO_SCHEME.3 | 6 +- core/curl/files/CURLINFO_SIZE_DOWNLOAD.3 | 8 +- core/curl/files/CURLINFO_SIZE_DOWNLOAD_T.3 | 6 +- core/curl/files/CURLINFO_SIZE_UPLOAD.3 | 8 +- core/curl/files/CURLINFO_SIZE_UPLOAD_T.3 | 6 +- core/curl/files/CURLINFO_SPEED_DOWNLOAD.3 | 8 +- core/curl/files/CURLINFO_SPEED_DOWNLOAD_T.3 | 6 +- core/curl/files/CURLINFO_SPEED_UPLOAD.3 | 8 +- core/curl/files/CURLINFO_SPEED_UPLOAD_T.3 | 6 +- core/curl/files/CURLINFO_SSL_ENGINES.3 | 6 +- core/curl/files/CURLINFO_SSL_VERIFYRESULT.3 | 6 +- core/curl/files/CURLINFO_STARTTRANSFER_TIME.3 | 6 +- .../files/CURLINFO_STARTTRANSFER_TIME_T.3 | 6 +- core/curl/files/CURLINFO_TLS_SESSION.3 | 9 +- core/curl/files/CURLINFO_TLS_SSL_PTR.3 | 16 +- core/curl/files/CURLINFO_TOTAL_TIME.3 | 6 +- core/curl/files/CURLINFO_TOTAL_TIME_T.3 | 6 +- core/curl/files/CURLINFO_USED_PROXY.3 | 6 +- core/curl/files/CURLINFO_XFER_ID.3 | 6 +- .../CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE.3 | 8 +- .../CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE.3 | 8 +- core/curl/files/CURLMOPT_MAXCONNECTS.3 | 6 +- .../files/CURLMOPT_MAX_CONCURRENT_STREAMS.3 | 6 +- .../files/CURLMOPT_MAX_HOST_CONNECTIONS.3 | 6 +- .../curl/files/CURLMOPT_MAX_PIPELINE_LENGTH.3 | 6 +- .../files/CURLMOPT_MAX_TOTAL_CONNECTIONS.3 | 10 +- core/curl/files/CURLMOPT_PIPELINING.3 | 18 +- .../files/CURLMOPT_PIPELINING_SERVER_BL.3 | 8 +- core/curl/files/CURLMOPT_PIPELINING_SITE_BL.3 | 8 +- core/curl/files/CURLMOPT_PUSHDATA.3 | 6 +- core/curl/files/CURLMOPT_PUSHFUNCTION.3 | 6 +- core/curl/files/CURLMOPT_SOCKETDATA.3 | 6 +- core/curl/files/CURLMOPT_SOCKETFUNCTION.3 | 6 +- core/curl/files/CURLMOPT_TIMERDATA.3 | 6 +- core/curl/files/CURLMOPT_TIMERFUNCTION.3 | 6 +- .../curl/files/CURLOPT_ABSTRACT_UNIX_SOCKET.3 | 8 +- core/curl/files/CURLOPT_ACCEPTTIMEOUT_MS.3 | 6 +- core/curl/files/CURLOPT_ACCEPT_ENCODING.3 | 18 +- core/curl/files/CURLOPT_ADDRESS_SCOPE.3 | 6 +- core/curl/files/CURLOPT_ALTSVC.3 | 6 +- core/curl/files/CURLOPT_ALTSVC_CTRL.3 | 16 +- core/curl/files/CURLOPT_APPEND.3 | 8 +- core/curl/files/CURLOPT_AUTOREFERER.3 | 6 +- core/curl/files/CURLOPT_AWS_SIGV4.3 | 39 +- core/curl/files/CURLOPT_BUFFERSIZE.3 | 6 +- core/curl/files/CURLOPT_CAINFO.3 | 8 +- core/curl/files/CURLOPT_CAINFO_BLOB.3 | 10 +- core/curl/files/CURLOPT_CAPATH.3 | 8 +- core/curl/files/CURLOPT_CA_CACHE_TIMEOUT.3 | 31 +- core/curl/files/CURLOPT_CERTINFO.3 | 9 +- core/curl/files/CURLOPT_CHUNK_BGN_FUNCTION.3 | 6 +- core/curl/files/CURLOPT_CHUNK_DATA.3 | 6 +- core/curl/files/CURLOPT_CHUNK_END_FUNCTION.3 | 6 +- core/curl/files/CURLOPT_CLOSESOCKETDATA.3 | 8 +- core/curl/files/CURLOPT_CLOSESOCKETFUNCTION.3 | 8 +- core/curl/files/CURLOPT_CONNECTTIMEOUT.3 | 27 +- core/curl/files/CURLOPT_CONNECTTIMEOUT_MS.3 | 40 +- core/curl/files/CURLOPT_CONNECT_ONLY.3 | 8 +- core/curl/files/CURLOPT_CONNECT_TO.3 | 6 +- .../CURLOPT_CONV_FROM_NETWORK_FUNCTION.3 | 8 +- .../files/CURLOPT_CONV_FROM_UTF8_FUNCTION.3 | 8 +- .../files/CURLOPT_CONV_TO_NETWORK_FUNCTION.3 | 8 +- core/curl/files/CURLOPT_COOKIE.3 | 6 +- core/curl/files/CURLOPT_COOKIEFILE.3 | 6 +- core/curl/files/CURLOPT_COOKIEJAR.3 | 6 +- core/curl/files/CURLOPT_COOKIELIST.3 | 8 +- core/curl/files/CURLOPT_COOKIESESSION.3 | 6 +- core/curl/files/CURLOPT_COPYPOSTFIELDS.3 | 6 +- core/curl/files/CURLOPT_CRLF.3 | 6 +- core/curl/files/CURLOPT_CRLFILE.3 | 6 +- core/curl/files/CURLOPT_CURLU.3 | 8 +- core/curl/files/CURLOPT_CUSTOMREQUEST.3 | 9 +- core/curl/files/CURLOPT_DEBUGDATA.3 | 6 +- core/curl/files/CURLOPT_DEBUGFUNCTION.3 | 16 +- core/curl/files/CURLOPT_DEFAULT_PROTOCOL.3 | 6 +- core/curl/files/CURLOPT_DIRLISTONLY.3 | 8 +- .../files/CURLOPT_DISALLOW_USERNAME_IN_URL.3 | 10 +- core/curl/files/CURLOPT_DNS_CACHE_TIMEOUT.3 | 6 +- core/curl/files/CURLOPT_DNS_INTERFACE.3 | 11 +- core/curl/files/CURLOPT_DNS_LOCAL_IP4.3 | 10 +- core/curl/files/CURLOPT_DNS_LOCAL_IP6.3 | 10 +- core/curl/files/CURLOPT_DNS_SERVERS.3 | 12 +- .../files/CURLOPT_DNS_SHUFFLE_ADDRESSES.3 | 6 +- .../curl/files/CURLOPT_DNS_USE_GLOBAL_CACHE.3 | 8 +- core/curl/files/CURLOPT_DOH_SSL_VERIFYHOST.3 | 8 +- core/curl/files/CURLOPT_DOH_SSL_VERIFYPEER.3 | 8 +- .../curl/files/CURLOPT_DOH_SSL_VERIFYSTATUS.3 | 6 +- core/curl/files/CURLOPT_DOH_URL.3 | 9 +- core/curl/files/CURLOPT_ECH.3 | 8 +- core/curl/files/CURLOPT_EGDSOCKET.3 | 6 +- core/curl/files/CURLOPT_ERRORBUFFER.3 | 6 +- .../files/CURLOPT_EXPECT_100_TIMEOUT_MS.3 | 6 +- core/curl/files/CURLOPT_FAILONERROR.3 | 6 +- core/curl/files/CURLOPT_FILETIME.3 | 6 +- core/curl/files/CURLOPT_FNMATCH_DATA.3 | 6 +- core/curl/files/CURLOPT_FNMATCH_FUNCTION.3 | 6 +- core/curl/files/CURLOPT_FOLLOWLOCATION.3 | 12 +- core/curl/files/CURLOPT_FORBID_REUSE.3 | 6 +- core/curl/files/CURLOPT_FRESH_CONNECT.3 | 6 +- core/curl/files/CURLOPT_FTPPORT.3 | 6 +- core/curl/files/CURLOPT_FTPSSLAUTH.3 | 6 +- core/curl/files/CURLOPT_FTP_ACCOUNT.3 | 6 +- .../files/CURLOPT_FTP_ALTERNATIVE_TO_USER.3 | 6 +- .../files/CURLOPT_FTP_CREATE_MISSING_DIRS.3 | 7 +- core/curl/files/CURLOPT_FTP_FILEMETHOD.3 | 6 +- core/curl/files/CURLOPT_FTP_SKIP_PASV_IP.3 | 6 +- core/curl/files/CURLOPT_FTP_SSL_CCC.3 | 6 +- core/curl/files/CURLOPT_FTP_USE_EPRT.3 | 6 +- core/curl/files/CURLOPT_FTP_USE_EPSV.3 | 6 +- core/curl/files/CURLOPT_FTP_USE_PRET.3 | 6 +- core/curl/files/CURLOPT_GSSAPI_DELEGATION.3 | 6 +- .../files/CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS.3 | 6 +- core/curl/files/CURLOPT_HAPROXYPROTOCOL.3 | 6 +- core/curl/files/CURLOPT_HAPROXY_CLIENT_IP.3 | 6 +- core/curl/files/CURLOPT_HEADER.3 | 6 +- core/curl/files/CURLOPT_HEADERDATA.3 | 6 +- core/curl/files/CURLOPT_HEADERFUNCTION.3 | 6 +- core/curl/files/CURLOPT_HEADEROPT.3 | 6 +- core/curl/files/CURLOPT_HSTS.3 | 6 +- core/curl/files/CURLOPT_HSTSREADDATA.3 | 6 +- core/curl/files/CURLOPT_HSTSREADFUNCTION.3 | 6 +- core/curl/files/CURLOPT_HSTSWRITEDATA.3 | 6 +- core/curl/files/CURLOPT_HSTSWRITEFUNCTION.3 | 6 +- core/curl/files/CURLOPT_HSTS_CTRL.3 | 8 +- core/curl/files/CURLOPT_HTTP09_ALLOWED.3 | 16 +- core/curl/files/CURLOPT_HTTP200ALIASES.3 | 6 +- core/curl/files/CURLOPT_HTTPAUTH.3 | 10 +- core/curl/files/CURLOPT_HTTPGET.3 | 6 +- core/curl/files/CURLOPT_HTTPHEADER.3 | 12 +- core/curl/files/CURLOPT_HTTPPOST.3 | 8 +- core/curl/files/CURLOPT_HTTPPROXYTUNNEL.3 | 6 +- .../files/CURLOPT_HTTP_CONTENT_DECODING.3 | 6 +- .../files/CURLOPT_HTTP_TRANSFER_DECODING.3 | 10 +- core/curl/files/CURLOPT_HTTP_VERSION.3 | 6 +- .../files/CURLOPT_IGNORE_CONTENT_LENGTH.3 | 12 +- core/curl/files/CURLOPT_INFILESIZE.3 | 8 +- core/curl/files/CURLOPT_INFILESIZE_LARGE.3 | 8 +- core/curl/files/CURLOPT_INTERFACE.3 | 25 +- core/curl/files/CURLOPT_INTERLEAVEDATA.3 | 6 +- core/curl/files/CURLOPT_INTERLEAVEFUNCTION.3 | 6 +- core/curl/files/CURLOPT_IOCTLDATA.3 | 10 +- core/curl/files/CURLOPT_IOCTLFUNCTION.3 | 10 +- core/curl/files/CURLOPT_IPRESOLVE.3 | 6 +- core/curl/files/CURLOPT_ISSUERCERT.3 | 6 +- core/curl/files/CURLOPT_ISSUERCERT_BLOB.3 | 6 +- .../files/CURLOPT_KEEP_SENDING_ON_ERROR.3 | 6 +- core/curl/files/CURLOPT_KEYPASSWD.3 | 10 +- core/curl/files/CURLOPT_KRBLEVEL.3 | 8 +- core/curl/files/CURLOPT_LOCALPORT.3 | 6 +- core/curl/files/CURLOPT_LOCALPORTRANGE.3 | 6 +- core/curl/files/CURLOPT_LOGIN_OPTIONS.3 | 8 +- core/curl/files/CURLOPT_LOW_SPEED_LIMIT.3 | 6 +- core/curl/files/CURLOPT_LOW_SPEED_TIME.3 | 6 +- core/curl/files/CURLOPT_MAIL_AUTH.3 | 6 +- core/curl/files/CURLOPT_MAIL_FROM.3 | 6 +- core/curl/files/CURLOPT_MAIL_RCPT.3 | 6 +- .../curl/files/CURLOPT_MAIL_RCPT_ALLOWFAILS.3 | 11 +- core/curl/files/CURLOPT_MAXAGE_CONN.3 | 8 +- core/curl/files/CURLOPT_MAXCONNECTS.3 | 6 +- core/curl/files/CURLOPT_MAXFILESIZE.3 | 6 +- core/curl/files/CURLOPT_MAXFILESIZE_LARGE.3 | 6 +- core/curl/files/CURLOPT_MAXLIFETIME_CONN.3 | 8 +- core/curl/files/CURLOPT_MAXREDIRS.3 | 6 +- .../curl/files/CURLOPT_MAX_RECV_SPEED_LARGE.3 | 6 +- .../curl/files/CURLOPT_MAX_SEND_SPEED_LARGE.3 | 6 +- core/curl/files/CURLOPT_MIMEPOST.3 | 6 +- core/curl/files/CURLOPT_MIME_OPTIONS.3 | 6 +- core/curl/files/CURLOPT_NETRC.3 | 12 +- core/curl/files/CURLOPT_NETRC_FILE.3 | 6 +- core/curl/files/CURLOPT_NEW_DIRECTORY_PERMS.3 | 6 +- core/curl/files/CURLOPT_NEW_FILE_PERMS.3 | 6 +- core/curl/files/CURLOPT_NOBODY.3 | 6 +- core/curl/files/CURLOPT_NOPROGRESS.3 | 6 +- core/curl/files/CURLOPT_NOPROXY.3 | 6 +- core/curl/files/CURLOPT_NOSIGNAL.3 | 6 +- core/curl/files/CURLOPT_OPENSOCKETDATA.3 | 8 +- core/curl/files/CURLOPT_OPENSOCKETFUNCTION.3 | 8 +- core/curl/files/CURLOPT_PASSWORD.3 | 6 +- core/curl/files/CURLOPT_PATH_AS_IS.3 | 6 +- core/curl/files/CURLOPT_PINNEDPUBLICKEY.3 | 8 +- core/curl/files/CURLOPT_PIPEWAIT.3 | 6 +- core/curl/files/CURLOPT_PORT.3 | 10 +- core/curl/files/CURLOPT_POST.3 | 8 +- core/curl/files/CURLOPT_POSTFIELDS.3 | 6 +- core/curl/files/CURLOPT_POSTFIELDSIZE.3 | 6 +- core/curl/files/CURLOPT_POSTFIELDSIZE_LARGE.3 | 6 +- core/curl/files/CURLOPT_POSTQUOTE.3 | 6 +- core/curl/files/CURLOPT_POSTREDIR.3 | 10 +- core/curl/files/CURLOPT_PREQUOTE.3 | 6 +- core/curl/files/CURLOPT_PREREQDATA.3 | 6 +- core/curl/files/CURLOPT_PREREQFUNCTION.3 | 8 +- core/curl/files/CURLOPT_PRE_PROXY.3 | 14 +- core/curl/files/CURLOPT_PRIVATE.3 | 6 +- core/curl/files/CURLOPT_PROGRESSDATA.3 | 8 +- core/curl/files/CURLOPT_PROGRESSFUNCTION.3 | 11 +- core/curl/files/CURLOPT_PROTOCOLS.3 | 8 +- core/curl/files/CURLOPT_PROTOCOLS_STR.3 | 6 +- core/curl/files/CURLOPT_PROXY.3 | 30 +- core/curl/files/CURLOPT_PROXYAUTH.3 | 6 +- core/curl/files/CURLOPT_PROXYHEADER.3 | 6 +- core/curl/files/CURLOPT_PROXYPASSWORD.3 | 6 +- core/curl/files/CURLOPT_PROXYPORT.3 | 16 +- core/curl/files/CURLOPT_PROXYTYPE.3 | 8 +- core/curl/files/CURLOPT_PROXYUSERNAME.3 | 6 +- core/curl/files/CURLOPT_PROXYUSERPWD.3 | 8 +- core/curl/files/CURLOPT_PROXY_CAINFO.3 | 10 +- core/curl/files/CURLOPT_PROXY_CAINFO_BLOB.3 | 9 +- core/curl/files/CURLOPT_PROXY_CAPATH.3 | 8 +- core/curl/files/CURLOPT_PROXY_CRLFILE.3 | 6 +- core/curl/files/CURLOPT_PROXY_ISSUERCERT.3 | 6 +- .../files/CURLOPT_PROXY_ISSUERCERT_BLOB.3 | 6 +- core/curl/files/CURLOPT_PROXY_KEYPASSWD.3 | 12 +- .../files/CURLOPT_PROXY_PINNEDPUBLICKEY.3 | 8 +- core/curl/files/CURLOPT_PROXY_SERVICE_NAME.3 | 6 +- core/curl/files/CURLOPT_PROXY_SSLCERT.3 | 6 +- core/curl/files/CURLOPT_PROXY_SSLCERTTYPE.3 | 8 +- core/curl/files/CURLOPT_PROXY_SSLCERT_BLOB.3 | 6 +- core/curl/files/CURLOPT_PROXY_SSLKEY.3 | 8 +- core/curl/files/CURLOPT_PROXY_SSLKEYTYPE.3 | 6 +- core/curl/files/CURLOPT_PROXY_SSLKEY_BLOB.3 | 6 +- core/curl/files/CURLOPT_PROXY_SSLVERSION.3 | 17 +- .../files/CURLOPT_PROXY_SSL_CIPHER_LIST.3 | 12 +- core/curl/files/CURLOPT_PROXY_SSL_OPTIONS.3 | 6 +- .../curl/files/CURLOPT_PROXY_SSL_VERIFYHOST.3 | 8 +- .../curl/files/CURLOPT_PROXY_SSL_VERIFYPEER.3 | 8 +- core/curl/files/CURLOPT_PROXY_TLS13_CIPHERS.3 | 9 +- .../files/CURLOPT_PROXY_TLSAUTH_PASSWORD.3 | 6 +- core/curl/files/CURLOPT_PROXY_TLSAUTH_TYPE.3 | 16 +- .../files/CURLOPT_PROXY_TLSAUTH_USERNAME.3 | 6 +- core/curl/files/CURLOPT_PROXY_TRANSFER_MODE.3 | 6 +- core/curl/files/CURLOPT_PUT.3 | 8 +- core/curl/files/CURLOPT_QUICK_EXIT.3 | 6 +- core/curl/files/CURLOPT_QUOTE.3 | 8 +- core/curl/files/CURLOPT_RANDOM_FILE.3 | 6 +- core/curl/files/CURLOPT_RANGE.3 | 8 +- core/curl/files/CURLOPT_READDATA.3 | 10 +- core/curl/files/CURLOPT_READFUNCTION.3 | 10 +- core/curl/files/CURLOPT_REDIR_PROTOCOLS.3 | 9 +- core/curl/files/CURLOPT_REDIR_PROTOCOLS_STR.3 | 6 +- core/curl/files/CURLOPT_REFERER.3 | 6 +- core/curl/files/CURLOPT_REQUEST_TARGET.3 | 6 +- core/curl/files/CURLOPT_RESOLVE.3 | 18 +- core/curl/files/CURLOPT_RESOLVER_START_DATA.3 | 6 +- .../files/CURLOPT_RESOLVER_START_FUNCTION.3 | 6 +- core/curl/files/CURLOPT_RESUME_FROM.3 | 6 +- core/curl/files/CURLOPT_RESUME_FROM_LARGE.3 | 6 +- core/curl/files/CURLOPT_RTSP_CLIENT_CSEQ.3 | 6 +- core/curl/files/CURLOPT_RTSP_REQUEST.3 | 6 +- core/curl/files/CURLOPT_RTSP_SERVER_CSEQ.3 | 6 +- core/curl/files/CURLOPT_RTSP_SESSION_ID.3 | 6 +- core/curl/files/CURLOPT_RTSP_STREAM_URI.3 | 6 +- core/curl/files/CURLOPT_RTSP_TRANSPORT.3 | 6 +- core/curl/files/CURLOPT_SASL_AUTHZID.3 | 6 +- core/curl/files/CURLOPT_SASL_IR.3 | 6 +- core/curl/files/CURLOPT_SEEKDATA.3 | 6 +- core/curl/files/CURLOPT_SEEKFUNCTION.3 | 8 +- .../files/CURLOPT_SERVER_RESPONSE_TIMEOUT.3 | 9 +- .../CURLOPT_SERVER_RESPONSE_TIMEOUT_MS.3 | 6 +- core/curl/files/CURLOPT_SERVICE_NAME.3 | 7 +- core/curl/files/CURLOPT_SHARE.3 | 6 +- core/curl/files/CURLOPT_SOCKOPTDATA.3 | 8 +- core/curl/files/CURLOPT_SOCKOPTFUNCTION.3 | 9 +- core/curl/files/CURLOPT_SOCKS5_AUTH.3 | 6 +- core/curl/files/CURLOPT_SOCKS5_GSSAPI_NEC.3 | 8 +- .../files/CURLOPT_SOCKS5_GSSAPI_SERVICE.3 | 8 +- core/curl/files/CURLOPT_SSH_AUTH_TYPES.3 | 6 +- core/curl/files/CURLOPT_SSH_COMPRESSION.3 | 6 +- core/curl/files/CURLOPT_SSH_HOSTKEYDATA.3 | 8 +- core/curl/files/CURLOPT_SSH_HOSTKEYFUNCTION.3 | 8 +- .../files/CURLOPT_SSH_HOST_PUBLIC_KEY_MD5.3 | 6 +- .../CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256.3 | 9 +- core/curl/files/CURLOPT_SSH_KEYDATA.3 | 6 +- core/curl/files/CURLOPT_SSH_KEYFUNCTION.3 | 6 +- core/curl/files/CURLOPT_SSH_KNOWNHOSTS.3 | 6 +- core/curl/files/CURLOPT_SSH_PRIVATE_KEYFILE.3 | 6 +- core/curl/files/CURLOPT_SSH_PUBLIC_KEYFILE.3 | 8 +- core/curl/files/CURLOPT_SSLCERT.3 | 6 +- core/curl/files/CURLOPT_SSLCERTTYPE.3 | 6 +- core/curl/files/CURLOPT_SSLCERT_BLOB.3 | 7 +- core/curl/files/CURLOPT_SSLENGINE.3 | 6 +- core/curl/files/CURLOPT_SSLENGINE_DEFAULT.3 | 6 +- core/curl/files/CURLOPT_SSLKEY.3 | 6 +- core/curl/files/CURLOPT_SSLKEYTYPE.3 | 6 +- core/curl/files/CURLOPT_SSLKEY_BLOB.3 | 6 +- core/curl/files/CURLOPT_SSLVERSION.3 | 14 +- core/curl/files/CURLOPT_SSL_CIPHER_LIST.3 | 14 +- core/curl/files/CURLOPT_SSL_CTX_DATA.3 | 8 +- core/curl/files/CURLOPT_SSL_CTX_FUNCTION.3 | 7 +- core/curl/files/CURLOPT_SSL_EC_CURVES.3 | 6 +- core/curl/files/CURLOPT_SSL_ENABLE_ALPN.3 | 6 +- core/curl/files/CURLOPT_SSL_ENABLE_NPN.3 | 10 +- core/curl/files/CURLOPT_SSL_FALSESTART.3 | 7 +- core/curl/files/CURLOPT_SSL_OPTIONS.3 | 6 +- core/curl/files/CURLOPT_SSL_SESSIONID_CACHE.3 | 6 +- core/curl/files/CURLOPT_SSL_VERIFYHOST.3 | 76 +- core/curl/files/CURLOPT_SSL_VERIFYPEER.3 | 6 +- core/curl/files/CURLOPT_SSL_VERIFYSTATUS.3 | 7 +- core/curl/files/CURLOPT_STDERR.3 | 6 +- core/curl/files/CURLOPT_STREAM_DEPENDS.3 | 6 +- core/curl/files/CURLOPT_STREAM_DEPENDS_E.3 | 6 +- core/curl/files/CURLOPT_STREAM_WEIGHT.3 | 9 +- .../files/CURLOPT_SUPPRESS_CONNECT_HEADERS.3 | 6 +- core/curl/files/CURLOPT_TCP_FASTOPEN.3 | 9 +- core/curl/files/CURLOPT_TCP_KEEPALIVE.3 | 16 +- core/curl/files/CURLOPT_TCP_KEEPCNT.3 | 54 + core/curl/files/CURLOPT_TCP_KEEPIDLE.3 | 10 +- core/curl/files/CURLOPT_TCP_KEEPINTVL.3 | 10 +- core/curl/files/CURLOPT_TCP_NODELAY.3 | 8 +- core/curl/files/CURLOPT_TELNETOPTIONS.3 | 6 +- core/curl/files/CURLOPT_TFTP_BLKSIZE.3 | 6 +- core/curl/files/CURLOPT_TFTP_NO_OPTIONS.3 | 6 +- core/curl/files/CURLOPT_TIMECONDITION.3 | 6 +- core/curl/files/CURLOPT_TIMEOUT.3 | 8 +- core/curl/files/CURLOPT_TIMEOUT_MS.3 | 8 +- core/curl/files/CURLOPT_TIMEVALUE.3 | 8 +- core/curl/files/CURLOPT_TIMEVALUE_LARGE.3 | 12 +- core/curl/files/CURLOPT_TLS13_CIPHERS.3 | 10 +- core/curl/files/CURLOPT_TLSAUTH_PASSWORD.3 | 12 +- core/curl/files/CURLOPT_TLSAUTH_TYPE.3 | 13 +- core/curl/files/CURLOPT_TLSAUTH_USERNAME.3 | 12 +- core/curl/files/CURLOPT_TRAILERDATA.3 | 6 +- core/curl/files/CURLOPT_TRAILERFUNCTION.3 | 8 +- core/curl/files/CURLOPT_TRANSFERTEXT.3 | 6 +- core/curl/files/CURLOPT_TRANSFER_ENCODING.3 | 6 +- core/curl/files/CURLOPT_UNIX_SOCKET_PATH.3 | 8 +- core/curl/files/CURLOPT_UNRESTRICTED_AUTH.3 | 6 +- core/curl/files/CURLOPT_UPKEEP_INTERVAL_MS.3 | 6 +- core/curl/files/CURLOPT_UPLOAD.3 | 20 +- core/curl/files/CURLOPT_UPLOAD_BUFFERSIZE.3 | 6 +- core/curl/files/CURLOPT_URL.3 | 15 +- core/curl/files/CURLOPT_USERAGENT.3 | 8 +- core/curl/files/CURLOPT_USERNAME.3 | 6 +- core/curl/files/CURLOPT_USERPWD.3 | 6 +- core/curl/files/CURLOPT_USE_SSL.3 | 12 +- core/curl/files/CURLOPT_VERBOSE.3 | 6 +- core/curl/files/CURLOPT_WILDCARDMATCH.3 | 6 +- core/curl/files/CURLOPT_WRITEDATA.3 | 16 +- core/curl/files/CURLOPT_WRITEFUNCTION.3 | 10 +- core/curl/files/CURLOPT_WS_OPTIONS.3 | 6 +- core/curl/files/CURLOPT_XFERINFODATA.3 | 8 +- core/curl/files/CURLOPT_XFERINFOFUNCTION.3 | 9 +- core/curl/files/CURLOPT_XOAUTH2_BEARER.3 | 8 +- core/curl/files/CURLSHOPT_LOCKFUNC.3 | 6 +- core/curl/files/CURLSHOPT_SHARE.3 | 6 +- core/curl/files/CURLSHOPT_UNLOCKFUNC.3 | 6 +- core/curl/files/CURLSHOPT_UNSHARE.3 | 6 +- core/curl/files/CURLSHOPT_USERDATA.3 | 6 +- core/curl/files/curl-config.1 | 2 +- core/curl/files/curl.1 | 6148 ----------------- core/curl/files/curl_easy_cleanup.3 | 8 +- core/curl/files/curl_easy_duphandle.3 | 8 +- core/curl/files/curl_easy_escape.3 | 42 +- core/curl/files/curl_easy_getinfo.3 | 390 +- core/curl/files/curl_easy_header.3 | 6 +- core/curl/files/curl_easy_init.3 | 12 +- core/curl/files/curl_easy_nextheader.3 | 6 +- core/curl/files/curl_easy_option_by_id.3 | 6 +- core/curl/files/curl_easy_option_by_name.3 | 6 +- core/curl/files/curl_easy_option_next.3 | 6 +- core/curl/files/curl_easy_pause.3 | 6 +- core/curl/files/curl_easy_perform.3 | 8 +- core/curl/files/curl_easy_recv.3 | 6 +- core/curl/files/curl_easy_reset.3 | 6 +- core/curl/files/curl_easy_send.3 | 6 +- core/curl/files/curl_easy_setopt.3 | 1214 ++-- core/curl/files/curl_easy_strerror.3 | 6 +- core/curl/files/curl_easy_unescape.3 | 10 +- core/curl/files/curl_easy_upkeep.3 | 8 +- core/curl/files/curl_escape.3 | 10 +- core/curl/files/curl_formadd.3 | 8 +- core/curl/files/curl_formfree.3 | 8 +- core/curl/files/curl_formget.3 | 20 +- core/curl/files/curl_free.3 | 6 +- core/curl/files/curl_getdate.3 | 14 +- core/curl/files/curl_getenv.3 | 6 +- core/curl/files/curl_global_cleanup.3 | 6 +- core/curl/files/curl_global_init.3 | 25 +- core/curl/files/curl_global_init_mem.3 | 8 +- core/curl/files/curl_global_sslset.3 | 11 +- core/curl/files/curl_global_trace.3 | 6 +- core/curl/files/curl_mime_addpart.3 | 6 +- core/curl/files/curl_mime_data.3 | 6 +- core/curl/files/curl_mime_data_cb.3 | 6 +- core/curl/files/curl_mime_encoder.3 | 6 +- core/curl/files/curl_mime_filedata.3 | 6 +- core/curl/files/curl_mime_filename.3 | 6 +- core/curl/files/curl_mime_free.3 | 6 +- core/curl/files/curl_mime_headers.3 | 6 +- core/curl/files/curl_mime_init.3 | 6 +- core/curl/files/curl_mime_name.3 | 6 +- core/curl/files/curl_mime_subparts.3 | 6 +- core/curl/files/curl_mime_type.3 | 6 +- core/curl/files/curl_mprintf.3 | 9 +- core/curl/files/curl_multi_add_handle.3 | 6 +- core/curl/files/curl_multi_assign.3 | 18 +- core/curl/files/curl_multi_cleanup.3 | 17 +- core/curl/files/curl_multi_fdset.3 | 8 +- core/curl/files/curl_multi_get_handles.3 | 8 +- core/curl/files/curl_multi_info_read.3 | 6 +- core/curl/files/curl_multi_init.3 | 6 +- core/curl/files/curl_multi_perform.3 | 8 +- core/curl/files/curl_multi_poll.3 | 24 +- core/curl/files/curl_multi_remove_handle.3 | 6 +- core/curl/files/curl_multi_setopt.3 | 81 +- core/curl/files/curl_multi_socket.3 | 62 +- core/curl/files/curl_multi_socket_action.3 | 8 +- core/curl/files/curl_multi_socket_all.3 | 53 +- core/curl/files/curl_multi_strerror.3 | 6 +- core/curl/files/curl_multi_timeout.3 | 6 +- core/curl/files/curl_multi_wait.3 | 8 +- core/curl/files/curl_multi_waitfds.3 | 8 +- core/curl/files/curl_multi_wakeup.3 | 8 +- core/curl/files/curl_pushheader_byname.3 | 6 +- core/curl/files/curl_pushheader_bynum.3 | 6 +- core/curl/files/curl_share_cleanup.3 | 11 +- core/curl/files/curl_share_init.3 | 8 +- core/curl/files/curl_share_setopt.3 | 8 +- core/curl/files/curl_share_strerror.3 | 6 +- core/curl/files/curl_slist_append.3 | 6 +- core/curl/files/curl_slist_free_all.3 | 9 +- core/curl/files/curl_strequal.3 | 29 +- core/curl/files/curl_strnequal.3 | 32 +- core/curl/files/curl_unescape.3 | 12 +- core/curl/files/curl_url.3 | 8 +- core/curl/files/curl_url_cleanup.3 | 9 +- core/curl/files/curl_url_dup.3 | 6 +- core/curl/files/curl_url_get.3 | 20 +- core/curl/files/curl_url_set.3 | 39 +- core/curl/files/curl_url_strerror.3 | 6 +- core/curl/files/curl_version.3 | 6 +- core/curl/files/curl_version_info.3 | 6 +- core/curl/files/curl_ws_meta.3 | 6 +- core/curl/files/curl_ws_recv.3 | 6 +- core/curl/files/curl_ws_send.3 | 6 +- core/curl/files/libcurl-easy.3 | 31 +- core/curl/files/libcurl-env-dbg.3 | 11 +- core/curl/files/libcurl-env.3 | 2 +- core/curl/files/libcurl-errors.3 | 2 +- core/curl/files/libcurl-multi.3 | 2 +- core/curl/files/libcurl-security.3 | 12 +- core/curl/files/libcurl-share.3 | 2 +- core/curl/files/libcurl-symbols.3 | 8 +- core/curl/files/libcurl-thread.3 | 2 +- core/curl/files/libcurl-tutorial.3 | 2 +- core/curl/files/libcurl-url.3 | 6 +- core/curl/files/libcurl-ws.3 | 4 +- core/curl/files/libcurl.3 | 2 +- core/curl/files/mk-ca-bundle.1 | 2 +- core/curl/sources | 3 +- core/curl/version | 2 +- 505 files changed, 3545 insertions(+), 9539 deletions(-) create mode 100644 core/curl/files/CURLOPT_TCP_KEEPCNT.3 diff --git a/core/curl/checksums b/core/curl/checksums index 930479d9..312ae9e5 100644 --- a/core/curl/checksums +++ b/core/curl/checksums @@ -1,502 +1,503 @@ -39168f2d11ce2a9ed5ab26351c3b899ab73a445245b9e8fcf34e7b805b88df8868 -0579dcf8fb3c97d272cb45f4c9d25c2fc24ad84ad43b01ff84bbeea20fb714f613 -0304f089743036defedb599b746553f9bc63c8f83e3e3a001f742dcad1226eb6e2 -78fca51254f3afd0094cbf764e80f1712f5688e25f3026db6a4edc6b3105b30bfd -1910992c01f8615f4ba2a6f4844e219d6e4a23ad927325a1e1e82962dfcfb86799 -f50439c128335f8a5eaa46a0a6b832b362d174d488d0e71eabb1a429af2beb90e3 -f94823d33754857e30b848f827b8001d28896b9cb74f089166411d8c2dab7a4dad -23029d7e7847976a9052fc636943c147b9687c9691e279c9791e24be4d0ecd2400 -3b3ca1ff9dd1e649160d1d062e4e9acb4f7cd3827a468f7d0a8cddc85412b52891 -2f58e861972ef9403292cb6868f7ecb11184a404cb5a470518e0d2efc0d1eb9d20 -2d907999e36dadb7582a74713e7cab64875ecd20c66a2c3aeacb91d375496f218c -43847e3514705e63b648a3c3f86cc591888f2c06f9735fc81f7931bc9201e04b3e -0846f71c7167a58f07405e54a682bf104fd9b8c8d672c96fda1fb5ba6e6f8713c0 -90fdac90288b8e48fbd3d3f67c18a69af0c8f2b27797840c0235c1ae8d3b77da23 -015fc6a699739c61abcc711d5f93b6d84c6b31cc896c25057dedc765e765c43d3d -e249beecf0435f73d0544f20ea7ff2cd46d612acc7abcb88eb28c4fb25f2b24474 -a8f668068d8bab67089d82c8bd648117386e9345565e1ff10caa5c76960789b166 -dbedcca53b3de655fbd86ad85027a1886fc912807356c070c8b8245b43e7c49265 -0ce0757f217fcfc47cea1d82d7863238eaaf3f17221bfe14f600a44fd1425ca2cc -06fe933c3155d8521e65dddae4c8ff1930ec3e1ab37cd9a98505d52eb6cdd9174a -c1a479634c5d97f501b9b60658eade5708c93b4cf1d7ba9f56bd100579091be453 -104b007b0298cbe96118794036c772c6e91a22b4ec0140540b6444c041fb6a24fe -96fd44daed3765fbc8e5837ecfd7dbf13b5abac3a063c3c4b2e930c78b255321fc -07df4b84dc99ee932453ec88ce60f20e286abfcb257f069125ba2d4eb7b85f52d0 -b9491edaabb8d1878f2cbfe4c549d2e54a6319a5e6d945e36c9830fe456759170a -7334649cdfa012bdcbda910305fc61275d0705c0389f4e3ec368e7f88b1bed2700 -d18a988bfd9cacfc228130718004ace4d9e76db0cfb84117c6dfe2c197f68aebc1 -27c1faad0fc268897eb649c6af749bacdacfd2aecb923424f30f1091c35403206e -7d70ce26daa43a318ef8ed39a4564fcddd79c6a51686b1116c06076e0425759d66 -c1e8adad7fc49c298bd597e2b473af343320cc6361f4d47c74f3761fbe2ffcfe81 -34aa53903b3dde2261a6c90e2a3c7237b411518119a0ee94aeb9d0bea5983184d8 -5ad62015f199b9f4f20a91987345f567e6c48a9c3fda4529a6627c6779220939a8 -951c5bf40b85aad3ce0eda71d84f288038159d24b171df9b8c5845054164c7de77 -a58f03b39de244338df5aea13d4b5570eddc54e2d0ba68c4de4a937d95bf9c8b47 -a2a38956ed8996e2c26326fc5e3706dc70e675adc630945345a3b65e64d209440b -83ecb96d52101484491eea41094996e9a6501f18c36cf7a75a67794a4e21ac69f8 -e33ea668addb305cfe621c77e1e643ab01441fb91e10737722485ee8e307e2e6ed -d4b4fec01aa107c6db2ae1fb8ac8b17528f32b263548f93ebc0538991c5acd7fc5 -bc3a89be711be953d6a8bb2bbece0057cd45cbfb9279edff15d5512a7e8c724c6a -796a5fdb1b2f7b5acd74b7b13576cad79f4624f0e5fd55ad33b43bf9b6cb5924d1 -ab6d39fd7ab5d36b11c585639908ebe2f616d1b15a9be4f504a30d81fd328deb04 -fb5968f007d58921ef206cec5c6503fc092a62c4a3428004a397631d46cf64deb1 -36bb8de386c7c2b88fe2ddde2392bc0021113f09a850dbfad5ba1c5dcd7246df41 -19f836954c236366c11d5e015a8f6803e32dcc5d6fd0ce8fa017839dbadbda7e76 -f4d50d55a22ab8412c265a8391f62d3b701773f85e410b54762c16ec996f28ecb4 -ef8469b47c5db49837885517dbe2a3dff448ab12b7d1c8090ba82d76d1ebafea09 -7d6718eedd8d6fb80ab7b9b90970762cfa6ab0652ce2edd58f49dc877040308008 -cfc81372e325e52fa3bd59a8668c41ab233adc5136e7569b00134a1f443f0fdfed -7466d691825283cc338ee4ce5f165e0ec0f8ea029358c556fd677b36473522a957 -1c0caa8da0e5b195b234f5d0a060f7dd42418551c044605f49386950870c5eb461 -7fbd71f392212723d7a8b50dbf09ce3a9b75256e4c67ce41f5ef13fd9006b2a8e3 -454a6f37b5ea3a7f5d0f122ec1fe1e62b8428e5ede66a396948216360e4ac0ca3f -f4095279ce37542e57a9868d7328ea7a48d1d39b74aed79e4667971cf74fa14c36 -a9d8a65707d445ee68a4572cbefc64ce67d3e5eb7f0611b491039a0dd755c4fb99 -29adb20c0f1562d8ce709bb5e09af2ae2e32319c3b60d993b0e25b3969c46dd50e -430f60abcad3836949e3fef6930f02073c8ce999509c781373f3322506582c8143 -1cb97a66cd8aeb0c66f0d9dddd1e8009d1514792198fdfe2abaf2f078d048b96fc -3d851bc1c40404af3f3407216a53dd503a240d02e70ebbdacb92a369754c7f20d4 -286b0310fea8e1af90f4861e727c341c8be47e8341ed5a3c6c0b01603ada8c1cfb -b6a3e8a92568a0296fb73645d9cbb3fdafd723529ea7035e85b1a103f793ca4913 -5784ac216b5b4c0ceeb547fd565cf0d05de11e397ac803ef9d471d76b60d7a1813 -55bd3621b2e76489c590a4b19d484fb13f4aab863ca1a7f418c944ac86bf78af6f -241e62d64f630388b00992345c9c110b51a700f770adcbbcffaa58b042484e84f7 -a0026d19ef1287cd020be322827a5739b00cf3bf5d516c3d2ea9c80cc5da4265c4 -c2fd145e396b091a3536a5c2612233e72941c4b90c8e32558efd903044dedb0593 -223cadd5b7e7305a092cc9236a46dfe18cfa8b33a271c1365205d2476400f7693d -24fd9bcec1824b8127dc484b97e8e5c603a3a725b1dccd69c6c623629308a55286 -b2b74c349ab95ece01fd65211b4eb3ef0ac9c84ecec69085e0edd46d0d8b7cf87a -47197d2126a358d204d12d8b4b4f5e3f0fbb653c8e1f5ad0f8ff65624e032e0775 -0b5f4f0096239f9a21db8b11da0ebcc13c83932ec719b21d2e92522c1f83bba6f0 -208f3cd765b07bfe45bc0b5eaf4d0ea73daaae198e7a611c0dac351f1f803b23a1 -b557fb10c84e69da55ec938082f41162a56eac9dc86440d8196ee34994278bb0eb -03a440faa5b0c3e831cc08ed31840c5111ad2521e0f5dcabc37df2038baaa97822 -852d61075a1b9528f68c1d8770c4f35dfda296225d02e8a74b29049d41f502a95b -7d8e2a4ebd54631ed97437ce4a60e4f41e221053d3e3fd82635e9da6f4b6c6957e -112b8c642b6dad393e64e54ce2dfef00ed4531189657a2f922050ca3132fe0fb18 -bb5c79284009e454145e180fd0a68ac85d2f542e068b0173da6ac812e607eb9f1f -8f72dd082af296c83d1213920c772b51c256c9088ac83aa38f21fff28635920aea -81e064cd94d5184454f8af2355098bcb31567889b6c50030ba28d8d0c5f6c8de19 -111eccbd4599a026ee69ad9389070746ed25d1f7af6b8c105eece9e66c14b252e3 -2a6ebb7f3e4921dbd1cb88063e88f601048bbf3b91e335a148a835d39514dbe085 -0bd55b50e58cc79f070f932192c4d8fc1e6af3e13f37dec3a47d3c6c25a682a8c1 -57c4601d330dee2d567eb35ef49fff92d40a56c05851822ad455d0686cf51513aa -ddf4c4e846f10abd5ff6f53804d295cfbdec426dc40a906ed5c7b1c1624f685034 -3090c78b79db7d899e541d09c6f35f62208653b0ec4169d231272ccbe89d14cd7d -bd7430c5caa95149b56d5f0488247f73e122d0432c7ebff6756aa67d57223b139b -2b60bac587d4075dd179025585dd62a03a87d38d9f8cc83407bbd5d34a1bea4643 -eccb04b7cfca6419d08834386fb586866ec8d0a0606f0c9ad28f8a0db816f68487 -898472193a2a4b2c50814df00cd26e09896d4698ccb7340518bf732751b6fcbd75 -140b5352fcd90dfdcb2a8f7daf9822d8db1a610e31e00a7245ddeba7698e12b65d -868631d6db1d98a33f82d98332e65985cf37470f9efe5dbbaa04ab108bc7f112c3 -df2c39b51d18024f6c620323495b7aca3431deb557a94108010f67d84fd1908461 -3a064ec826df795cf9c2e0e6780cf7ca6d6f4c49dd1e1880b95754b3982d54014a -2cb9db34193d9308e2f91e76b1af7da217dd38404168241daa6d09b729d5c28e8f -2c584f02e51a88c4448dd275977222dd928a0d6e345d120ff5d744e99f082dfc4f -19a3285abe2c8e2d40bd732b9fa2910f56921baea804231b8bc7184191ecdaa3e2 -ba4273b814dffacb9e47056181487cbb51528a12078ad814361d22e9a60144a3e6 -bd3e929a15ad70935f76ca2248188157ae62dcb7732defdc816bf82a58992f7234 -019fc3ea28869fafa5cc768b8f100bc56d6a17ca15d501fa50be3649c16f7d8c9d -cd4f6bc2b7dc4600dfc29e7ad746529a0c439610bb06566ce7cdb6a8f39e2de847 -35ba8493e22dfc6ca1a992f464eb059551fbb2de729122560de39773decfec11b6 -85fc64840bf12423aa57b6124a142d49baa686fac4289514461ba96487afadf3ec -bd19a07af9c49d3f132ffccf86dbf0df072019e4200e6a79b218e34b916ec0c13a -9009d74e073fd6c33ea0365e52f1e035d923d3dc3d4460cb7dc6ddad9a813756cc -8e31fd586e2313e9b470b85242bf2c82c8e5d7a368afbf4731e3299e145cf14c4d -79e4d4060c2baa68911eb5415a922260618cc49fab973857650d472258914f3949 -c6a29cc83698f7b472aaa8a63346ea5dfa87272dddcf6c53a9f2a463b10eb0dca4 -4f0d5d034ea9afb9822cc48c08a47b5a0900996c09a9071bc16e02a971d031c2a7 -8493a4537804c328072b011548ac23789a310116457e67e67fc86220c86524b246 -f51f8e199ffb78024fb97bea0ba8972992ff272cf22221870e50a026eebd5eda07 -b4982c6348a03ecc719788fb46fc6b4467eeb42755d34fb9bbed38d628d944ef0c -deea288e0ccc0446f2c7510afdbfa7fc4bad384f4706b642dbbbe0f1a9aaa3da23 -85f9c86b42392e428314567e194d95ae8a8bdd2285ebf01acb08fbbb49114c17c0 -4440e9c28c47c93147b933a0278ed732b52f184eccbc6b0691735c44281b29e514 -e897ff3199fd54b5f1d4f51a60d2a8b299ec2c914e7b59293f28a618c9f758cf74 -7342f0883cc5b617dadc02ac669312d9c4230b20c4a56776f278531c15942f6824 -e1a96a380e1fdaa82a3c1f5f8197d13408ee49e0b48e81a60adc1dd40795b22a3e -3a93b703aedf10dcbb73d72eb89ab550dd2c45797ac1674fbfcfb7a0773c66a48d -6c048c945f5877d6ee4b864530d685a898b6c40abd3e2ac9d73af308daab1c04f9 -79160adca6b040897fa70b9c2ceece6eb4a104a5a20f72c437b44b51d2dbc7a4ff -347936ac266e69552bd52d2986d773d476c91adceadc20f71531d684892d2f88ef -150a5fac9c0900fda215fb83b814674286590c8ee61429107d9ab7780b1d7dd78f -91c945e2ae96607709b91ecdb0a84cdce1189f07b6a95bacf9178f84b9c7ede8b5 -19781c7499ca6ffd0c7d41698dd40bf7c39ce7d336b35aeb4b24c3df9652d62228 -d975c6d8dd4f36b6abe71ef699cc35578f7b5dcc9c9f2c47f45e276025d797dadc -a720df1e6408dd8df75d87d4ce4d36bd33ed10b45a717f130cacee406de705159e -2693d147bfd7b0f63d4b3b5071cf88d4e8b65afe7a0702153b7969b277c1e1a366 -fdc1cca3fac5af6328e29ac07ba5738cf2a78ceb8a91fb0166dc9d6075f65fd56f -6f8a74338d42c018a43369e5796d009ea025e06b929a697b3c0a0db58ecb26ac5b -b117c32636dea4e6c4d5b4ab7d55e1429db3fe47f3a10b13cad0c9fd59a12eceb3 -7f1c8dc3e7e52e38ccdea7406423acfdc00045a7a7e359d226b4fcd22fa73c9bbd -6d67bca654c5fc6ef08bfad0f18e919a681d03f8d910826af4d500aa15e09a2fab -4525d2d7b847d03c5ce614d65f257cab37a62653c1b0d23eabe30a56451e3a07d5 -42a8f01f3ee34d82d6702c5c5ec08dab8123f9b7ba9f7faa3548d017ef4d7aec1f -043984094b245123e9d4a9563921c490bb760c72deaf1705546be9d97354e60c07 -9ba5eee9314542abd7fa28723b6f155bc6727229776429f2c7a2b6b318033d7adc -c5e6ebebed32fe48aea310a8766ff4540f458ae161379f85ff4a3671e072a8143d -4f7a6ab3ec621adde23d83d7dca8f4a3fbbf5d22f4b853bfad62160bd4e0124d7b -7e48f621de82491c1fdd14d716b840339c4cd52493c51ab0137e3ef0bda6b99da9 -2b7bfa974b3bf9baaebde9ff3303e57da811a8e6f290227dd20e42420410a7efd1 -d240f61a86f9fd7a678cddbe24fc7516cbce1ecbd9ce8ef77c345de41d26d8bbe8 -933ce330d93257a9f2800a1915fe298ebf1f6bad3aa4ebf380aa050f91a7326cfe -29cdd6606e56c6b938d35cd6f9a316ebc92aca7f8921324916ea3751488b85e45d -ce71f86b811ead2ffc5bc5e88b4aa50c0150886c6bef42ae1e51984734f0ea5463 -16e594834ab4b75465296c60953e04d1ee1d9075cd8c85d17ae47429508d289ea5 -8b5ab3c7cc6534a1b483713d36127c6f5048136f98d248cc7e024e7dcc63edd723 -9e5deaaa265151ca010bd2a1276de9a95bb893b264ea8f2551b3939f15537a9c80 -09accfbb572f6b97f83b26a5e83bb2e47ea3438c2d609d6841eb15b729f3a0a0b2 -415733c3b85693a939ade665db133b844897f1416048808a2bac0825386de34418 -c52529f40dbd4ca5993dfc17f388d7c66a4ae19199f35025a46289bb6a64a7c78a -d56b0201694a9b6d5a793e3ad6f172c44a2e58dd55806603f959636fb8955db46d -f4f635047dca1dc43ef1b32dbe7d2eca3a89cdea6cc702cbf1fd27b7fcbf8f06aa -b4c902b2b5c3e73f9f0bd6cd788fc0d828afab42c8b406d1670609d4f149a5e005 -169f52aa2540072fa2903ad94b93c19fc3dde8bf15739787b1b16c34539bd6b23c -30357eec9b3cb8f30602dae4288b1f98e29ce8d812b9e9c23b467a2befa1c1bea8 -40da9573cae4b9094afcc68269a481b7c982e7f4fd00c96109e586559200915b44 -cc932c32f33b1e158f7975b388da3c231bf6669e28c9e95e0bf3b84bd5d3d9c0af -3224de13e34c479485e6afc913450529bb619164809d0a8e52277431ca87c09a6b -fda6e5fbff5672e621e326e50d169ec196f677d2151370f22eae4f041dcf6d640d -a95dd798c6944618f031ffb051347db3af78bb5b640ca2ec08f87af947c436aa75 -29050027bceaf4103bebeeae3489d873d5b9c8208da1d8e6f3128a77c19e88b1ae -c173cc46b11e9660471c7b647ee23ede84fee3d4fb1bc49ad2a7755ba8846fec16 -4b934d6c79c5173985a198984b2f475de969c551ab98e011fe18437fa3019820e0 -b1a51ed290af80b0e3ec3951d363b670e0c876b2389f5a7bc19c6ad18e6643aa1d -ede2e7234c2f07d8f9356d63f9f73796ccec240e9505936c2d47e45123adbd3f42 -a7a651aed9635f4848143318452507d5fd31337f8bad47e30261d1e616cff7302e -3699d2c34618621ee09878b322c573d88f2e925d6d903c465b5d4bc99a91968d42 -2e938ec7ddc02b5bcb027650519ad69ce1c7710abba0b11870a838e1e8e9fa185a -f826896fc73101829b7309834f2beec2592a0336ede1f51a9fd4b3565a07fae5f0 -901754573681b262587c466cad3f7f67d80e0089bb63d8d009dbbd0a84f655aa47 -5814cea9e1e224c72d85295368604b5d75eeb72bb182d0c1ad49a857e7e0bbc28e -3ce0c20a305543b717a83241f9f2b4ad52b232cb752ca8dc691da50b71a64f46bd -f5544f84cb137badc1b3375c6c1a87f8fc5cab1708ce2bdfd4f2111c9b1d60719a -29363d80f4e500f63ca06819d6c74b4e4095552e73c4b83b77c96f4c061025f72b -3f4ab03673c5d41994fd5ea5d90f3a4c63eb199f4895d3763a72af90a017a60ed8 -8c398c7d5441333c027f3a4a76ea62209a5fee9f1d25ea99f1822b0340148e8599 -0d3836c1f2957c06600c5d5dfccdea0a7907e05c56dce8f43f0228b362b0d15ac4 -731e913e6fa2e2a1bad9166bcacc7e183ebd839c2bfc0164987ba7a5a99c3ada5d -1512c0a8aae6432a9398c3cbb1620d27d105f99d5c67aebb81491da764fae2123e -83c083f9618b01ab58b9be632d43063c263ad4b1c50d3d9ebe04a05644b0efeb65 -d9bbc42034bc1dbaa6b10b213b9996767be212d98b1f8e33bf4b74157ac0e545d4 -9b431befe9bc60c0a1ae6a43615a56ad34bdbe7c37aeb9985ca89762a3316c3028 -20faf9690fc1fcec71407244cdba8f04545e89de23fa66d5f0039439c67e22d32e -1092e0bfac4d40c67e90be3206a3963297007de9e1fe4f3070df883e87e712380a -fd62f7fa481dcd5e1291d0180f680bf4c92177f9493ee02375df93a31d65c09216 -1f63caafdba72045ff543559e6091895dcf3c30e3247447265ed7c110ff9838fbf -c165a5762a30c89b791fe81ae2beb889150b318c20b679dca07461ffee5f9077bd -612ddd4b6211dcd733bc028872b30aa64cb6b19f95d93016c58624791960e9da84 -9f74990b20f543179890439ceeece6922a4db1f2ce1f2ff02b19d14effb5c26d83 -e516d72c4c9de7d1b48cef2ded3d5ff9156e57492d6c3b4611e019869c9d30947c -80829d0d490d65bab87bef90948a80668c6995f1ca8fa3bc25cbb739cdbc789337 -58eb17e1e4365ee2fd47d59629cacfc1ad00d8a4fbfd271fd856556676d78fcf9c -3414b6a233a15d68ffef87cb7ae203b217da173c9c4daf6a3e678d4a1bf8f7558f -ba31489835d9b701e675ad06cac1d4931ff96a82c55369f3dcc4581454f12500b8 -96c7083a36235c6567323a18f3c06177ea01840955ba1c0189cfe2253a8e8a5a02 -67825ecba294221e74cef71cc90c9f4f3417497f23989e805960191d5def61746b -b5528ef52ce4e7c1549bd8cf6df51719f0f969c4d0cd381190120f6e726437f4d7 -8a4fa9e620182a5e87721a8678a25a6b391b0f75ba0122c5acf33057d2e66f673f -0f0367e52cc04a92210c3c0ede2c465dca9efc7775ac269dd91bd1ff75da5f8742 -aa854cbd27386a843420f76f011f6f808fc1bd31dfc0fbf2fc60a721b98c4e1a70 -b6006d7381e9325ccabd049597d8fde9262a9735a73f58bc24a2c4221ca940aeac -980895ab2bcaf3c0bc31837ea189b51362166df5987607a32cff9668925c0a5324 -f9362de17f200e8f46e9a87b7d9355df7d553b7f63739e4e1a1469b3f96d48986b -5628cf7795f5d857e4493ccc696d941329825dc5a18b0e4871952e4b54fd6496a0 -acc527da4c241bffa39e32d660706b1093ff754d28ae643c3d0b3535f53660c857 -be7f1e0b00aca05b8ecfb9a5fff4ee6c478e3e6d5f4f9124cfb748863903a64676 -b32705f149a6153e85234b538fd02e25611293f8664519513c8c4dad3a2a25cbc6 -1991ab3ce3206068c676b95b5a011b17868914d44a2ff4c238df7c42eb6b0925f3 -b407d7269d4ec16c8f82dd76d9f6a3f58709eb75e2a8079abbbd761f97042b003e -996cf1a498a27c86c04a250b7507757d78efbde65436d8ac6f2b29440c530e661f -29e72adc522d9aca04dafa0b600038989bc2a7a16838199ca8e672768c48645884 -aa21ab65e20d2bbb4effe3bfd1c74cef7c503fbdf6cea7903f13f2f36669bcd3ca -1378c1b9212b7b60ee70827b06d3e055f46d3399fba1bfc12a93468a09ca7ae997 -b406991c0d336d2416acbccc668578c1cf943515d668d7e196278695a70abde193 -b7f3c30b5e05a905927fa4c0594772e86d7fc45dd86cf3e43a24cfd04a5e4e51b7 -2275bd599e01f3142448d18a06e9090dd10ec34ea3ffdc734c1c0f0552a16e7f50 -8dd9ade0641de5807f7a52df6fd53c60ee839dbcf65c8cad35230087672bb3f188 -e4f8706888c372bd3c97366d3fd1980ec1987a98a0ea92c17f7ae87d28bdf1fe6e -87be487dc19ce74e4997d0356195256f36c618cda37120d1e3ca7cd81f1aef9bcf -5416416b154dd4728b5f27798c0c76cd90323a11979f0ce05bf75ba2e3367faabb -cda83ded0164e8af4e01b7eb582a737fe5a2a4a808fb1af5d14a739bf2bda6dbbd -5d5a0f43dd6b0f5db381fbc93b4717611a6b68f59bca6eaebd508936921de66721 -b2959906c3bda4ec268255e49b3511f9076163634bea2380d5e2cfd40ef18aa5fb -0ab4bd39cbe482e05a4f5d70dae96067aee5f8dd0ee99a5e1135c68c49b2c97974 -e36cd0e5074e3f587c427d10142b25b8201d759bd4e793eb4a80f219b62b12d72d -3abe427c199b21a2dfe98f74cf5d7f79226a450e8476e5c590674aa1e013bbe54f -5d2c1e964ae8285390324ced0c526cfb50cc276dd50c901d6686c265489564d6c3 -a1944372ce64180b204d6a8bab189dbe0cfcb89d8fc9f1226c35608d935d668892 -8f0eb3e0ac23231fb144af8c5bcf781a3fdfe8113f261f224f0e5d05149457fc51 -eb9a19e125519921f625dc10241eec780afb77aef51ac5cc0617b2d2e75614c8be -0ff54fe77eb6f2f4cdeb09e87659d758fd136725d55c1e8492908d8b3417c49b06 -3613d3a25f67acd7a9bb4ca1570f2260d014851a7f0abd20dfd30e4a79e9145ce9 -a337aa0fa245a2de0922e4892745d43fab1aa9b43629bc2fea67c7a9ab72ca3fc2 -ef1d6190b0a5545abe9721010bcf4834e877f0739c10868324a64709fd8d87f8d5 -d9cda5b01513b7a6a5dd7858613bb28b02ae62925caa185f8ce72d4caaf0d37525 -24efa06ae4cbfb51ec53e25c3147efa239c1b0a112a1c287584331cefcc716c957 -a8f0112b608440cc94fa808feac792c2e7cb6f5de0574e79936300592150d7cc88 -b49db37969ba614202a242918587e2cea654c29ddb9e49d59ebf0ad811d2725398 -30d3773721e1873a776ead338d49a9957e4d56c853de70eb01eee6157b902ec62c -b2c1e2a7f24763c09fa73e0b5e796f1a44c4e33fb1d422d04b102a10b78efddaa8 -94b078b4d5a3882739440f61dc63c8136e8c93a485fafd5c94b1edf3f503916cfa -1d3d4cc24f1507d82c83fbe15d9bc4ad80dea477964838da6888e2cd8160e8b530 -c6cb86a0d45f458ce89b85b4a825926155de97b92569848303cb3b0121858d1375 -368fa4f1c0da7e1b23e76922940f9406ef29e48b4659e7867401e4209176475305 -c530d6cb143aa4b91bb16f82b5bcdc24df277f2a1b133f8d5515f47551cabf2e00 -b9cf49695199160195c2a716211414096d02d0f3d642b20a5b6ff9c9afb626593e -156b31ab66db011d14749bba85b9d8bb3a2674ec6ea0d0e25e3847ebb1fecb06b2 -f0cacd63595625f9851729a5801e1f656bb6820fdd1e823b279db2178979cfa3c0 -841f2b7a17a2698e6024e2ed46757bcd6f604c8444c8c4f27dad1596cbe6d674e9 -658d82982906c9c78c7d2e2808ffc23d3c7e233083adb18af16ed95bf2e31a5b1e -5a6b29bf9e38b5c7a1c9a962ce5cd7806a9874754d7f5ca717b73d3ec1826d9ede -0d9aaa05778534ffc7feb561ea47758feff1a33a75a704b54d5fcb31b6478cec0d -4c75fe9dbcede7a3c2c90a0ea68dd8527761db5e1a8036a3aa56f9b141969fbbd6 -bba8212e10cf7954f8d56f3608cea4c512a1f161c01a747da6dd4a2a789e0f202b -93c1079cc8c51c6cca5453e3e48430555db21620112e99b0496050c8da5787b1b1 -fbd151a815d493034f17ff1af176c9bb5fdbe0785679be051eea86b98451f89571 -ebb52edf2c2ff69cfe425ca9cd4131ac3cfceee7d981d4160d5f483e087591fc4f -8f37e942247dced64a4ab79ee317d8f322733c854e3229df579737f204050f6527 -486fa3135337ed90086cf083a298255e47f2ac49366ce42409cbced6b04e3373fc -8848b3fed4f1be159a30c3d2a77cf4ca7fa301bed881316f43af7852ec15513747 -fbacdf9e9428c97a0215525bde27dfcb612f97be63847acae47b3f99026a59ca9b -30e0ba395f14957dbbb8aaa5df5416a753065efbabb0604d4ce40984616e253d22 -a9e0d4fd69e9f1f1c13e688a63272cf7e0b91eb695bb4f4d44d2c546c08e72bf30 -c66631af617cedfcf0018a1f1f3754c95bc88910885ba4ebbda65541e5e09b7b1f -36a6c2c6691f89b83d9d3d56f3138a72f7ac85910c73b0e5bd6bcd9752573bed71 -be1a4e81496e0156d20a20ed370e14153a531d474a70a42e0a12208e215c3abecb -2e96557f2953fb8e64dfd01b802fb836648609aa3ae35a78d0ad6fdda81ee2294c -64e5a7499fe2933abab3da33bacf03f85788fc405aae2a97e1766cfca63cd41293 -b39c85293c38d078cd57033a50719fea00e0511df845c6cac346a84a5ea4c8ea75 -1b04c837831f4c611402f95378519873de26c9e370c41a5a13d585c76de8eb1ee2 -a3c24f280106c17529906c4549d98591d49ab8f140616eb9f0d03d7ae108e2dc67 -e9ab786e8770776cf3a04ec037991a3434db4a52dd34a7bb91899ec055dbf877c8 -c26ce7c2bb99c9cfa11fc156ca2ba0af4e458a0feb9126a3d443f3b7794f2a3126 -e145375114d0792f5a09ced4e93bf14e5ccf505a3e655e472449bd0a0a6843ba3a -e4517dcd9b7268f9fe469fbb319ac4f05fbb65fae71399823ef003c2937fd64a87 -2402e5bcc7e3a34ad3d4c8d9079faf4f7ed98b8c00523fabb61986ab0856425ceb -78ff2daa378b0eb5da9c30e553147d049cc6ba0aeaa474b7dd3f40ff0ab8df8594 -d5e7ae8bf2d4a72ca187b3be725bfd93bd0fca16ecc4ca238eed5e6e7926723ad3 -ce61251a6507a47e76c2d30344bdc027e0743fea74fda68709344556e519faba06 -f023bd4ff83f24a047d5738c5ed72b351eb5c9f29ffb61075210d33de7fdb8bf57 -2c757c3d24a52f892435d1061610bb1b6f217bef19178db4469ec9e1f2ce188a09 -5b9b4ab6b761708125b0a0919b0c3c31e7bc14b0dd42a540c82e2f71e78240ce88 -b89316ff13ef11625c32934c8b0c237c6a44d413b6abbebd119e7b60a5368d7d23 -b0e0e134c40f7ac56ac0b6649e0a75c3d72924117e9296557306478aea7ccb870e -5eeffd0cb4a01fa896b45e6ee49c6860e2e6b2e267a4a4825a20bbe262dd8b32ee -9a63ea9f36b1cf098572cfc744d5a9245aeef13918f062d455c4e7da8ae8a6d76e -99f6e0289beec9b7b0fbb15faffd340fbaa499111c530f7fc7bf586156c5514a0c -e6bf36fa7a94a7566bbdc2054bd075076edfaee4455f1c4339887a88c641d2dbd4 -746481d2ce46ec72d519dd384323b3903f821a791d1a6a5e9848dde3c66b5e8637 -a447bbea92b791548af4d7f03c0ae0ae0d38d440bf7aa680c2f9e4c7ba7eea5a03 -3f2cd4023e15c51a4495fe09e13183ef6596dbcbb7b362f648205628e501616891 -20006b1c283cd8981113f6b18265b156732c56dd206e3f45fb20ee40869a775e9b -ec1de26212f6111bd2e4e6170e21fe9d62b48e331205b12922ce5f020def2e5bab -7713b7a4e75f4ad7e339660c191c7505562c952b1736ba0e8b53ba6fb2ec845758 -fcab77a5254378e0d4c78ce6f8ee0797aed5cc0104ceb8348f2751658848979b51 -f91ee5dfd9def1db86b0df74fc683179517708c874b83eb7dc61f906e510892484 -8d055e50e2ec8ddcf193354f998eaa2e59710cd41211d8aa5334a97c412fda6e93 -41c34eded6003fa949171a81ed5b3d5c3625469947d520de2c47517ceaa5abba81 -8c46a26805e3f1d1e8c7501fbe3c03b0f2345c3710c430b80dcbfa0625ae763419 -e812636ebebf34a782deef1d6102f20f816fcf7b2a576f23b2b98655b485370fac -d98dc92bd9ec8ab793b4006743504f0a1548f79b89e6923100de8c33785ff95de9 -bcf5b1ea50e1dcb2e46e60c22702361318444f07d3cf7820505055febdbdf8bc9d -39e8169dfb572f22b5b58e27ca561fcd37c58983ea39bfef358033f2619855ebcf -89e56a31113f555cbf3c92227786ff7aa06e47b9d8a5a974cb193a71c3874515b5 -6918e6d6651f8400ba3c701b480f1a0d1526f955cb3c3cf436708a7f1359a69ca7 -56bbad2473fa163b67c2abcf9c6a914b9f8da733509f9a736d3759bed61b0992db -800df0f0b089a4dd4ccf0bb63aaee1039a0356e1f2a66c7b39ec835f3aa5b2c5ba -4b3b18f5ba467b2eaefbbb8ed9e532fbd2846bcc6af4d60c509598ce496c14b8ba -b93d108108b238243746b4f300e32601788b7d127139f497d92cd1a0bda137a86b -09dfd27e501afafa9442cbb454646a7b5764cfa989a35206cc2fb9799acd778dd1 -62a276fe9ad73440ac4983baf8ed76e5b8633fff241fd50f76c5232c30931f9704 -1fe63029746425aa4fd40547cb2f935cc61db33560f9d79076f280f252b3a28a20 -b58a82728ce3e55435e603f8d02c1caebb811b036272b2075eb472242d800f816f -dd34d59893d18c23fccdc5baf6989e0261b5ca53e2d67dd3f3ab7937f2166f4f83 -2dc78e3db6854e50477b88a1e7118f69dea6670f9bebb15ba308f140d08b95e156 -b7eb8c6566e0c946628b4e0882012b6dd3adfbea7f0c94fb40359a5086bc2409bb -83245e5b4591f1aae02a73290d5201981833e5f778a06f9a40356b59517fb04b1e -3eb71d18317820600dce3723f25cbf4bcbff45059d354ac7a2182e5d5c4b5d76d9 -11872490e075f2b15ae7c19c2e67c9ac97fe9445a163b8479c2d641cc94997aaec -a81ce12c77d21453cc563439f78a0d8f99dee79c86ab19cbd35e4ece752f47a480 -095f95116b8242d13c63d2ef33868d6a91b140f01be27c6669be343a9233dd3cb5 -255794e960ac3c3e730e6f2e1adb26a277af72279a51e70bfb476f2a1c29154d13 -285dd910cbbc3bffe99f05f644c0d2e0ffeff18fa975ee8d4b966451db9a07780a -ac3c3d2a96099a9f7a7a9a6de54dc012bc39badec5c128d2e91704185557a339ca -27027688d73aa5da3cdde91173759054afb8eb8f30110eb30e80d63d633e2cf986 -657ef967a9363b35f168378606898e74d2cc8a4b88ee8704e08b38afc575bddbe2 -7698eb47034c1cbff4bf991615b2c7dcfa9db132fe36fc81ef99dc49d7cd84345a -7ae779e705e36ae9939aeda9639f3ab92837cf8c0a2e0cacaa269191f0faa09cc2 -0e23d0d92771802e14db38b66d445d0e06d01b7746908244f7c1ac21c337011255 -15582d7da7f9ed0d4a30c87c3f094f215b747c345c76e1ab9018403bcba6985a98 -0ba3181f5b3eebabc25206deda44ec4b7fdd5300ebf601a08ff3834b01356ef2b6 -c5d733e9a63a7f620f8e790988cd6e8269116f6a3c3c04e00204ea1305c824a7be -42c832918ae753194ca84f7fb07a6f2c24b8910a7e15d774ac9bea7d0c5db6b88d -08d337154e80aa9a8ba28f50561413d2e7761690fdcc3ee97c3d1897373708959a -6f98ad189a92c6df65899ff5c8257a3a4d86586cbce811d72a2478e935841f067e -fdf9973b71cf79114c32d6e2610c2801ce6f6010653005f2bd506e91a529db6083 -1a6a47eb6acd9a3c250ea25fe83aa0b88c03096d45c9eaba27dad61e57baf54d73 -41062d765236e41db291087c7ebf59ce660056949d3f5629b97878a09acfb933ce -42524e21953077dea9fcee2ca6f07ece8e6cf676760a166fe968233c7c8d16d796 -aa21c0774092cb25b0b6aa127419d2b7baaa94faab5f3abd7f010b952fcfd97f2a -adb605b7ed2a1b2075b8f575ddb90ffa9a14af9cbb9938b69482f8ef3c41eb8d80 -a6af898b86a5e35c91a5a8e7ca6ad893458f6b6c1ff8f4e9fa1da615f0e5428f53 -90488d40a57329650cadc59bc6061952cd2f62908b01fcc72139cd3744f3383119 -3a21daa2868a8b2790e3b80e0d1cc1745857294060748c33003b1affe3825cb8b7 -4957788ae2523b4500f89ccb8a32bf18c62678f62daabb4839f7198b13f07346db -3a06216b283d28703f6208fbaad8f36b8847ec121a9f13ed2f1ce06cb53b942e1f -39b4ca3cfaf1c6306a6714cc353e21007a7a445c4d54bc208794445840a15af650 -85ea4a8be5efd185991130a2e6a757f3bc0722d3c3b582d46501b930fd58128c7c -f732ee275f39c91b51cb780c40938646466a170fc94099b4aa8e9dc4f98264328b -1286013db57ba52653de9a8c62e73c2d812292efceb728a0216cad5f8fed7f4e1b -235367580e5e0e3abeb4ad7f47804bdca507fbb194595d4365ee2185b984a2cd5e -54344b4aebaf5f0f0fba665ff7d0c1ae72ce451fa968b1941ac800f7c9dd10fa6c -190feeacf72fac6e41e0981435d443c2b90e29e2daa39ddb9c8c4f4aa699ff5450 -379b6e0b21d9728aec6dccb986fa3c862e363ad13df6bc3bb3a77d57143bc312f2 -8739d0538ed787b573a7a64048651d9725573d63feed772e66cbbdd8fa426799d8 -1a25aa57463c21feeeb805a8cca8dbc6d6e0d188183ebc5212e08295fb370be733 -5f7a420d81c66cb14398079d5577c311ac63ddb6320a43b7168b331e6ff5fbb98b -f2d9e76d8019249a2b9de7ac531bf58c83f9484e1f6b3a6c7a8b38f643b5faa600 -bdbb65fabc3a3fdb17bb85f5be0263d3696a9d7570ab477b775f435a6ebd23277b -d7f28698d04a44b852a8e88feb65bb6f736b7e64f0ceb8ab28b9222b131c7b6c75 -ec2511786fbcdea311967131884d1b14efb5d64398dfe38094ed06e41e6e1c5a13 -39c6be04ffe126cb149d8ffe1077a379d36233c2d1da67432cea4487a727e56b1f -39cf30a1cfb4dca9d6dc41e98eb111c8c5dc05c73e0957e703df9df86cf261ac99 -02b0e60e640100c2d96b93035cdd25c611a8ed58e342e434187ec976316a342f10 -92eab05a710d5c38944fba1dfbf8b7300a92ea57edad907e10fced7dbb463de7b1 -d70169e8c8ffc65eb064a5fb2ba841b17f2a5111b16836a7efb8da26e3d4f07ea7 -0c8a671c0fb70ac05162e2b831e15608685ccd1d84a1520c3b474c7f11431365db -b26e10efb4d2cc6e440390107ec849e003bc5b78933447d58948b20611843746d9 -75e834ee5abaa534a3010c84e45a1017a038d9ece56e89f16c9b37476a90ba60b2 -6484b439a780558b665a8d5b7d6cfbb8d89d49e73709af82cb9ba18f2b58684d53 -bb578eae4e3b30039e0f00b814ef84c14754001fce4492a0d88a8f0f797b1f9701 -cb1c01d51ef1967ce75d7e98716aef2c9e859c6bb88f054b87a4fc3949925fd43b -ba7fa6f565c5771f0a26dc03c86dd701d6c6b6b0b1c0baa51838cdbf764cc091cd -8c401b4d2e308165126cb1a1a3bd20ff929e2e80ee9eb3b5cf33bfe3590415ec3e -3d1cfe5e0a69eabc3ad2aaffd8022ad2f520aefc3cafa7ed93ceb316ab16fe1f46 -d2dcc60dcedaa0bb9d34de15d16413591dd9f35169b753cae63db444bd1763022d -7068f614f092be899f4f9678b1699305fc0cb42aa1509d38149cc39c809b0751d8 -f87a437300ac510c98b8808e8b734644c6460a7f30b1198724faa69fcfa0ce6b3d -36878819ceafbfb74441bc961b4d61eebbabad9c29e4a5d86bd49424d71a67f049 -7931bf9c5e8048bb5f9fce56c9f9c5f8f92af3b29bece34e8c43df4bdd88d829b8 -f0e7a4217f7842e959d7a73999d6607355198168fef4f28b2f7b36d21863c29b45 -46753d3816b665b9bc6357c2489b3ae0edae7812971323e3cde75124cdeea22639 -2415026e9e771e01fa510fcc3605479cb9463c5edafc9102fdd66136d2bce4ccd3 -d7c4c34a3fe51bfa822326ef087099bce8eef2b2a0d6cb2f24dd50657bc810e4db -b700e8a62d9846c70fba8010171e4493b77be36c3cffa36657af7f8c98a173cb6e -8c5dad221db0e121af139787d11a4f5224ac91cf1fa2e42466e11ce8b8ca60156e -49dd7c7b39e84a848dedb4b4c5b380b61f803b9853cd1e933f2aab37f4c00bf7db -de7ed0c159cbbcd22753240cf65c18c1aa4016a6f85608fc4221cc4366a6b35e70 -69470c4e8da5cfb353cf5a6235fcada5f20999e526b8692c6b99fa99b13e606e10 -04995276d31dfd2be640133ddef3e008efdede515abecfdd70c7a63f78100bd9be -996ab15c4c93eaf5a24251d3bc9ee5a524b16cd0d6447011e542b111b65f954017 -3d4cb63e0a030fe08dfa1ab668f7b3c0f291a3b78aca7b3e6019c62976562198e7 -c47219acb8baef3ac52d356af7c7fc34cd678d2119f7e7f3bf4ab82b87c75ba364 -c6b34818a5934f2d443668774ec7deeca70f4acba9f9deb9ccd8f218056cba0a96 -6d5bc528937ccb670c6d18af647047a4e28624240824f2f0f29308dda69187f407 -df944868da090049091fdd9b17977bd26f7eb1f1c476ac6859a56ee88b00272f4e -6094ae4574aa912168cc6f3a6b17d5ee714b9148063317a8a76c49155d6f01c833 -7e1ac8e0916e4a3696d235097beaebc1941d24225ea36bb968b630678d3316d696 -57cf7b4a9f853a38fa70f1c86b2057afe185739a923296046dd93d7d6350d6e30f -d62f86cac02759963b94a4be53db79964ff6fa4fc7a5a5fdaf014878d8cab54e9c -71b99cfd24b18a404b00cd63dea2ac77f40cfef746f0ded1daa9f60dc51fb07288 -f217583df8c1e2c24aaf045a7aadb35b18743289c3301e1197fece5d1107b10631 -9c524a3b1f9d54c9b41644e73c2c904ddbf4bb940f6a9eb544dd57e7d637257e28 -7a9a5b8f7397a264905fb355035e111ecac26aa36d68eb32c1665bb6d3101c6ca8 -4d2877e617e19720c58e5fd467219ba4c1515de1c0bd0bd4d36d9ea130ed5cc42e -20b685a73fc9d3e3c730f7ee1ec1fe8b1e14c1620fb2a2979f5dd9fbe301c304c7 -822927cc231148c498f91e6e4cd83175e66670b13ca658dc6721987e2f8844501e -a5dde01688b7e06eaae49ca640cc66020e18b5fc7b87f6062f1a6e3f3aaf2a2684 -549ed0eeaf7a97bbedb1b5ce534360e43bdebdcc96a534d98584a157f12967128f -056a415c016d652a205893dcee274f205a14ea71e256fc05c777e8d6c7580ceee3 -c9eaa9ab92eee10ef71fef2787135794591f2af8ee63e25bfedc6991e2091b3689 -2bce7226e9b7bd3ff5e918ec92c207c1b569339fcb5bda164d616e0111014978ae -7cb666e581f13a2c5faf15ba3ed1b9be5537c6f2c78e91160c8b291101cab78594 -600213fa4463c86da33e283de0c2ef81648900c06bd18d5795873cb913be7c3b29 -8eaefa839072ba47c6f237126e39cbe0e073c564192b3d87a45ee437163ec35bf8 -e16e392b211124834d379492244c48582ec6530a07dd3f722c162dc90ba00c9b71 -37f4c366ec0febe465e513d5633ffcfd52e1745b9a022856a5b60fab3b6313f2ff -d6b519d6282e5b4dd90d6e6fa8f55f3105c5d5cc7d9e7a6c2960d3fac5a4a75c1b -8ecaa7d0c4625775a22f72fe966b7691bac4b3196f252bebeff9b1a7ad51474030 -e51dee208c5736fd3ebabb66450f385e866975954cbdd775e5f60a4c396e2b311d -a690e90b20ee1a9ce9a56b6f35b020e36cf3b23adc01df9f8ae5073de2ed0a4ff8 -79da9280ab34557a7e0037c7afbd05670ce4ccd0dff785fe3b1c9524eb0e3dc1f8 -a695bf677eeefc496d000cfcdd85e6280ad81bd8f40c7f64ac30f97ac2cfda41b3 -712904471d90bb682f35b70b2946a029fb376979e18022bea0b83ff911b6ebcb4e -eeae5d2b86416b1d1abe2dfd33000b82e6573ce999e038e64374268ef3b8fa546f -455d84ec9350381ada64bc65ddab6ad9c887d6bdba8bd6aa056252cdf7629f7211 -28f434fc5af727e80d83eb237a474c83ab46af2fde1e93bdf10f597b50b99e18d3 -829cdd0adb31ae79b80e85c6c399c356b51e87a9491ed0284f4ea44e95fbf1943b -003dce93a1a37dd78b170d62911be332ad29d453e48b53f342eb8acd1286c7dc1c -d5567bb2a23c23721a200701a0c55cc279d3be9c650486f6963d6f1206277d0684 -fe2d6cb4ce34b759011db9079315a94d13493816e488e69c550a70347a28a9827b -4e9b8e4e02f0ffe0db901c040b9410dd9a167301a5ea13df2ce1fd01b48dcc4eb7 -a52e8f9e1a58c082bd0cd8f08b57f9351b7375b1c09e12e433f0427c3075db7429 -dd1d7a7545a55cae6b5c519a6c0258da2768e427eaf258fa9e304864428904e95c -71160545a33172cf8ebdb48d7af09d0e31ed2138f7cf3f8b63b167b211507ae459 -426f64cbd7a9c0f0a49a810246072f983e16b103388196368bb88f1c7c6d2e56d6 -01b2dab5fd2c865375cf5cad130cccf6212b0784c8a07ceffb41c01f98c8e95345 -ecd9ec2ba1fc404be02546a29fbbfba51c24922d3f066b27400ceeec1c27ddeb23 -8fac5c8a1080ecd7c0fd860e37da77eb31a4f274c7ccce393bb25eb3ddd1a20ccc -e9b24040c93455f1a5a739a7a0d4e63382167f695d7973b7ead50c5be32fbc0316 -be630f2c6c8e48d557c863b19c8bc7b3795ed17116b4db70e5982d70a29e124d68 -0fec499257806f484c10e62fb5a733b9c6c716b75c29ff8a09e1dbf96d9e99cf15 -1c461d26047ffbfd0b4f664e0e3ec406f5f83eb301a0aadfc651ee75f625fb4810 -aa20f88c25ee3048d9ca23f0c755f3d1c6dc5c40d8bf864ed9bb5a6ebb6ba66521 -556a2c6e1af703121cf1c7cd63e93664bbd6f70dbb5567194967648bd79a0dee15 -7d6a1d2fd6c45b83c8f91f23be02ae61fe1398e81d21e664f65178c9f6bf62597c -3324539ae8048e301f5991f03bb11c47d3a5034352d9708290d47f4046dc2e3bbb -88336308b062f7c7e466349e5bd69b3b261ee49a2273a4b777699ecd6b4d98a6f8 -d525027eb6f511ab0f31a9783b939202cf708932f6af1fab9a4ce3c2e4c0e61ccc -4755a1a4f5db79b82d9967924eadf10f09472155d0a1e251b610405faf00cbd7f8 -e781447be33e38fa567891a49cd35a9fd0976cf252624a2806952d6e17c4462d9e -5766cc87b7e250d582847c98e713444e7bc9ece83025926d0f577de9ecf57abdd7 -fe91af74ca03e21caa14f2a345699265a8c5766307757efffd7f507ffc250c46c4 -c660939f55bea4c8b06586da17bb8bf1fa65bda4f81a9a46448666d150dee3a2bd -4f4f05e3e7187632caf0f18e886bb42da189db99576a5924be6c69f93c7f596e08 -0993a498327f702ce3c62fc81dcec463af9fe3e7c7b2b10ba6351780ce1ff9e6d1 -113cbfd06612968cb42ccb599d0881a6c1960ff50ae47f249eb376f6264d237c86 -adad6a15a1677948e1768ca1a1274e11fe35947b88dd54b436763adf7e3e02c618 -f72600f791e6fff5922d3a6dca3eafa5fdaa5c36569e9cf485d95f2e5a0f0eb5b0 -b4a2be7103249db17e81a3d4a892a8bd55a7a1c4f4dc042116d0a84613ada498b1 -8f92a697be449f901cf46c8a039fbde65c582569212f206049dfa1bd9d85a2ef21 -5d3d892ca59ab0120dadc73dff04de5be31fc161078eff1ae72b5d6641e4c4bd24 -a217a06e118760775cc0bb3d5f453134d99d2a50e3507cfc735c9522a9f8e895b1 -c0923a5400cb69f6957057beaf84c563cc6b52326c0a7e57dd20bdf843b98103b9 -71e06fde7ea4b7a7e0819128d977bda74b8b154c7c2552bac6bafd8426fd8b04e3 -39e7a959d07764443f30f9b758f96ea018949abd8166b4d49a3d360d4a5c1106a4 -6d03b07da7fae0e0971bdfde585e1a6e82d98a7e758e6756de1c6f6cddeaf981e4 -5343ead8b67734bebf078dd17490378bfc1e25a7b3185b16a75d01cfba82945d86 -cca95c3d4cf446015b2ca179f20cb7ea101f56e10d3d13058f5c13970f38588a63 -f7e12c650e197b258d81320e141ff85160c2e0a1b747e2f7c68069e7c854a3dbcc -331e4dd3acb7ed59e072afeef986a27a4f108b0f65ac345c07f245c95a94f21f4c -0678451ff278e764a900695a7f0878c34af660f0b9871d41f369dbd61df0241d57 -a0ed5e219ff4d517f3bee4444737dadb8ad1a0b82f78060d5bfc97b24f2a601772 -6e18119c5492fc8d99600c8519a3cecf2cdc159e056ed3d8e0387a960bf36b9e3a -eea7559528c8815161ec87294f790bd19d1bcba916da9d7dc3fc5b4e46c8394b08 -95299e2a45bb14e4d6934ab4836f3d09f41d034cc9015609b725d1c9a7f64c1b9d -8f066f1592ddb6c9d0b334c2afb9955dcb05aa056fac1e374d9e36983cffa12a7a -8f779a6c4a4aa34c8bf1d3c3396c76c1fc892e6208ab6d4748ac60450ed524e1db -2bd6ea5b022f7a3306272f13fd51beb24b41a8242ac57082620150a2fb823cb4cc -e56a38ffa3ea83fbef4e8f8ee8545ff419d88011da64052057f0f3cef0bdc5db10 -7972b84d7003a121c04e87eb182cf8608354acc7fda7ac770f119d57ce3aabdcaa -014f6c4ce589612a23493338fc052ff34838ff1df36f0f15eaf5f82a6020869800 -0bba4b5ed5395d6248d23f290ba29d8f521701eaee2d263c1d9194abfa2625fd84 -bbb1b0eac017f3377547e0111f5a737b87e7f9abab99181f327ac1285dca7cbae9 -43609fff0e9580ac8f30c694abc0eb27e0cd5004df3f84b6cfbda82be18dbec047 -5c3ed26c412b46fb32076fa041a873ef9c5f27f75114ce92ad8892819468d0311c -3c122d7ed4171152afde77cff17af67e25c3b424286a1d0e1baa6ec7763bea6a72 -cae9193ab8cd7070e0cfe71021d1cd6d33a7f1814bc76ee580960ebd4685c218e4 -3f7e5640b4a511008179816c6baa5047016748261c0781c5467a07384b3646cc48 -1fdd417aa73707ad694c976707b69f6942d6cd73c0d4c6592f474feeaff221c42b -9e9a5d0f68b11648831bfc5ec4a12e3e0b058b8758fb9589178efdb603912ca643 -7ec1958b0275647eb0e0bbdcc09f2964dedfacd0ff89a3f020ac10a92058c59822 -e6bb9b9670dcaa1a8bda787c725b2f12dc2e806241c8f476c4c9ef11ba1f7a3f70 -d78dff10f548f8ab2e41615ca0e658ca9b371eb90fcb7c5e34cc5ea792bef64ccf -911b1a7ecd7d2c819203790f7da33e1212dc8c92fd13daaccd998909c0eb595677 -ffad8d84638228af37db1533d9d4d1c121bf1c014f99f8115efab98463a4ee8b5f -057c4154096d8f40f21c8a4aefecdebcd482be3a130e0053ffe5c770d8587237d4 -dfa2aa0e0d8be55792cb9f3510edacbb18961a217e1521dd75da30b708f7c8808c -6fbe11681f1d9b49268e8f231998d87f9fc20c317762f811beba704b243c5b361d -1adc056f6ceb88f79ae05943bb75094a3f80479ec4ade260a0ebea5eabfd75d036 -44d7189401f4bdb2c71227a87e1bb2b7f8ad98c53f478ca0bd1441442bcfaad343 -c31cd40fa41cd62595ec6a6812d5d0a25a7f5323cb3b19cd98f5d0ce3eece45c36 +ac3f02ebaad4de94965ccbd4235574ad926f849af937d1ba1890b28fc6f0ac72c3 +5c2246c7eda9eaa8136b05d0089a798068f020b7f98a539f358a37f675822fa150 +70d525dee05e4e76c3c3d305d88c0870fc1dbbf71969d80df10518526e39abfdd5 +7c4a55b00423ce2b379f354659b9de709e1c9d6ab5dab878c761260039ab906b28 +c66a6725819c7d52a943717f857e4898c40d0f5e81bc9dbd8b4f5b5ce820f07f88 +e4ddcc148d7eab8dd5e3ff8131af2aad205b5277be93f770f238181e856c8bc897 +4277ad5a409e7cc27184f723edf58e44591ec7865b32e4d876c6ecc895c8a222da +ef30c2d2b14dd80bc9da6793bde5d6e766c0c0dc423dde718c68b63715144c28e1 +12e8529091abe2ed0c1df784ca9e9dd1811eb06eeebe0e52107314b299dbd555ab +584253117364803283a01dc36981794a6f46f60422138576092b5fd6207a6b8456 +efc42f81dd4c6d10881ce51981ea7a4ee3f448ef9bd0b6b142772a3097981bfe18 +794a1fe76a4f904234d4aec1c529751f3060d7a6776353995a4ae5aa890baee013 +90f5ffc329e60690824b2b76753d56887739177e8aa5b665734fc3629e80671617 +336a635eeab34963b90da5d9a0c34b9fe294fd150a19663f4e0e065177a278e607 +4a71ba1ad08ef1d090fd6c079c60560d8e6980446783143d2e38a476f3806d9514 +b3e2bb93fc7d9264f310a41eb3566fa20dc90f891da6ac7ad6462499ee3e766391 +74a6135d611bdaaab0471f6d9513d1f3c65bd39c2f8553db063ed19557a6b773f1 +fb559f84cb5908b8d769f8010bac8882627bd7ada6ad8b148770f958492d5cd546 +bc12349ecb10dc74a82de4d7b075596134a6f2fdc5076ef202aeae5c560442f480 +e052204410c88ef176be0bc04cd5695879a9fd7be1b1e5f3337de33d8a089e9bfb +f823c4e08220936a5f8472c83a3fbd0674680c1a2faa307a795d42d2237ae78965 +69125c200d09ffa28f36acc814ee917246d21789e33b2e9744216934a9e7897d87 +1a653270af04532d2faf24145e57c05fe1643377b3d322db7b5478dc26535d28b6 +a78084f273552c15391ca633c8c20efaa38776cc79f91c78332838724fe231ade6 +2dff892110a6cf918f674f436ad7296d11edcc03e4cb105e7ed48e81cd1f0baa19 +f3e22ebcaa83fe603266b73b82a37db2e3f1fbb528c4080d24e45da691953576e5 +59c64f6b1937dad4d9e01329c2f2498cb25590c8804722058f3bd61520ae631807 +2af1f906265d7203a6212adf7210502f73cbf7e83cba2763dd82a535887713e997 +c30c3f5f59291f18597845aff1aab525e6748cf40e3b312d2ba9a1467b97f776d9 +25bee6c18c65ad2b2e0adb257f30fefdb3ffd1f1ba0a98d64a9dac4d0b952d4b7d +a229722f142a9e4cab21b7031d90a4a9d80c7e4e9383474bbee522c0774eb98e46 +d2b02c40a20859e8147c37bfa0a4d59637afe0333504aedd5b312d47187197d8f7 +626c30325905292a98cf5d4ec7378da7a8b695a2ef434c3f2298eb57f7e9abef1d +0443ffebedb0f54166b3f2cbdf75b9ecc09a08d4a7238d0e479408e3552f235457 +2df171bfc266f18e4c6eb19558f27e042e5438dd8ebf4dbbdac1dc798db3767c48 +e73b90110c1e9eecd3805bca37172444716c1cd7d359faf8a31b09a3ae668d6fda +5847678fc5ca56fd8499bc388b0c9d5f61fbe9dd7c132abeb3fdcf62d5f75f8983 +2db7073396486193a6e54c80915db0d0fbca61521848542d55a4075056e24d5250 +18b0689728965c1d4c79404474f7b60947db9402d358d8520a93e437cb70cb084b +62a48b05c15beb21f2b1126d25a8165ce0f4a3dbb5d916e3f03efd417b6fc9bb08 +93d42a066820f68f5887e36f19f7fb12ad58885f262225f8ba4646eaf47d002188 +94fb820f294e95afa839385d6d85af71828cd4968d053eb2e6b4756b7b5106e7c7 +4aba864d705347d8cf8f3b781f4059daa8201842f88c176f93b124bcf7c817c8f2 +fe321974b03113225a2777d897e9bfb8193fbb3f5410f5aace7d155066f1a88dc9 +ea0b40946776499482a81d1fa83f8ef83e1bc83a7abef7901d5d0ffc8a96b27153 +ee9f197341999fd6e5c46c605652fa4a836da586da046c5b159045754afee56f5a +aef0a32e2f260bfc634586a84d82fd52533d2fdcb1aec3777bdf2199dcad1578d4 +514cf19004c3323cd0bf20e5927b7de967259ffc5a6d3f55a0b405451e9cfd341f +632096910927806d1992b9259e61c6c70c829b87bf6d873f91becbd52bab68bb0a +d20ea4e9636caa7731cdfab7ca9c6c27fe65a30a9f42e9b342a457674dc06b6609 +a62c23fe5af18790cf52816c5544cd1cd84c93ed0c6250984fe1ce5b8b6db7903a +a5efadea522793117cdb2cc4f6443f949a5cd3fb306685324acfcca7fc4df6a46d +3e3bee546865bf0d1ab512498be0a365af8ad510984b9d1945b7ef748cf0209c1f +358a1b8a17f4182c1d3a65808d942200756c20d1b62e6c670b5f0a6281bba78da3 +ff6b4c51bc8f7ed8bf28b586fbeebb778d8299e8496eb8849e7d55cf1121b2fdb9 +85ae24b73cce63c0599c34cf57e740c91ba527773915b05660b8fba361e1874c0e +8f6c64805beed073834215d5f88370c73b3f185ce006a85a33e84f889a1ee430a5 +94f1996c4e97d05eecbcf39c9fceef90eccbbf00b5a192d617e95ca79eae59739d +4e02d6f11e5acaea29438bcd1131d1240f183e2c164e014d126bb70a07db48ce59 +3e0299b1e695f1b76ac428cdf957d27d1a47929514ef960e5c2822735ea229867d +8a37e5e875fea8f5b4e8479a21489906454c339e9a3fd27ecc805f5fc1a133c65a +9892b9feb46bb4c537423a25a951e68ef48e6c9850ec39b88e445cccb2936fc874 +fcaffe3d616782d2898bf2425d0b31fd2ec8368e231ca1c9ed1e5ced665898095e +2f6886ba31dce317ed25e8fe4ed5668b088b1eddc10d9fe2a09c2f6c5f8b002db2 +f9087921750deca28b7785cdd4cc4f1551f8b154bfa6d455ac4c4d036ed29dfa11 +09df0281cf4d514237e33dd3ef993920aa60ab2164f21c2728c697ec0c5e7d6cf2 +dfa0fb457530051fa56e6eee396b853895b7609f318dca6e9221aa69c7d2557337 +0cc0cf0bdd3bbeb33868d679ad0382e4f7c65267d18b67ce02b610197f88db5c04 +f9cc25a6bfc2c09b908d47bcc8475df4d1718106bc107b66d0f4664d66a8b188c2 +39f5375bd082736cd1c3d54f064d689c70ce7e315787d5f933df1eea3e48c02d7d +2911a0a20b73f2c26a1c7bb5cbcf38a2590a9eb8061d5e65d55126f90fcf55d1ed +cb242eed47926222aedfbee5c3fe737f17f679940a5799dc92ae350a7c3085b11a +bab138ac02bf7f9316a4c08eec410d77dfacc08a17446362b7c03aa8533e0d07c5 +9c99d34f43e1ab2e7678f36acd1f28ad6daca399eccefc01f11a64da6dfbdd167f +d0eadbe1b342545236bf914cefbb98b64abaec557690dcea0184478fba82c64f1b +c7a50655dfbcd73be88c87454572f52007286f89ae0f5e4ec3916edc89d5c760fa +f359048a152595bcd9111fb75192f76c789e776f1fa786be6723f7c70edfbd8ed4 +d3249487c51da5ff5551abb8786bc3fd6f85683b38a78c5317802c4c625f3e4c2d +cc7573a9c522814a83ed8470332c0f0170747f5cb2fc57b8190a501141980f038b +f5014118ca0216fce4db39832720e49040c3a4f1a2452a5d85dc5c624d78768e5f +2d98711c72ef99bbbb9070514ed1217381dc5de1c4f282342560cfffb289948499 +6c60e740f5bb268bc5127840dc024887a9d73605c91ee80fd35a03afcbfb46c239 +269fbfef90035d7015b4506a8593b3b0900935eb3f030886bf5798ee937033899b +41271a0cec8b00e65db4a36ee094acea312c5f9eca1957a2a91ac36ef36c67a3f0 +1d36f8235fdf67d53be222697998b240fdf9c00ff1876024cc321aec9b415231e8 +49c7a60656b9c2e2f67e54ae63ef5ca5a267526b01f8758753eef97b1fdc1b33ca +cb43445b9c3d08b7a61b44b1f36af6bacd5a95f9d4fd9922ce6db54f16d1974e86 +ba5cea923a7ada2262c481df0454956c4cf3c692ccf9f14be5ab1bf7af8245e8f8 +96dbe7394d1ea1d0dbcc1d3ba00ccd7ca8c9f675d15bd999a161c0eebca12b31dc +5b7cc25ea7fc06fce128f4716ed44aa92d04b978d258af3d11aeb5ddfa59de0a2f +963d1c5d081d0b04d2c7b074dd29e50cbd5dff417dfd6530fbcd644915ae52f3e2 +05aed41526f9d84eac9dc112fe075dd52d6bfcc736b91bbf14027b304faddfd511 +1dce6546d4d7a0ffd4ef340578a04e23a397fbb9cd54d203fab9bc558d1ffa6729 +f72d02dd04a393554345624f3182ba92362bbc62320ec40e4a97dc7fd67c779f62 +4cd1b3ccb2e3e571683dc6fb4d8fd3fd3aa78c3045d8274de97ee52f07764da5ed +27117e414fcce4532ab0e29d4baab816733708f05feefa61a46d6de291720978af +3e37663f6f661eb01fd52fa1a6eaf914e7175405584e5e0a681bc329a183ee85c6 +954431d4bc5c558fe3e4fb5d87fb0427e486bea7ec39e824b6a0964040183695b8 +83e4c91c7346dd4f54ce696407ac9ce0662b4990655f8725abf2d7e2b44e752f0a +858a50a8eca32a815c11896fb3dffd0b4d0f4e389f6e0feab8d35e5fd7c39efa1b +402dc9a07e566e5be3e64057166650b5b23db033d086323ecc35939b8d5dc6fb63 +5c04bb5d122832954823be9ec05fe4b3ff37f63e1260f85577d4db356becb11081 +bc739ac028b3043addbf385c929aab927346b5d1443b943b945b0b627f1c83c584 +eaa1574924192111cb40ef4442628dc26aa20848c9706f700367d2a7f1bfd002e6 +f572b6f5031f3eea139278c63d0e3d22fcb73627a4740b788061d492963efcb67f +8a96e19f72bbefbe1eb392cd9e99c4c9ea25d053f254eeafc26d6243d9ef607b77 +8dcfc8d139d3b8146b879c9e6cf0456d6788e06472e25c84a4263844b8dc842b80 +6f7f950ccdb7ec95b0ee9486b329eeada6bb759b3b4c63dc26c88d79ad96ba9d3b +ee8e4da5833be388929b92412308b80cd2c4974c8f2a193ab2d884b5b46f96e90e +1eca73592d0f9588ad8d6018c6b547d9437dace08341941f4d03f6e0a53136d830 +d1f8f61f43487d9dcfe7489aaa975c0d3b31587c565a2d82116fb57012552df1af +7d0aaf3db4518372134bdeb3ce20aeebc8112bb40a84bfe04549e47920a85a3de8 +9d5d9b760eb916249be4ef0dfb1cd3f83c8ed4a189dc90428e94b1b8bd34dc0ca8 +9c45b4f731f046544eb8fbe3ab400be01fd5efca7de395e632db85722495d60e9a +4726482070dfd85455350d5071de407a1a30db86e84b6165d60d71927169145c38 +d6f0c0ab34a16729af91df464f9178649aef266f85840bfd2bfcebfcd71248c763 +b6b221881be428d0b37fcc1f551fb87e1ddcac61e9ea1f790036eaebebe5c26fae +30881d11173c8858fb30fbad03c636a5d04ce259bf763d1f57836c397e0ec8e1a9 +634a7240e74cddcc4a2cd9860f143c24582a9f6e6c6502e100ef9b8b631b62afef +6addfe8c90c13de340d644eac8e0196c876e90d5ab763facacd5fe8b4fcd82f6d6 +2d8c34dca37b9f0c231612cda90268f97aa989e091588f3e50d3e9008fef7e9e45 +19be47aa193d9efc69ef9ee594c050e16adef3ec765b04c3a9c36915535d29a1a4 +ec268217144cfddfb39ab495d64274a6e9a23421b1f0f60ff8a405a49b3f457b2b +93a8cc162b272377accb99b379cc8de2dcb58437e7679d7649eacde0f58ed6d06a +9cb00227858e657f79e4b74286678a9f4e839bc8c27182c8568e50e071c146f153 +a84871f3f842a2655b60f32cc9b9cfa7d7a28eea53ec273cf3d77e6d6aa2acbc21 +7c8543baede58bd70c7b682c2db9dca9d45b444c9b260c3af27618d03b9e0730ec +4124ead8fe86053889f701befab257dfb31928d95c652bc78552b0e3276f4a34ab +0546d40a2046c5390a0b3ef0db66ad8de0705d40a2f1e01edda072b7229020712c +73ee25ae4161adf216b7eabfaefb523a4037c54139e299001bfd026911aa4a1f77 +5532a39e730245b836b545fd5c361bcd6bd3c277c885a66f946b01eb376b45a874 +1fec5ee8c786c051dcfb3a99113bccfc9c0a6f424318391570ceb971069969668b +68380ba65b690ffa1ffc209dc484f0d6d8ed2572b0401cd54a01b0bbf573a7910d +879a7a0235b7b9625e807cbd96be3c94521dd119b1092548f084a55e4dafa3eb54 +e18509a45874d6d61e86e0deb602e752ddc1d8630dcfaaaf4e37c64208093e97c7 +a8c5880749f9ac2d081a301b5cc2385d4d4ed0d6b2d12b4a276b94963067628556 +c5a626b615af30cd877242c006919991014a6382a41f5563641bfb02848867f687 +260a77ae17dd9f6389dd4df58a034f8887271f1a5a40514e40b90bdf255ebd3153 +d4d323f7e7ca6b464585d5d3f49e688bf1f6d5cbbd5b2092ae8582863c1f2e9f28 +1e16f2cbf69fa92ff3ce65cc60373191d029fc98e178a73b0de31b3df1aee8c232 +fdf8fcf84c573456e324bb502467b35dbfb82b7b610895dae119aec0f85409c4b7 +76d118fe00126092c9325147d488c21a0968932d1da9cadb50b9c450ff8e96cc8d +a2a5c12c8a35a01f92c828b720e495a9720c2bb43eda02cf9cc92be57e807be46c +23de27fdbbac8bc7198b7516dde0a6105c222b5740cf0418a428f3ff992ac24bce +aa3a1a8c1f5c2fc5f83721bdae34884b5ef75197415d647f48d4f584dfe1d2ba25 +bda885035f95f4e20f47feb62cc7b54be21da588a78b4eaf121cc6446d5c0f054c +83b395da46ab9a4a6ae3dc81f3f19fee6c4ba3e1ff9ceee8b64965ed4c1dcea4ce +30b6826969e9bddbe16ed6f44c358e58fb53e3602870d1372c54a0eed30777e680 +5e2b7aae14a77ebc7521f00df06d85b87c2e876c5c998cbb79cd5934c6be8dcb44 +cf5d8c0794b5d21792d94400a3972d548e28068170969e70ef1d9cf1e1d522c4b6 +15ee859e27976ecd6d9194cbeee54b65defbbe15c3ed116b6b47a1c498edb1595f +f8100fb3aa1dbf674aa6f59b7f6a74b53cbdfaa39e691d7ad79c55797ed27d421b +a72172122c7da3681435d088cf02522b6d13a268526acb25a461049750fd16a44e +2a0a86ba8c93ef4729b1bc4f32100851b113bcb97b6e400f1e41baabf1aedccd44 +d38828fad12c0a22b84c4c8a7c8cbd3594a7610ed6f4fbdf001684361d602bd84e +d6e0062fc4085a02379a57093b5b9c6ffcd1de44e727433a55283ea84ba0b3532e +dbb645dd8107a3f38ef1533ad705b5510b8d1309230c8168ffab27d2a53f4b604e +563203577459d31795e6011cc2e4795e9c5a1e752c2868d71f6c8017a47176f979 +373456d0627bd320b744cdbcb29498faf32455661175909c15af90ee6ca67c9766 +55c8bda366b528c5859ea3039ca75cf1961de4a2ec46445bfcc37f888485375dbb +5dbdc3880a7c8b6471ea39e568a5a592b8f2427c37ccd98149007bbc4dc4bd0898 +477c2689dfe53f179b35a5a0942e1065edb7ff74c2eea453ce57800c41434a8905 +cfb78d302f62efa4b28a9e022cbb89e4f4c0b125edb923c86326ef36ac13a2f8d9 +e8fb19009c8a50b6510a08b1db8b6c52fee790df71e0905e85f05ef60a7902af0e +053db2d5610031848d31bfa1e5a7fea2b1d484cd576c181d96704eec0025c742ef +b4d870e32e69f1975daf291bb3ab44c60787c96109109d4bab8aab860619658e13 +113a5f76e64946294e616b516db77717123316be5795de1168f3134262db4eb7c4 +800483f2fba26d730db9e7a4cb8925e9f8016a29e3a4e5f4c16cfc6c17aa3831f7 +3adc520c2498e52d4a379ffb46bfbe347bc91f2c96e260f3a83ec2b4a9cf7fb770 +fac968794852d77ec29725eb1fd3c3cf8ccc6221d064f3f96084de38f2e90d3001 +7c32634e616e3a88d4898bd149c392534cbce4a180b88ae9c13a0a928d83ba40fb +d5981da739f810686335ba9f9d19e8e69e96770757822f6b2c94c6d53fc4ddd7ca +258edbcca892de0b7a71ab479769b63007583473854e630daa4825c2076f22c921 +5d39f9894798f2a4d0a669cb2baf335e25560f8ffc825ef11eae23e327b03fbdab +ce305c115c77f4bbcbc942e25130385c5a10e6a1ffd3073437de7a2c3b19b5ace9 +cad1884c60971debe604dd4acf1b3946fe086a780efcfd0f5cb2bbe5bb08d15e24 +60ccd4838734e8d58e635280d7f47b9aecb801ad147d831188ebd4146c81160d92 +55c247db0b2baf7c48e3722ecb5f5ec6c79d512c406210bf2365cefb4ddd07829a +359a72aa316415027286e0581b46b063569659cec6f4ca8f1326e8b8a0f164e613 +d33e25dca6fecb7b0cd78046a904ea1b71fd93ec4fe6dc459cd9b2b43e0c5b542c +08e5e271e16b03b2e840b2b5c89870976798ed3b14d0dd082657d990ea11702fb2 +603cf4a0da38c6dd001a138d9d2fab308fab23baaa3ab75776341039247e5a9d4f +c1d058af944ede561665c3b295f5da4bb7a929b83802bf029438ef0a8a0f8b0690 +0c864b39ff2dbaff72a38eeb77713ab05985f9a005f389cb78c7ecfa6634911d69 +fe5e74362c53ccecba2585ba6869693b6ded6ec0fe320c97a81e921201df0498a6 +05d3b15a63f66674f98654701520a444847c2f188d8bee5d86fd26b63e6fc7ae5b +270505fef032316ead0c4122e9348d08d8d7f8a8021c1d38e14bb93273829d0cc7 +a1198f3e5c1fced88cd711aa9e97b831ad51d1837b31781dd787903261675b7bb8 +27dac64a23f2f0fde1a1797d45f9aa88ca7ce5050de647a440671e50146035ac1e +ecad2d4f2f5b9a43bfe8c825126a1407adcbc43b43cd0033cef18bb7add3ce5386 +7ede43ec0232b20b61e55f021529c777c8fec75ffbc59653380bdbd1abc7adf5c7 +974fdeb7508caf2ccb990876c7f354749f4fa1bd71e0e31853ca328502c9ae16a8 +841678e234fc5820711fc86d383eeb7c665444bb389c3b25e2f0604ea6785fbb2d +4f5b1a996b2f56b2df07a8b3d918489e0b620170e1e68aa43bf46d48704729eeba +d23bc0cd54713e09bd58df5b80cfc53d5fb88335351e9d347bf710bf571ee2357d +cebfde6d39e8c01b103344e3047f7d386ccecab9f869a538539490b26e101801b5 +b477f788453e0386de53335863bb2895a088449940964d78fed1e65d677c4c8722 +188d530025e163038cd6785f3539feeba0b86aa4403a20da867faf33f663b6e272 +36ce07a911b4a93ec58fbae4ef06a79a6ae66e327b2b5ec96a5e8e293d60ab4735 +c340ca8bcf8ff14509a7e9d397c47d85cd51dfdddfa30a340a4436a2669d78e44c +84a7b223196f155e4d1143f277a91e97545fb5e5d9fdbd8e6b27d5038f31010daa +ef621d29e60761c202c2f33e596698f77e0380863a62dbdc2cb7d4032083c7722d +f1812c78619800a020b506be7cd9bf6a0f2ed1b93d179f88b1f7fc51280fa218d3 +0afc0e886ec4b4dd3889a770441780f4c1256a0e2e071fc340882a5a51bf6c686d +34a908b88b29208c64c38c791f23a9472b8b53f77d6c41fc903fcce19688cf5393 +8bcb132fce026934f83c3e2be4b353a9e1fc40d15b75255b43c260f9c5b5735bc5 +e79166e6643ff4dd4c12e7b9af4f3afbb4f7a348ceb74334ae635ab0e09beea18e +8c3541d478a900a8948f2de896a86c50d958c18df8015247e6017ee91da73c0cdd +54e071bf04e0be4322abc22921fda6efb5871680135dc20ee04edb0bafeb045c51 +746fe0313c4170fd957f9ba5306298206e15a006a869872d0d04e5b5717c63854f +577bc627ead837a68fc8eeb827de6dc0b0b3bca8b87c4829db4295e701f8a0e36e +9f14f4add50143ddb6215a2b6d97e9c7388d5d4dcdabd278666ed896046908d23f +2c64fa1b56a0c2249f9a9feb30f865132d70b48f38c5aabc28e9083c0fe01434e4 +32489bd828becc3139956118cc075bbf31f4d6a1b0d8129d04c476443529fcaa94 +abc5e9e7fbc85c4d1d7d06fb4dc911f54ee2cf607a2995401a463fcd1a3d1c4671 +fdcc73c71b181e097b2ff158513aba6c0fc0161db2ae308789b315843e98514b23 +06ac43cad5cf37d148ab210067761fcf14c8b7825a9adf544c6ce41469ff30c70b +ac0ddd34b9ad00f9e33037ca9e3a45a223845b1ea2381eaa6b36ebea73dc6d0851 +cbea9f0834a7127faf35f5bdee41ba22b8fcba8ab1c24f9fa88ccf62412a6e113c +95390b81596a0592b40fcd261d3ef0c3044c78975be31c09e78f3c9f9e702882b6 +102981f72f140f1643d4d4806afdcfc32fdd1288d1e18e99a43c8dd67150341071 +c6a09b485d6a220af169fa3dd4bbd650331b0a1d57c6bb6ebbe994e6c4180349c4 +5af37cdc5ac89f4954b3be2308c5ba2e394bfd1c2bc3f1173d93f19173cddef608 +0f7ab28100cd887555076d7cc17ec3c7bdd95898be9d50184c581c777d37017dbd +00f80dcd352f5a5ff7d7a4befc00eb6db4e531b4a5dbda3925ccc87cc70ea914a8 +5e715e207fe1fa58c1f699245f5e0875336eb20914a7f86098a2e0b5ddd9b20ad5 +f54e398d9b5fae676154c9ed6a4f496f0242d8c9bcde103713b1eedc0c51cbdcb3 +bb7a83aedafdd82cd65059ec85b35ae586264153520a52669b5a2a9a1811146ccb +3ffd3e9aefbcbdab11a6388686d93638479709b05a960125c42eeb82a4fe655467 +f542e4708e2bed4d9318c9ecd2ca573034d5e31f39c1e1b859e78cedb0d15397ef +77bf48959f7007e8e5718b9240fcb63a0e0cbbf939aa640df325e3c357d272f09c +a5038978722cad203de75d9a9bb3779d3f52c3b44c419dd7c1cc11a6488d46d5c2 +5b78799f2f8943705d8d6a784177848195dedc1eb4a93173bd51ee85e99ab37975 +656938b5cb548e83e20c983972abb4f636a781dfb8d544cf2d3c95338e9a4a64c0 +d720111259cd7ebd6a87298427c74934b8f44dce12e19d68df82cf1af5cde3e212 +d9a444263947d46b948372829d7534b27eb12ce52b110279c26ffbb7eba90d7a75 +c24257dc11633e41ef7482a7aa753ea0c80c049ce31d5d4d6b4d6f9bb357da788c +d873dbf0eb79eeb5dc63fb1ed519dfe1972f322c52971b2141dd703a6137fa0fd2 +e8f6cc0477a6c7329a1d61d153eaf950bf13c3cfd4bfe1575417f32593c4979381 +c2122918a4ac63ab8238a6ffd74afcf588727c14aa09597935cc7a088d3aa04a49 +deabaa25fdcdb18be4a21cd43d7e2a719339234d4f7320806bb8b3dd7d21ea538b +264cba2719fbd06854e6c777e2733e476b0bc34fefc764edd1c22c6a02a4023dac +c82c57e8b0af2d942a7442cc0295334adf8eefdca0d8199892ea4eae289cb1eb88 +19812db43a38edec9347e831c87395bcc3789873adb05a9db771b205368265690a +6c911ac4efeddb1e29272ec90dda665b04c090a5ce8b764f11340958cd42bace04 +7e4f6d3150a8ee40b2fd735cf585c7c17eab6cbe7509161cf26126a93f51c467cb +d67f9c1863b3efc3881686653a3d68e825359e2b9b44a0a9d862c9bed577c730c3 +a652190ccbc0aa55a7286dfd1e5a33cc23c2cd492f2a2e3ec632927422c92840be +17620f5443236da94f97ad1b8c938f977576ddeda9eee8b7b686b6f16a024a125a +e148db93afc13cf89ca5d5ea7479754cc7c5d9feb97fb25670ce1d221a238c62e3 +0b798fd1da1b53249914f8eae6e354190f6f8d33eee5d3dc4ad1a8e7fc0c23ca18 +0236ef50c711e5d9bb0e422e088fb603e697c62cb2b80bed53df431866eec111c2 +dfd8f44fd1632aab2b92249d326239c450a99da3395c10d91e47a6559577a90841 +2fb6080f2cd87b59689be08d2d035a0c5e81ca6c6fc0bed29600d14b06c3485383 +c088776c837504632539f78ac2a9a445cc1cba8356558eb51fc98a85483bcb1481 +07c7a1c843f309393dd51b910949de2647d3a29a4b5f7cb900fc6f029fc968ea6f +06f75bdcccaadb1f61060ad4761c8fb5d385b21e43bcce566b155b9960b3c3a1bc +803c4d2e26aa71546f3b49d11be9380841d7e70965620c3f83716472114eb54f93 +17d519bb04c7e409834468b699f6126bbd3624f7e42f254e88f171dd3abc8a0ea3 +3304acccbd6e0606f2a787fee7a7637c3522f7d643f33071fe975f0160b5771b41 +ace06be78c0908bb2d1efefd3e802cefdeaa2adf605ee2f9d560e42e0eaf4c2e99 +a1b21442cf34b31af7bb2dcd54db54130ca3c3070ed8daf256434ce9cf31e45b1a +73f6214f0076fda52490d1ba52da28f82c55e3a91c56bcac0bf779aadbcfb890ab +eaeb90206e9671b490f7a008b004cd22c6853c5570ccdbcb49be621880a251bcf3 +90d6238a439fc8e3f8078c6a6a0f27ca6633bf3921ccf579b619a36823e3347c0a +e96cdd9781cd82d4ddc129027f2c31c769fa02096f40615297e20a3d601ce2cdf4 +6161b0ec30995c3143f3b311cc7ea2f01922d3f5ef50dfd8e05e80ac49884ad5a3 +582465834e8e01de87b9b1e1ab2786a86c78805ac21a8f501abc9815b0e6d320af +25b77fc9dd2c91070e360e798c3855daf0c3080b7634283e2c713ff6837a26e9f6 +e238830e4b45bd1f83b6622572715463a23d53c96d0f7ef4330689fb764b07cafd +ef96e808680af67a5c851e305ae00e99cfdd03cfcd0e55c5bc9b9a731f1365a874 +d1f79aaf057c1eaa6d1e1c01b2f0717871f608b8d3a225dd4850000c71157e1dfb +f4e69780f32736217e03d143b3c7f4575e71097ccac493167cf6d001ace7575bbc +2fe1997244748d15f0d5390eef20f22b3fd3b3903db98934d36aaa0f5bde455de4 +c965aa264ab03236c586c117dd68305f0cb0a672cb862bc366d64e7058cdf95b5e +89f81efe510f3d00a405c89bd138990f1e6add2906ee2367db37c0c497d93c2d60 +44e739e98e94ba323b1aa34e91dab6081634bf2c9da806f3e3228b8636db4bff73 +23999cb98c039090aaedd17e7b2688ad5eb2a89a54fbb39e34d9f3acc8ac982bfd +2147a5f7f0e039bc199e88a8ba94c0e6d1456a8685dc17b86eb2c075a5e5bf37a3 +7a39a92c8273017437e7ffbfbf869c1738e51a6cd97bcdeed383630559405fd2ea +ff5ec1797971f35c5401c7776e5c4f738eb2e98f22c0e977dadc6aa21f65ff892e +cd1d2851473a3290fd546d7aa3bf52ef90314381591c579c8ec0849eb46100d973 +d682acc468d8fcddaa09e708a3b9754dd9527f8e98d6d70e36c43eceee57cc66db +adc689445eed1673b97b956b480c64f4fd9f1f23da91e3964ec4a058819b7823dd +d2adf7687d27da33353dcfcc14a2a04850cc81627b2def657b8427fd0217aa4d59 +db63c671a5b644db87ffb8a6883f93a2a519b63cc0ad77fad7764e221891ce8f27 +73c177a9c4c3868008a42114ddeb96b006ed66fcce322555cc219570e7348c433a +7baa77ae191e4a85863575ea9fa6ca1624d6df089e75a734f831924363d01b5602 +3644cd836ad3e48a27947f266adb5777bf513b181d629cbab96a6e84e6ee51a2de +8fabe9f31bb03cceaa70f2bc4b0d82d2fb89d842823319f4bfa8a470fcd81eb903 +8e5694e33aadef61d5bb2bd84a5476d6f0ac16fd1b61c173043414786bd9969135 +c4fed9d58e502268cdc829e991f8241a1681ea7ce0f79c0efd9e719304a4c91bf4 +ca12dbf6a1cf855d045dfb066d25f59b1aae61a7e6f4e5784ca31187306af9a5ff +a96c3143ba95a32e0405aa2ac4cb5e67cfb80f2bc1d2b4555124de70e842393592 +8bd406d8885457642153646b71aefe16a321c98093a77996a1b71d02f3cf61dd94 +0a3409bab7a03fe91f413313051526c9f6e804e2ac3d23af1160a26bea0f0b38ee +51394071f25ff4c6653e92a7b1cb54cda126ebb46c5e761cdd7976bc6bae93e3d2 +00c0b1e244238cbf63dfc5d284dc4eb1a0638d9e1e2748139251095c7fac165041 +d9a5a2cd34f96ac9bce1f72b29ffb56173b5e4c0621ffa36c3d085560b7db49eee +cdbbc12dec933cd862d8ac00b4b193fca513b325cba65c0fc6fdf0205423f3ec4f +964ba96daaef9ab360222b28c32862d6946fecdb934117934cf858d1e6a2bd666f +1c96aaaed01a1b8d6a8a8ec8a875704411f776add1493fa0351de24a67351f4d48 +bd4040a670951400df65b5ceb56cd6f273508a5b1e4f15b969e0e5c065b651c1c7 +bba49ecec7ff3203535cc1794f4b01a37b5b10119c6d9c72e4167102a351f56e91 +cb35c175a388dcaa44a01c03f7b1c5e95b40b68ed7dc565abf649a77163c82b177 +99a57bb1c0bc9b9478e94323c732c8cda36b91ca36aa7904efc69a67794d96c522 +da1f85e0451e5ec9bc935f715934b1f9c63cedefc41327da4744120b4dea0417af +37da94e44fa1230c73db96c7d27f03943e726ee95df5f4f2e09be8d13f2a6552a5 +66fb10a5dc4514a843f099ce7bc2556bbe44ddd52ba03a77b836cdc7af6e863ed3 +ac999ba3ee3dee5b456adf170905ee84258e6bea8e2a058b9548ce407e7105184f +4aa9ba4df97fbe702a652d3dc723a9bb0e42c4d4c074151e43437f57037d940426 +b7dae9272b914b103d236711d517613e1d0bc420aeb07566ae429abc03f87b152d +76989f68750b85f142cc1228ea25cb559851dcf829e94bea4e61654a8e39f593ee +1f449b6cc5cefa9f21114c1a8cfc118d322fae8e9ae744229b4da2a64d2a4c67ea +2c616434cd86b4ab179f462d9557c6326e40c1d0681586eec921930557312ff57e +f1b2c9bb457cc1675e69ede4242b1265349f8cbd68b3f775b7267706b1d038f76d +22dbc7de3841d88f05faaf5a13d336012861276a1b87fb13a01a6bac23a0d637e9 +1ebe165db0a33b1d4afcaf88bf3980734b6ef4d26d4b89568f6eae2062742e8ae4 +5bab361d7e0cbfd9f76580d4045392466c89c6b92a0dca908811d25885c4de1bd7 +532071a4d533e93ff721c5e3f2ec4d710c94d5f284013837ec224bbfed08fc119e +6d0a25b04e2a0c6dfacbba2c9d1b74bb5637be32b52171fbd786c406c9c1ce17f3 +8fda1e30e812b3e1744739cb9ce1506de7d4ccb7223ad5cdba2749f6be83e306dc +d475d0921ee402140aef40173a8410b981079ed292501cb448aa8c5821fe116fc6 +0bd4012c41d3bf5030260e2bd6e2497cfdb909416866895516414e7a04c287985f +56e09fd4ca89e81d2a0fda4b0a672ef23e3ca95880f74647cba14c16e04eb28c6b +67aa18fd6b35df7ac3f6ba64e55a167082eb82955d6fe438ef8c594f82b1d4d908 +941306474e15d50a4d95c0fa24e1f0864133e4ba5739f31a31e06da1405af3e969 +aa95740a2578e5a154008125dbd04eceef6601c7c3d7a25a457a3fff09662fe1de +330fdc50dd60a529a52ca7111a551f05e30804b36396781d0635911c7322db42fe +a7958cb2d7b821d31a04440cc50bb5388b6e02651d313878d6914695483cccfe83 +086331e63123a68bb96dc22073f68f5149c5b78fb8bb5181bc462bc02db0a23206 +d9ba58844b249f2be125cbe03972ef46ff71fa4f0633a6d1785062d01ea0b68442 +bb5e6f37301854330973f5c7e57641a71a42daba0221933aa41f0d67f3694852cb +6f0bb4aecd0b26eae06f95e91e70afb83d013b65da1ea37c0fd4de4cf2d9c4ccdf +5b755e402e053590516b5a90850a0e8df1310d8d98b70b74fb582ab640ad50e393 +8207c51802ecc9cb11e79ec01955a22a0b961701322036c3f036887522c93eaa4d +6918f6c9eb86c663e2527b675901bdc2effaef09b4d4189ae521373e4131c18304 +babb840521e67011ce71e1e24fda4dbc95ab94cbf0bdc14987ca22d440961d1fd1 +56a9e7d982931a028d67b5d3b2aa4aae6f8a41137d2a8030eb4d1a6ba33a477cac +2394a8c65d40d36f77da25068fabe187b53ce71ef3dcc8f96bacbe36075400afa4 +9e974c56581e37934635e3033766f673ef50c5661f5c8a41c6f7c422383c151838 +13fb739dc2ed02486a11c1787067956eaf568f93d7d3245c3cc919b21753c3155e +8984e9bee166b56b33bf4ae28d7640699105aa31f84fb94aa490fc86ddaed5cef0 +ca8f73962035ea46cc6679778273dbc8cf0d942e3fac2b63049e3b37a80f89f673 +560a85306569b0a205a7127ee1f6559e38f1529521837d8ff24536570aeb461758 +89a2f81b07f7d51abe9051839fd687ac9e534c1a3723fdd31be469d38aaf51d428 +b4fbe97317a338a080510c65e529c79872d58dfa9e4be448c124f467a31509a62a +83cf4009cf2725d0b83ec88cc749f3c202ca8c33186cbcfcd55aa746ad66605c85 +f806441dd9dec6a1d227d19c625ddca07e97b73da73bbd9776fba2e691f7991da7 +b05130620657328bd5dda73d61320f1c79551bb3a0c8c47742b0cb6a7c5af2c0d5 +a893e02b6241e28b8dd1a9aabd8d033a77e184c0a1a0788fa0ba0b53882089c856 +935b3007173b75ebf009653f7cf2751b2c95ec86cdf044876c476d024f7d793574 +16d0d59cfe7738661be27ef46ef4c8f2030f3bcbdbf3acb2ee5593a713b406357c +d38047ea730779f3c7cba6e16d96ab8f5101c5845a941d93dae00dab845c431bc2 +5addd33566366f99b71ebd3ceb68825fb3aa7a119346a6bdfe0d9dd41d066b6e58 +b6fb849a28bec784692305d9fa03837da476090558f84fde69df23e0f41003d1a7 +a28689ae3ee0d0fbf81e04be0afb2f4cec9041185427f5097b879ac39b784213fe +43c59edfc2d6304ee240ebb6e1aae8472fde9b7077c85d3a07357f6f6e31789101 +5e4b68b0a44d487021fe441861cc44df6cd79103c7f69d85aaeb9dc96fa2086010 +9ebe5f54fc6e5a30df5c7ffe00374e99aab4843ed4007e875ae1c5ac12c82153eb +954188ef87211bd03e18f8e8a1614c8aa0939c690d93f867ba3705aeb1e56d33c7 +d58798e76d3d568e83e5e10667ef0b62f9729874dc35e588caed04fa0fa201b605 +23d3832ae1f721dc511e673f33578f297f84047df53b7d82d182572e38730f5f75 +6005ca58bdea5f01e266d6656c0c0498c6ce8110fdcf657ca0b0bca445aa55fd1e +f6d3501c15cbb1a5c1ab650c14b0cb2209259be5d5b39eff68c7187600485b1ee4 +2e9bce04baf231626186379bff98de41a677147e50107f4e088dd8fb1e9a1d9fcb +045bd4a08b0cab936e76587db2be739f0a66dadf7505fa3895d35009e0915a9789 +025adff563d615454129bea284ad613492f1964804a3c12da38d42ba39a7666a3c +84d06f0c2e2733f897f14505f7b173660c3eda2fb2bbb7a57c0fde31c75b8e0a19 +5a71306d3088ea4b233ebb2eda66bea52ff6baffbd978efa25d5bfc4357a32d177 +a967369cfc53378952c5522c2f840262933ef40cf60390e87a226d28269dfa229e +0e1f8c66e34cd6169f686103c068d75ef606896f2e5e5cacd76c7a13a08e1a47cb +23c421886c02765905d77246c833877ff2e546a05cdfa958cb4e2a71f56222c247 +606d12e5bc016cbc11e18252c57495dd127aa2ade763c23804a7236d48c7797822 +f9228f56d19c5da108f4a65be829a37e87f36877fb816622c5172900293138af83 +5a0cd6b6b613d472a45633b2aa4dfbdf706a4a502e1f45ff7f55c52cd249cc5a9d +0cc25820fbe75098aa67d1e2d9bd2032cbfa5f0ccfa8d39ec58beb7dbfbbd2a22f +07e94a5e5a44f814d88d53c028011d6dd35eab11c94b5efa6b5c57da5a96c41ef0 +3002e513636f6106963695fdb1d36302de56f21ac73f34463ca566509dccdcae39 +e7ff88a6400ac138bc02dbfd5ef272a6fa84846d8008be0294d5e77fbd412fb686 +a3cdb8cb768c338f37937cd681b89535475ba3a458fb3f598d86cb29ca7386f907 +16dcf35252a9d14d1a5636e90e0f9daf331e5080034cebbcc131aa45eefd8a12ec +2dc8bd72e6c3ff9a76a27aa925bd234be9d96777f71959b97a90f32da145018f6c +c49acd6c940eab8ddd2504cb3105e63a77b4ac37241d35b7a9588f86c70bebf4e8 +ebbdef62fb11acb536328f587abd883d6a38778f469358ffa0b5919f50aefa7230 +486422aaf14f72ed3fc755f93a078fbdd11bcf889da56631f3eb129f3658f2e73c +5fb52b3cf8c96beee6c69ed9d64efc52015a5478cb05a2fc4cfbe87d7ed7ed6918 +90eda82c90f33accd249397171df0acdea45cc1fde58933765ec74c9b90edc1460 +d12b23f43c0100dec96349ea71e4e2dbd832536d3a51dfdc7ed4f76761bc9eb459 +100563041b7fc8f0e7c07ec35f0e748bb508bd99d67fec6dafdbbd8080f94930a1 +899d3e79940be95719d701bf89cc540a287d4ad62275711895739a7d2751698f2b +ff6c834382c6d3a2501963bd8100ee3fb1e42f268c8d6d1833c010bb69159d7140 +126bb8ac188fb24b3fa57da1d8720f8ce2fb080035af01b38f6c44e42f0c0a50ba +8266b199453e5758be0874f15fcac188f1fd97d4d5657af592f388c1f47c292348 +31313e589ce9db8146e82fbea9566968572153dae8b3b6709fe71e8261927a0e25 +8bdf3a9513d6d88ee61d5c6bac6afd9f4e3c4c166b3798cbdf80d98a3e3897a56b +6cbb644880cdd588a46f3ac3c449749ab6ab3009c062747444725020e45e2e6237 +39071dbed3656e318c41d84733872d7e25829dc6b9b4062a1613da9de5a8ba7802 +5d388efa281dec8e28011a2528af2d70628601ae1122ad1ae5cd82fe382b772d9d +134dbab0e033f34bb196b5ca6c4282bf5e8d5eb7cd977d69ca781ba08f46fac011 +2671f6e1ee83e28bc3f8b3a91e25abf0c748590fb3394fb2b44212f8b2dcc2cec0 +e05b313e4f94ddc2bbb5d91e907b89335b499d22be118a80299ec715ee94bbf001 +dc737cec1498c7972c9472cf1ecad4aaa494092eddf3d5be9316ed0d23db12a1ef +af1349b9f5f9a1a6a0404dea36dcc9499bcb25c9adc112b7cc9a93cae41f3262e0 +f6fa017287cd355d902b6246ca879f48b98fc4617f374e135e0d0965932bf29afd +46a229066b8c015096d7175bebd593e17d8a233caacc807285f463efb7beb1040c +52478ecfb1ae94424b991805e816a8e97943c0c6eed9a93c12729f0642010a2878 +4b81dd7f9dc0981860ac0f886093504de0d34141b6e3ff579fedf65c3c7a4f87c1 +616b8da521ec860942c3cb83fc9c97f140ecc5ffe7edf713e6ed4f75b7b336a59a +12a35b73e2d767ea160157be6230c581eff3507c9489206b7be164f2c66d7b4405 +750ed7139d1eca17ceb32cb25ce95356f4d36a0fd0a4444de443a1f052155c43c1 +bcffe5d2964be0ed77e4f08de74012e26fb51f76e6e6725da1688067703e1e9491 +6157e80e9d5fa3492c3e439e7aadd0d3f5aa69bcf72529b531210581c90478ec81 +2ad32bd7532c249e2b9be84198e9419b5c167c74c7393ae7f2e79198e583edead9 +46da13daedec6ecbfc0b4b5883d0887c141eda8cedc0948c9fa5279ff14cc00dbf +cf9899807d094416594fa1de2b2cbfda7f9d642ff05ce6229abde2849aada90dd9 +f893a214a23c1c9ad8f254da012dffafe2a98ea541e9e7b05282a633d72e6e7f8f +b8c2d3e06e27ff35e07274c72d93b99c164586a4620f8a435f078ea4258736358b +996a8aed346b913fd527bc2be84e0bacc28ac5e418be57c8d4f7225337360860c9 +ebc7c05cddd221bd03a5630e10948c14a693fbb2e630e67e48cbc6c024b6bf3d03 +a7b855b4dac141d6ebbcf8218cfa287b39056a14566a1440ad7a15cfcb2340344e +876f0dfc25b597e539ef8bb525d2db167ac97189e6ef963f4d7a66df2e1df189ed +91969affe90f4f3cbaca94f2287615d75d872e379ab022928c1704a73283bbfa25 +ebf694cec2b2bdf2e592d0ce2d85c9db4b8f022a880b390cd2bf817c626a2b6cee +5af772bdb7aae3a8c7323a853736ced90d1f68b931ea88f19510fd6367f76f676e +adc0be97840599362c667c66d279444a33c9946787125ce79a28ccffbaed1be715 +e6b14356f9c18ad28a46dd5f534858fc6c061564a670320ecff9a91891307812df +d72734d18211dc4474d4804f18e31e5b5a201b3c72d8a909d96c307fca159b2245 +c2f090082928beb5143063c89d381e85b07d49b1d2cdd940d3ab0a2934db61bd5a +933cbcc899216a7004e2a9284f73638f29042c03ffaf4eaffffc0c0f631d14321b +10b0d9606471fe1567cc664a31d77dcfb2d7507995e278647d45d8c2b97f298f70 +306782238c9ba622f48223862a80c91a632ab6ce1ff68b0cd7577be058cd265f4c +7443cb4495b4302ebfb80627c4730952ab98a837af55788743096ecd24c3ca60af +5d12a786a90c92975878b76c7bdca44524ed889665498e56df2579cd89fbdb1495 +7cdddd7416e7e0bdd780fec77d83199e84a8dc6abcd2e210ee678c8dc633a80cce +4974854ca9a2d838ea856c21d2908fc526a4e519376bcaaf0685622f8c4956053b +a090b648f157d901318e45c6b95f168d085f4156297f4768d242ea821de8f43046 +5687fb2794f537befad3c2dfa8fa1bc754765ab96eb8d0d2a48e4ebc826612b280 +fe532cfb5f0b7c590614dceb48cfd29c0179c92631103d32ad30ef6bd63b6d1d6e +c2ab3ff3467f6720b1038313c271814450849c4b803bdaa6d5a4bf6314cae7a2f5 +ed2dd7d636eea85ed785b0f4ab800cf441de8765987643309ee40f0e89ea1c3dee +4a8be46f7441fb8e47eed47190239a8e8fa51ee8a05a45d636afea17c02be2d810 +b0dc950474d8ecc923469d64d619643ce50eb99d3340dc5917da73865b3b64fb6d +6a35c5a6b469cb14a68cec60558e092b3b9ba38f4faf378de4c583d943a5e70225 +74eb4e6af587a3ecf1a0edb41966ed56ef1b7304866af115a0cec814929b0d6e86 +52755232b20877cc32dedf5d81cfabc6ecd447da5efe2ffa90cad087b7a3627e69 +d9aecf42435d7f0b6e9510e66bc1cc774ef4404b1d5a484f4da074c7cd9ae61aa2 +e17b0c247611e382c4f8afd0dbda91ddb3ada144a5d78fb1a1d8be41e110eaee25 +41b66aac556cf8af31ca785d17c0feac75eadf7898968cc67e68d57f4bb53d37a2 +34087551ce0c8ca3b07f148f4d64be994f7034ac3da588b495f4dd699bea2cf416 +79a50f54f62d1697f485f9e4f981aef29952ad28ee91912f16288cd8b37e5b225d +ff0cc0abe4a0a62d39958f5a5a901c266e5e9048f5d72875cb1e8fe845dfcc70f1 +cc107a551be1a57f813fd45c8cbfa2c90650785e04f05e1ee1520f6a16e8958113 +7c053a9ed5e3eb8bebb625d9e2017756363dc016d8a96947d497de8753e7402993 +20cd07c8fa67d183b8892577135d00264162a79bc0a1a1a5192f4d1ffaee9f6ce3 +dca3b16861b4122fc4b9222a0ac57a39e958153d1e9a3859fca31c1b6a70d1b6e5 +a45a8a6357964857af409a66021078d50ab6d29b790c9f42f871f4c8a2ece93275 +4db85fdaa7c79f0d3aad947538095a63ef23284c3fb5182404524745836b330b09 +262706bfc24d4a6cc1f501d76904234f127d0b90394425d8addb9eba59b6d57815 +205140d8441ee9ada5c6ef5af93dc87dd48d19081b4f2ddd31bafb1027ceaa20c3 +8b2ebc1caa51cd8553919c51d42f045093e24d76f664ec00aed0e61a65adfbb270 +b51057b6fd1b67f222fdb5adaf1bacebcada8edd4426e2678f7df11db0d0542dde +56063663fef4798e292f84b2f80ef029007e25dd92be49ed087c30763568d81a5f +a622fe8cf5e8a8adb21fdc3d3fcbcadf18d6ea776300c10a6b0bf3759e90b1d1d1 +7ed6664a589ba1ce1c6acbaddb614779aaf513f89a5a1b92998ef5e5b5ec142293 +b7e6249af94616a49f7f2fa3a53737250850b0a3053fafbb17c71184f1cb5ec86f +d64bbbb7afacbe9a42479a7191556d8115dea555667e9f2a3c39eeff5c7ecabad0 +750513fe01c2fd5303a94d71e51f86088951c9117e35e843d19faf214a3838fe13 +171c624ddf4f0831e3a16e77aacef4c9a7c6e1da6b2750c30f65e762b4b4e83e1a +94d7b10c49de0c010da033360ce80d2895c97d4a0d035790f4f4925b995dc8dfb6 +12e5e84c58f526174c249aff29347a35d5f5cb7fe73a28633792141e9a0730df7e +a227c1dd76ce829e10e4bc06a9ba89ac84c9bc9ff94827b7cd6805e2229def34fb +ce72c1ece992f563254be7ad004ae789ec1a55e9f51879a79a37b6970473913479 +ccd6fbf29293a07d51ca54ccf401cd1e663136854cde18da7de7e6e3d6037b7c0e +86d6679436eb6deba875d11aafef432cd9e9633b0abc279c0193a4868ff24568f5 +ea7bb661c5acb391166898993b4cc24ecabbcc3ded1c09907ac4d24ae725704eaa +152a20d2b0a0925ec94354539d860812229f3e28097a0c2b56bc80a22b03d6d750 +1a39e338697b422f033447d6ce24c8b30736c0727a9e0560ae38f37856cf23674f +f13b1ab12f0a85f7df5db247808381c1dc5273e9d4ef550d5e93e0a0a5b9794bcd +9c61e037f1e9bf26bfac6864d8fd7e500bf5b961e0fc07f7f79fea0de112129189 +e319bf55a7f2c7e35d64daf2ef7d87f9ef7dc8a1358e6aa8ac531c7fe3fc295ad6 +7bcc5742f01a857fa6193dc89f858c5fd7b6ed2383445b8eecb90dcde95180e148 +e651bb26399dfff060ad161f816060997848465486017d115f3b04969c7f0902e7 +23e23b003c285b4b1304f529984ff13a62773ac53c56d656c928716158806d8949 +8fd9694c457cc0f456db7f1e62f6eccb9765e0201f4675cb4d9a1ec3d1e4b296ba +92336eb4a3b69f83ffd096e7c60775d1436ba55ef4d550a3f73b3e4fa210609713 +5b425a7e6baa86b0b9dfb15fbf33f22d61c1cd5bece4b8986388893babed9632e5 +a4b3844aea8c3582f099d88728b0ad061182ca155a85787cdebc13a42fbaf62a32 +9882489430b3b9786b6a19cb31e203b9682c614224b7642584c1b6fda1b91c8736 +5aa50fe7a21525be42b5be392a4a043f3c1146836d26ae77b07bc0a925b95e65e2 +2320f53985da6b4cd6c0b7f93f617d91b42c75336c9f32e827a4e7503955e205dd +abbfa370a1150284659927d0e9c207d035aa93ddf95d35aef38fa55a9f771629db +33c28070e012bd7c1170401f0bfd6780398069a079f26afa88e1eafd1982964bb9 +52e899c02f0a70e8a68dfc39c3f9a60e8c844df97cd5139004227a3268983b70ca +cb3aaf61e45868c82c6717eda5fa95cf27e2cca7a0584747b29a2355e2947f306d +880f972501d5b7dff1ae6d32713d69f6b327e44813f655e63b81c5d46e81474a76 +6774c36cd59158219fe178d976aad8f6aa553b2b6cf70934a6debbb3dea1bf5b95 +fcf6d3bfabfaec376c76a32592e7bcb7a95a19fb97ba28bf896658b013d6122a76 +ae9fcbaf18a1b869b6fb1d0eef04ff0beabb8f2460919401d2d5dac9376eb1763f +1b9f623ae13efe8b1945b0232a96828a0ec58bc17bf77dfa44fed31bcd4de0fe3c +87faf274139f833d209f0087f512adb1eb95f5a62e11ec3a4b6d673899c796ba6b +dcf1a11bb2274481ce30e4812a47f745244293d11746d1c2c4aef91a56a474e5cd +c88063e5d960201e50d5f0622b23b66066e7ad5500fb159651331b687e086aa8a7 diff --git a/core/curl/files/CURLINFO_ACTIVESOCKET.3 b/core/curl/files/CURLINFO_ACTIVESOCKET.3 index 1166b90f..0a3855c0 100644 --- a/core/curl/files/CURLINFO_ACTIVESOCKET.3 +++ b/core/curl/files/CURLINFO_ACTIVESOCKET.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_ACTIVESOCKET.md -.TH CURLINFO_ACTIVESOCKET 3 "2024-06-01" libcurl +.TH CURLINFO_ACTIVESOCKET 3 "2024-07-29" libcurl .SH NAME CURLINFO_ACTIVESOCKET \- get the active socket .SH SYNOPSIS @@ -22,7 +22,7 @@ is complete, and is typically used in combination with \fICURLINFO_ACTIVESOCKET(3)\fP was added as a replacement for \fICURLINFO_LASTSOCKET(3)\fP since that one is not working on all platforms. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -53,7 +53,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.45.0 +Added in curl 7.45.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_APPCONNECT_TIME.3 b/core/curl/files/CURLINFO_APPCONNECT_TIME.3 index 789fae86..a8b5afd2 100644 --- a/core/curl/files/CURLINFO_APPCONNECT_TIME.3 +++ b/core/curl/files/CURLINFO_APPCONNECT_TIME.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_APPCONNECT_TIME.md -.TH CURLINFO_APPCONNECT_TIME 3 "2024-06-01" libcurl +.TH CURLINFO_APPCONNECT_TIME 3 "2024-07-29" libcurl .SH NAME CURLINFO_APPCONNECT_TIME \- get the time until the SSL/SSH handshake is completed .SH SYNOPSIS @@ -20,7 +20,7 @@ When a redirect is followed, the time from each request is added together. See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -43,7 +43,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.19.0 +Added in curl 7.19.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_APPCONNECT_TIME_T.3 b/core/curl/files/CURLINFO_APPCONNECT_TIME_T.3 index 2b08e425..0f6b0d83 100644 --- a/core/curl/files/CURLINFO_APPCONNECT_TIME_T.3 +++ b/core/curl/files/CURLINFO_APPCONNECT_TIME_T.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_APPCONNECT_TIME_T.md -.TH CURLINFO_APPCONNECT_TIME_T 3 "2024-06-01" libcurl +.TH CURLINFO_APPCONNECT_TIME_T 3 "2024-07-29" libcurl .SH NAME CURLINFO_APPCONNECT_TIME_T \- time until the SSL/SSH handshake completed .SH SYNOPSIS @@ -20,7 +20,7 @@ When a redirect is followed, the time from each request is added together. See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -44,7 +44,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.61.0 +Added in curl 7.61.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_CAINFO.3 b/core/curl/files/CURLINFO_CAINFO.3 index 1bee5a01..2f53f745 100644 --- a/core/curl/files/CURLINFO_CAINFO.3 +++ b/core/curl/files/CURLINFO_CAINFO.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_CAINFO.md -.TH CURLINFO_CAINFO 3 "2024-06-01" libcurl +.TH CURLINFO_CAINFO 3 "2024-07-29" libcurl .SH NAME CURLINFO_CAINFO \- get the default built\-in CA certificate path .SH SYNOPSIS @@ -21,7 +21,7 @@ This is a path identifying a single file containing CA certificates. The \fBpath\fP pointer is set to NULL if there is no default path. .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. All TLS backends support this option. .SH EXAMPLE @@ -40,7 +40,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.84.0 +Added in curl 7.84.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_CAPATH.3 b/core/curl/files/CURLINFO_CAPATH.3 index d3697425..cb191cca 100644 --- a/core/curl/files/CURLINFO_CAPATH.3 +++ b/core/curl/files/CURLINFO_CAPATH.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_CAPATH.md -.TH CURLINFO_CAPATH 3 "2024-06-01" libcurl +.TH CURLINFO_CAPATH 3 "2024-07-29" libcurl .SH NAME CURLINFO_CAPATH \- get the default built\-in CA path string .SH SYNOPSIS @@ -21,7 +21,7 @@ This is a path identifying a directory. The \fBpath\fP pointer is set to NULL if there is no default path. .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS, OpenSSL, mbedTLS and wolfSSL @@ -41,7 +41,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.84.0 +Added in curl 7.84.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_CERTINFO.3 b/core/curl/files/CURLINFO_CERTINFO.3 index 16bd113d..87996555 100644 --- a/core/curl/files/CURLINFO_CERTINFO.3 +++ b/core/curl/files/CURLINFO_CERTINFO.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_CERTINFO.md -.TH CURLINFO_CERTINFO 3 "2024-06-01" libcurl +.TH CURLINFO_CERTINFO 3 "2024-07-29" libcurl .SH NAME CURLINFO_CERTINFO \- get the TLS certificate chain .SH SYNOPSIS @@ -28,7 +28,7 @@ items with textual information in the format "name:content" such as \&"Subject:Foo", "Issuer:Bar", etc. The items in each list varies depending on the SSL backend and the certificate. .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS, OpenSSL, Schannel and Secure Transport @@ -71,12 +71,11 @@ int main(void) .fi See also the \fIcertinfo.c\fP example. +.SH HISTORY +GnuTLS support added in 7.42.0. Schannel support added in 7.50.0. Secure +Transport support added in 7.79.0. mbedTLS support added in 8.9.0. .SH AVAILABILITY -This option is only working in libcurl built with OpenSSL, GnuTLS, Schannel or -Secure Transport. GnuTLS support added in 7.42.0. Schannel support added in -7.50.0. Secure Transport support added in 7.79.0. - -Added in 7.19.1 +Added in curl 7.19.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_CONDITION_UNMET.3 b/core/curl/files/CURLINFO_CONDITION_UNMET.3 index 4696a010..5dbf1a64 100644 --- a/core/curl/files/CURLINFO_CONDITION_UNMET.3 +++ b/core/curl/files/CURLINFO_CONDITION_UNMET.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_CONDITION_UNMET.md -.TH CURLINFO_CONDITION_UNMET 3 "2024-06-01" libcurl +.TH CURLINFO_CONDITION_UNMET 3 "2024-07-29" libcurl .SH NAME CURLINFO_CONDITION_UNMET \- get info on unmet time conditional or 304 HTTP response. .SH SYNOPSIS @@ -18,7 +18,7 @@ gets a zero stored if the condition instead was met. This can also return 1 if the server responded with a 304 HTTP status code, for example after sending a custom "If\-Match\-*" header. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -51,7 +51,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.19.4 +Added in curl 7.19.4 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_CONNECT_TIME.3 b/core/curl/files/CURLINFO_CONNECT_TIME.3 index 5c58863c..5b8d84f1 100644 --- a/core/curl/files/CURLINFO_CONNECT_TIME.3 +++ b/core/curl/files/CURLINFO_CONNECT_TIME.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_CONNECT_TIME.md -.TH CURLINFO_CONNECT_TIME 3 "2024-06-01" libcurl +.TH CURLINFO_CONNECT_TIME 3 "2024-07-29" libcurl .SH NAME CURLINFO_CONNECT_TIME \- get the time until connect .SH SYNOPSIS @@ -16,7 +16,7 @@ When a redirect is followed, the time from each request is added together. See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -39,7 +39,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.4.1 +Added in curl 7.4.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_CONNECT_TIME_T.3 b/core/curl/files/CURLINFO_CONNECT_TIME_T.3 index a2536d4e..a92b2122 100644 --- a/core/curl/files/CURLINFO_CONNECT_TIME_T.3 +++ b/core/curl/files/CURLINFO_CONNECT_TIME_T.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_CONNECT_TIME_T.md -.TH CURLINFO_CONNECT_TIME_T 3 "2024-06-01" libcurl +.TH CURLINFO_CONNECT_TIME_T 3 "2024-07-29" libcurl .SH NAME CURLINFO_CONNECT_TIME_T \- get the time until connect .SH SYNOPSIS @@ -17,7 +17,7 @@ When a redirect is followed, the time from each request is added together. See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -41,7 +41,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.61.0 +Added in curl 7.61.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_CONN_ID.3 b/core/curl/files/CURLINFO_CONN_ID.3 index 01c38af8..83bffcd6 100644 --- a/core/curl/files/CURLINFO_CONN_ID.3 +++ b/core/curl/files/CURLINFO_CONN_ID.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_CONN_ID.md -.TH CURLINFO_CONN_ID 3 "2024-06-01" libcurl +.TH CURLINFO_CONN_ID 3 "2024-07-29" libcurl .SH NAME CURLINFO_CONN_ID \- get the ID of the last connection used by the handle .SH SYNOPSIS @@ -17,7 +17,7 @@ The connection id is unique among all connections using the same connection cache. This is implicitly the case for all connections in the same multi handle. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 8.2.0 +Added in curl 8.2.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_CONTENT_LENGTH_DOWNLOAD.3 b/core/curl/files/CURLINFO_CONTENT_LENGTH_DOWNLOAD.3 index c72e17a4..b491cc0e 100644 --- a/core/curl/files/CURLINFO_CONTENT_LENGTH_DOWNLOAD.3 +++ b/core/curl/files/CURLINFO_CONTENT_LENGTH_DOWNLOAD.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_CONTENT_LENGTH_DOWNLOAD.md -.TH CURLINFO_CONTENT_LENGTH_DOWNLOAD 3 "2024-06-01" libcurl +.TH CURLINFO_CONTENT_LENGTH_DOWNLOAD 3 "2024-07-29" libcurl .SH NAME CURLINFO_CONTENT_LENGTH_DOWNLOAD \- get content\-length of download .SH SYNOPSIS @@ -17,7 +17,7 @@ is the value read from the Content\-Length: field. Since 7.19.4, this returns \fICURLINFO_CONTENT_LENGTH_DOWNLOAD_T(3)\fP is a newer replacement that returns a more sensible variable type. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -41,8 +41,10 @@ int main(void) } } .fi +.SH DEPRECATED +Deprecated since 7.55.0. .SH AVAILABILITY -Added in 7.6.1. Deprecated since 7.55.0. +Added in curl 7.6.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_CONTENT_LENGTH_DOWNLOAD_T.3 b/core/curl/files/CURLINFO_CONTENT_LENGTH_DOWNLOAD_T.3 index 0a69ab6b..7a774efb 100644 --- a/core/curl/files/CURLINFO_CONTENT_LENGTH_DOWNLOAD_T.3 +++ b/core/curl/files/CURLINFO_CONTENT_LENGTH_DOWNLOAD_T.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_CONTENT_LENGTH_DOWNLOAD_T.md -.TH CURLINFO_CONTENT_LENGTH_DOWNLOAD_T 3 "2024-06-01" libcurl +.TH CURLINFO_CONTENT_LENGTH_DOWNLOAD_T 3 "2024-07-29" libcurl .SH NAME CURLINFO_CONTENT_LENGTH_DOWNLOAD_T \- get content\-length of download .SH SYNOPSIS @@ -14,7 +14,7 @@ Pass a pointer to a \fIcurl_off_t\fP to receive the content\-length of the download. This is the value read from the Content\-Length: field. Stores \-1 if the size is not known. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -39,7 +39,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.55.0 +Added in curl 7.55.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_CONTENT_LENGTH_UPLOAD.3 b/core/curl/files/CURLINFO_CONTENT_LENGTH_UPLOAD.3 index a32dc276..7ab10957 100644 --- a/core/curl/files/CURLINFO_CONTENT_LENGTH_UPLOAD.3 +++ b/core/curl/files/CURLINFO_CONTENT_LENGTH_UPLOAD.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_CONTENT_LENGTH_UPLOAD.md -.TH CURLINFO_CONTENT_LENGTH_UPLOAD 3 "2024-06-01" libcurl +.TH CURLINFO_CONTENT_LENGTH_UPLOAD 3 "2024-07-29" libcurl .SH NAME CURLINFO_CONTENT_LENGTH_UPLOAD \- get the specified size of the upload .SH SYNOPSIS @@ -16,7 +16,7 @@ Pass a pointer to a double to receive the specified size of the upload. Since \fICURLINFO_CONTENT_LENGTH_UPLOAD_T(3)\fP is a newer replacement that returns a more sensible variable type. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -40,8 +40,10 @@ int main(void) } } .fi +.SH DEPRECATED +Deprecated since 7.55.0. .SH AVAILABILITY -Added in 7.6.1. Deprecated since 7.55.0. +Added in curl 7.6.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_CONTENT_LENGTH_UPLOAD_T.3 b/core/curl/files/CURLINFO_CONTENT_LENGTH_UPLOAD_T.3 index bfcc3c9f..f8746141 100644 --- a/core/curl/files/CURLINFO_CONTENT_LENGTH_UPLOAD_T.3 +++ b/core/curl/files/CURLINFO_CONTENT_LENGTH_UPLOAD_T.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_CONTENT_LENGTH_UPLOAD_T.md -.TH CURLINFO_CONTENT_LENGTH_UPLOAD_T 3 "2024-06-01" libcurl +.TH CURLINFO_CONTENT_LENGTH_UPLOAD_T 3 "2024-07-29" libcurl .SH NAME CURLINFO_CONTENT_LENGTH_UPLOAD_T \- get the specified size of the upload .SH SYNOPSIS @@ -13,7 +13,7 @@ CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CONTENT_LENGTH_UPLOAD_T, Pass a pointer to a \fIcurl_off_t\fP to receive the specified size of the upload. Stores \-1 if the size is not known. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -38,7 +38,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.55.0 +Added in curl 7.55.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_CONTENT_TYPE.3 b/core/curl/files/CURLINFO_CONTENT_TYPE.3 index 053a56a7..6286cd2e 100644 --- a/core/curl/files/CURLINFO_CONTENT_TYPE.3 +++ b/core/curl/files/CURLINFO_CONTENT_TYPE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_CONTENT_TYPE.md -.TH CURLINFO_CONTENT_TYPE 3 "2024-06-01" libcurl +.TH CURLINFO_CONTENT_TYPE 3 "2024-07-29" libcurl .SH NAME CURLINFO_CONTENT_TYPE \- get Content\-Type .SH SYNOPSIS @@ -21,7 +21,7 @@ corresponding CURL handle. The modern way to get this header from a response is to instead use the \fIcurl_easy_header(3)\fP function. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -46,7 +46,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.9.4 +Added in curl 7.9.4 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_COOKIELIST.3 b/core/curl/files/CURLINFO_COOKIELIST.3 index 5bd1f0c2..ec834699 100644 --- a/core/curl/files/CURLINFO_COOKIELIST.3 +++ b/core/curl/files/CURLINFO_COOKIELIST.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_COOKIELIST.md -.TH CURLINFO_COOKIELIST 3 "2024-06-01" libcurl +.TH CURLINFO_COOKIELIST 3 "2024-07-29" libcurl .SH NAME CURLINFO_COOKIELIST \- get all known cookies .SH SYNOPSIS @@ -19,7 +19,7 @@ received) the \(aqstruct curl_slist *\(aq is made a NULL pointer. Since 7.43.0 cookies that were imported in the Set\-Cookie format without a domain name are not exported by this option. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -54,7 +54,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.14.1 +Added in curl 7.14.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_EFFECTIVE_METHOD.3 b/core/curl/files/CURLINFO_EFFECTIVE_METHOD.3 index 47ba7c61..e1765b3a 100644 --- a/core/curl/files/CURLINFO_EFFECTIVE_METHOD.3 +++ b/core/curl/files/CURLINFO_EFFECTIVE_METHOD.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_EFFECTIVE_METHOD.md -.TH CURLINFO_EFFECTIVE_METHOD 3 "2024-06-01" libcurl +.TH CURLINFO_EFFECTIVE_METHOD 3 "2024-07-29" libcurl .SH NAME CURLINFO_EFFECTIVE_METHOD \- get the last used HTTP method .SH SYNOPSIS @@ -20,7 +20,7 @@ The \fBmethodp\fP pointer is NULL or points to private memory. You MUST NOT free \- it gets freed when you call \fIcurl_easy_cleanup(3)\fP on the corresponding CURL handle. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -43,7 +43,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.72.0 +Added in curl 7.72.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_EFFECTIVE_URL.3 b/core/curl/files/CURLINFO_EFFECTIVE_URL.3 index 29d898ec..06bee618 100644 --- a/core/curl/files/CURLINFO_EFFECTIVE_URL.3 +++ b/core/curl/files/CURLINFO_EFFECTIVE_URL.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_EFFECTIVE_URL.md -.TH CURLINFO_EFFECTIVE_URL 3 "2024-06-01" libcurl +.TH CURLINFO_EFFECTIVE_URL 3 "2024-07-29" libcurl .SH NAME CURLINFO_EFFECTIVE_URL \- get the last used URL .SH SYNOPSIS @@ -18,7 +18,7 @@ The \fBurlp\fP pointer is NULL or points to private memory. You MUST NOT free - it gets freed when you call \fIcurl_easy_cleanup(3)\fP on the corresponding CURL handle. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -40,7 +40,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.4 +Added in curl 7.4 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_FILETIME.3 b/core/curl/files/CURLINFO_FILETIME.3 index 9bf48cc2..c72c10ea 100644 --- a/core/curl/files/CURLINFO_FILETIME.3 +++ b/core/curl/files/CURLINFO_FILETIME.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_FILETIME.md -.TH CURLINFO_FILETIME 3 "2024-06-01" libcurl +.TH CURLINFO_FILETIME 3 "2024-07-29" libcurl .SH NAME CURLINFO_FILETIME \- get the remote time of the retrieved document .SH SYNOPSIS @@ -15,14 +15,13 @@ in number of seconds since January 1 1970 in the GMT/UTC time zone. If you get hide it or the server does not support the command that tells document time etc) and the time of the document is unknown. -You must tell libcurl to collect this information before the transfer is made, -by using the \fICURLOPT_FILETIME(3)\fP option to \fIcurl_easy_setopt(3)\fP or -you this unconditionally gets a \-1 back. +You must ask libcurl to collect this information before the transfer is made, +by using the \fICURLOPT_FILETIME(3)\fP option or you unconditionally get a \-1 back. -Consider using \fICURLINFO_FILETIME_T(3)\fP to be able to extract dates beyond -the year 2038 on systems using 32 bit longs (Windows). +Consider \fICURLINFO_FILETIME_T(3)\fP instead to be able to extract dates beyond the +year 2038 on systems using 32\-bit longs (Windows). .SH PROTOCOLS -FTP, HTTP and SFTP +This functionality affects ftp, http and sftp .SH EXAMPLE .nf int main(void) @@ -48,7 +47,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.5 +Added in curl 7.5 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_FILETIME_T.3 b/core/curl/files/CURLINFO_FILETIME_T.3 index 5791d45b..96e89d66 100644 --- a/core/curl/files/CURLINFO_FILETIME_T.3 +++ b/core/curl/files/CURLINFO_FILETIME_T.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_FILETIME_T.md -.TH CURLINFO_FILETIME 3 "2024-06-01" libcurl +.TH CURLINFO_FILETIME_T 3 "2024-07-29" libcurl .SH NAME CURLINFO_FILETIME_T \- get the remote time of the retrieved document .SH SYNOPSIS @@ -11,20 +11,18 @@ CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_FILETIME_T, .fi .SH DESCRIPTION Pass a pointer to a curl_off_t to receive the remote time of the retrieved -document in number of seconds since January 1 1970 in the GMT/UTC time -zone. If you get \-1, it can be because of many reasons (it might be unknown, -the server might hide it or the server does not support the command that tells +document in number of seconds since January 1 1970 in the GMT/UTC time zone. +If you get \-1, it can be because of many reasons (it might be unknown, the +server might hide it or the server does not support the command that tells document time etc) and the time of the document is unknown. You must ask libcurl to collect this information before the transfer is made, -by using the \fICURLOPT_FILETIME(3)\fP option to \fIcurl_easy_setopt(3)\fP or -you unconditionally get a \-1 back. +by using the \fICURLOPT_FILETIME(3)\fP option or you unconditionally get a \-1 back. -This option is an alternative to \fICURLINFO_FILETIME(3)\fP to allow systems -with 32 bit long variables to extract dates outside of the 32bit timestamp -range. +This option is an alternative to \fICURLINFO_FILETIME(3)\fP to allow systems with 32 +bit long variables to extract dates outside of the 32\-bit timestamp range. .SH PROTOCOLS -FTP, HTTP and SFTP +This functionality affects ftp, http and sftp .SH EXAMPLE .nf int main(void) @@ -50,7 +48,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.59.0 +Added in curl 7.59.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_FTP_ENTRY_PATH.3 b/core/curl/files/CURLINFO_FTP_ENTRY_PATH.3 index 23bb0df8..e2a20821 100644 --- a/core/curl/files/CURLINFO_FTP_ENTRY_PATH.3 +++ b/core/curl/files/CURLINFO_FTP_ENTRY_PATH.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_FTP_ENTRY_PATH.md -.TH CURLINFO_FTP_ENTRY_PATH 3 "2024-06-01" libcurl +.TH CURLINFO_FTP_ENTRY_PATH 3 "2024-07-29" libcurl .SH NAME CURLINFO_FTP_ENTRY_PATH \- get entry path in FTP server .SH SYNOPSIS @@ -18,7 +18,7 @@ The \fBpath\fP pointer is NULL or points to private memory. You MUST NOT free - it gets freed when you call \fIcurl_easy_cleanup(3)\fP on the corresponding CURL handle. .SH PROTOCOLS -FTP +This functionality affects ftp only .SH EXAMPLE .nf int main(void) @@ -42,8 +42,10 @@ int main(void) } } .fi +.SH HISTORY +Works for SFTP since 7.21.4 .SH AVAILABILITY -Added in 7.15.4. Works for SFTP since 7.21.4 +Added in curl 7.15.4 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_HEADER_SIZE.3 b/core/curl/files/CURLINFO_HEADER_SIZE.3 index 847f7065..5c54ef10 100644 --- a/core/curl/files/CURLINFO_HEADER_SIZE.3 +++ b/core/curl/files/CURLINFO_HEADER_SIZE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_HEADER_SIZE.md -.TH CURLINFO_HEADER_SIZE 3 "2024-06-01" libcurl +.TH CURLINFO_HEADER_SIZE 3 "2024-07-29" libcurl .SH NAME CURLINFO_HEADER_SIZE \- get size of retrieved headers .SH SYNOPSIS @@ -15,7 +15,7 @@ received. Measured in number of bytes. The total includes the size of any received headers suppressed by \fICURLOPT_SUPPRESS_CONNECT_HEADERS(3)\fP. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -36,7 +36,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.4.1 +Added in curl 7.4.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_HTTPAUTH_AVAIL.3 b/core/curl/files/CURLINFO_HTTPAUTH_AVAIL.3 index e5ea60f2..7b88113e 100644 --- a/core/curl/files/CURLINFO_HTTPAUTH_AVAIL.3 +++ b/core/curl/files/CURLINFO_HTTPAUTH_AVAIL.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_HTTPAUTH_AVAIL.md -.TH CURLINFO_HTTPAUTH_AVAIL 3 "2024-06-01" libcurl +.TH CURLINFO_HTTPAUTH_AVAIL 3 "2024-07-29" libcurl .SH NAME CURLINFO_HTTPAUTH_AVAIL \- get available HTTP authentication methods .SH SYNOPSIS @@ -11,10 +11,9 @@ CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_HTTPAUTH_AVAIL, long *authp); .SH DESCRIPTION Pass a pointer to a long to receive a bitmask indicating the authentication method(s) available according to the previous response. The meaning of the -bits is explained in the \fICURLOPT_HTTPAUTH(3)\fP option for -\fIcurl_easy_setopt(3)\fP. +bits is explained in the \fICURLOPT_HTTPAUTH(3)\fP option for \fIcurl_easy_setopt(3)\fP. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -47,8 +46,7 @@ int main(void) } .fi .SH AVAILABILITY -Added RFC 2617 in 7.10.8 -Added RFC 7616 in 7.57.0 +Added in curl 7.10.8 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_HTTP_CONNECTCODE.3 b/core/curl/files/CURLINFO_HTTP_CONNECTCODE.3 index 7ac9ab64..85425ff7 100644 --- a/core/curl/files/CURLINFO_HTTP_CONNECTCODE.3 +++ b/core/curl/files/CURLINFO_HTTP_CONNECTCODE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_HTTP_CONNECTCODE.md -.TH CURLINFO_HTTP_CONNECTCODE 3 "2024-06-01" libcurl +.TH CURLINFO_HTTP_CONNECTCODE 3 "2024-07-29" libcurl .SH NAME CURLINFO_HTTP_CONNECTCODE \- get the CONNECT response code .SH SYNOPSIS @@ -13,7 +13,7 @@ Pass a pointer to a long to receive the last received HTTP proxy response code to a CONNECT request. The returned value is zero if no such response code was available. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -37,7 +37,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.10.7 +Added in curl 7.10.7 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_HTTP_VERSION.3 b/core/curl/files/CURLINFO_HTTP_VERSION.3 index ccedffde..3fa83837 100644 --- a/core/curl/files/CURLINFO_HTTP_VERSION.3 +++ b/core/curl/files/CURLINFO_HTTP_VERSION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_HTTP_VERSION.md -.TH CURLINFO_HTTP_VERSION 3 "2024-06-01" libcurl +.TH CURLINFO_HTTP_VERSION 3 "2024-07-29" libcurl .SH NAME CURLINFO_HTTP_VERSION \- get the http version used in the connection .SH SYNOPSIS @@ -14,7 +14,7 @@ connection done using this handle. The returned value is CURL_HTTP_VERSION_1_0, CURL_HTTP_VERSION_1_1, CURL_HTTP_VERSION_2_0, CURL_HTTP_VERSION_3 or 0 if the version cannot be determined. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -33,7 +33,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.50.0 +Added in curl 7.50.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_LASTSOCKET.3 b/core/curl/files/CURLINFO_LASTSOCKET.3 index 46a234e9..89c114d3 100644 --- a/core/curl/files/CURLINFO_LASTSOCKET.3 +++ b/core/curl/files/CURLINFO_LASTSOCKET.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_LASTSOCKET.md -.TH CURLINFO_LASTSOCKET 3 "2024-06-01" libcurl +.TH CURLINFO_LASTSOCKET 3 "2024-07-29" libcurl .SH NAME CURLINFO_LASTSOCKET \- get the last socket used .SH SYNOPSIS @@ -22,7 +22,7 @@ NOTE: this API is deprecated since it is not working on win64 where the SOCKET type is 64 bits large while its \(aqlong\(aq is 32 bits. Use the \fICURLINFO_ACTIVESOCKET(3)\fP instead, if possible. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -53,7 +53,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.15.2 +Added in curl 7.15.2 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_LOCAL_IP.3 b/core/curl/files/CURLINFO_LOCAL_IP.3 index f6f99d9c..2c49f3b5 100644 --- a/core/curl/files/CURLINFO_LOCAL_IP.3 +++ b/core/curl/files/CURLINFO_LOCAL_IP.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_LOCAL_IP.md -.TH CURLINFO_LOCAL_IP 3 "2024-06-01" libcurl +.TH CURLINFO_LOCAL_IP 3 "2024-07-29" libcurl .SH NAME CURLINFO_LOCAL_IP \- get local IP address of last connection .SH SYNOPSIS @@ -19,7 +19,7 @@ The \fBip\fP pointer is NULL or points to private memory. You MUST NOT free \- it gets freed when you call \fIcurl_easy_cleanup(3)\fP on the corresponding CURL handle. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -43,7 +43,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.21.0 +Added in curl 7.21.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_LOCAL_PORT.3 b/core/curl/files/CURLINFO_LOCAL_PORT.3 index 5dd39e5c..5773c57e 100644 --- a/core/curl/files/CURLINFO_LOCAL_PORT.3 +++ b/core/curl/files/CURLINFO_LOCAL_PORT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_LOCAL_PORT.md -.TH CURLINFO_LOCAL_PORT 3 "2024-06-01" libcurl +.TH CURLINFO_LOCAL_PORT 3 "2024-07-29" libcurl .SH NAME CURLINFO_LOCAL_PORT \- get the latest local port number .SH SYNOPSIS @@ -12,7 +12,7 @@ CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_LOCAL_PORT, long *portp); Pass a pointer to a long to receive the local port number of the most recent connection done with this \fBcurl\fP handle. .SH PROTOCOLS -TCP +This functionality affects tcp only .SH EXAMPLE .nf int main(void) @@ -39,7 +39,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.21.0 +Added in curl 7.21.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_NAMELOOKUP_TIME.3 b/core/curl/files/CURLINFO_NAMELOOKUP_TIME.3 index d726412e..1f98ddaa 100644 --- a/core/curl/files/CURLINFO_NAMELOOKUP_TIME.3 +++ b/core/curl/files/CURLINFO_NAMELOOKUP_TIME.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_NAMELOOKUP_TIME.md -.TH CURLINFO_NAMELOOKUP_TIME 3 "2024-06-01" libcurl +.TH CURLINFO_NAMELOOKUP_TIME 3 "2024-07-29" libcurl .SH NAME CURLINFO_NAMELOOKUP_TIME \- get the name lookup time .SH SYNOPSIS @@ -17,7 +17,7 @@ When a redirect is followed, the time from each request is added together. See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -40,7 +40,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.4.1 +Added in curl 7.4.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_NAMELOOKUP_TIME_T.3 b/core/curl/files/CURLINFO_NAMELOOKUP_TIME_T.3 index 0ff11ebe..e6c1fe74 100644 --- a/core/curl/files/CURLINFO_NAMELOOKUP_TIME_T.3 +++ b/core/curl/files/CURLINFO_NAMELOOKUP_TIME_T.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_NAMELOOKUP_TIME_T.md -.TH CURLINFO_NAMELOOKUP_TIME_T 3 "2024-06-01" libcurl +.TH CURLINFO_NAMELOOKUP_TIME_T 3 "2024-07-29" libcurl .SH NAME CURLINFO_NAMELOOKUP_TIME_T \- get the name lookup time in microseconds .SH SYNOPSIS @@ -17,7 +17,7 @@ When a redirect is followed, the time from each request is added together. See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -41,7 +41,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.61.0 +Added in curl 7.61.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_NUM_CONNECTS.3 b/core/curl/files/CURLINFO_NUM_CONNECTS.3 index 11632297..19dcd1b3 100644 --- a/core/curl/files/CURLINFO_NUM_CONNECTS.3 +++ b/core/curl/files/CURLINFO_NUM_CONNECTS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_NUM_CONNECTS.md -.TH CURLINFO_NUM_CONNECTS 3 "2024-06-01" libcurl +.TH CURLINFO_NUM_CONNECTS 3 "2024-07-29" libcurl .SH NAME CURLINFO_NUM_CONNECTS \- get number of created connections .SH SYNOPSIS @@ -16,7 +16,7 @@ many times libcurl successfully reused existing connection(s) or not. See the connection options of \fIcurl_easy_setopt(3)\fP to see how libcurl tries to make persistent connections to save time. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -38,7 +38,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.12.3 +Added in curl 7.12.3 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_OS_ERRNO.3 b/core/curl/files/CURLINFO_OS_ERRNO.3 index 7de31382..a7529e92 100644 --- a/core/curl/files/CURLINFO_OS_ERRNO.3 +++ b/core/curl/files/CURLINFO_OS_ERRNO.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_OS_ERRNO.md -.TH CURLINFO_OS_ERRNO 3 "2024-06-01" libcurl +.TH CURLINFO_OS_ERRNO 3 "2024-07-29" libcurl .SH NAME CURLINFO_OS_ERRNO \- get errno number from last connect failure .SH SYNOPSIS @@ -21,7 +21,7 @@ Since 8.8.0 libcurl clears the easy handle\(aqs saved errno before performing th transfer. Prior versions did not clear the saved errno, which means if a saved errno is retrieved it could be from a previous transfer on the same handle. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -43,7 +43,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.12.2 +Added in curl 7.12.2 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_PRETRANSFER_TIME.3 b/core/curl/files/CURLINFO_PRETRANSFER_TIME.3 index c721c4a5..5b1900dd 100644 --- a/core/curl/files/CURLINFO_PRETRANSFER_TIME.3 +++ b/core/curl/files/CURLINFO_PRETRANSFER_TIME.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_PRETRANSFER_TIME.md -.TH CURLINFO_PRETRANSFER_TIME 3 "2024-06-01" libcurl +.TH CURLINFO_PRETRANSFER_TIME 3 "2024-07-29" libcurl .SH NAME CURLINFO_PRETRANSFER_TIME \- get the time until the file transfer start .SH SYNOPSIS @@ -21,7 +21,7 @@ When a redirect is followed, the time from each request is added together. See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -44,7 +44,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.4.1 +Added in curl 7.4.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_PRETRANSFER_TIME_T.3 b/core/curl/files/CURLINFO_PRETRANSFER_TIME_T.3 index 2774e4f9..ab91c22f 100644 --- a/core/curl/files/CURLINFO_PRETRANSFER_TIME_T.3 +++ b/core/curl/files/CURLINFO_PRETRANSFER_TIME_T.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_PRETRANSFER_TIME_T.md -.TH CURLINFO_PRETRANSFER_TIME_T 3 "2024-06-01" libcurl +.TH CURLINFO_PRETRANSFER_TIME_T 3 "2024-07-29" libcurl .SH NAME CURLINFO_PRETRANSFER_TIME_T \- get the time until the file transfer start .SH SYNOPSIS @@ -21,7 +21,7 @@ When a redirect is followed, the time from each request is added together. See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -46,7 +46,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.61.0 +Added in curl 7.61.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_PRIMARY_IP.3 b/core/curl/files/CURLINFO_PRIMARY_IP.3 index f6bf4671..0b25690f 100644 --- a/core/curl/files/CURLINFO_PRIMARY_IP.3 +++ b/core/curl/files/CURLINFO_PRIMARY_IP.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_PRIMARY_IP.md -.TH CURLINFO_PRIMARY_IP 3 "2024-06-01" libcurl +.TH CURLINFO_PRIMARY_IP 3 "2024-07-29" libcurl .SH NAME CURLINFO_PRIMARY_IP \- get IP address of last connection .SH SYNOPSIS @@ -19,7 +19,7 @@ The \fBip\fP pointer is NULL or points to private memory. You MUST NOT free \- it gets freed when you call \fIcurl_easy_cleanup(3)\fP on the corresponding CURL handle. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -43,7 +43,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.19.0 +Added in curl 7.19.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_PRIMARY_PORT.3 b/core/curl/files/CURLINFO_PRIMARY_PORT.3 index ab3c0234..8549b625 100644 --- a/core/curl/files/CURLINFO_PRIMARY_PORT.3 +++ b/core/curl/files/CURLINFO_PRIMARY_PORT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_PRIMARY_PORT.md -.TH CURLINFO_PRIMARY_PORT 3 "2024-06-01" libcurl +.TH CURLINFO_PRIMARY_PORT 3 "2024-07-29" libcurl .SH NAME CURLINFO_PRIMARY_PORT \- get the latest destination port number .SH SYNOPSIS @@ -17,7 +17,7 @@ If a proxy was used for the most recent transfer, this is the port number of the proxy, if no proxy was used it is the port number of the most recently accessed URL. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -38,7 +38,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.21.0 +Added in curl 7.21.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_PRIVATE.3 b/core/curl/files/CURLINFO_PRIVATE.3 index eb8257e7..c15026d0 100644 --- a/core/curl/files/CURLINFO_PRIVATE.3 +++ b/core/curl/files/CURLINFO_PRIVATE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_PRIVATE.md -.TH CURLINFO_PRIVATE 3 "2024-06-01" libcurl +.TH CURLINFO_PRIVATE 3 "2024-07-29" libcurl .SH NAME CURLINFO_PRIVATE \- get the private pointer .SH SYNOPSIS @@ -14,7 +14,7 @@ associated with the curl handle (set with the \fICURLOPT_PRIVATE(3)\fP). Please note that for internal reasons, the value is returned as a char pointer, although effectively being a \(aqvoid *\(aq. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -40,7 +40,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.10.3 +Added in curl 7.10.3 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_PROTOCOL.3 b/core/curl/files/CURLINFO_PROTOCOL.3 index 704468dd..515e4c8c 100644 --- a/core/curl/files/CURLINFO_PROTOCOL.3 +++ b/core/curl/files/CURLINFO_PROTOCOL.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_PROTOCOL.md -.TH CURLINFO_PROTOCOL 3 "2024-06-01" libcurl +.TH CURLINFO_PROTOCOL 3 "2024-07-29" libcurl .SH NAME CURLINFO_PROTOCOL \- get the protocol used in the connection .SH SYNOPSIS @@ -26,7 +26,7 @@ CURLPROTO_SCP, CURLPROTO_SFTP, CURLPROTO_SMB, CURLPROTO_SMBS, CURLPROTO_SMTP, CURLPROTO_SMTPS, CURLPROTO_TELNET, CURLPROTO_TFTP, CURLPROTO_MQTT .fi .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -44,8 +44,10 @@ int main(void) } } .fi +.SH DEPRECATED +Deprecated since 7.85.0. .SH AVAILABILITY -Added in 7.52.0. Deprecated since 7.85.0. +Added in curl 7.52.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_PROXYAUTH_AVAIL.3 b/core/curl/files/CURLINFO_PROXYAUTH_AVAIL.3 index 02733c2c..fb766e94 100644 --- a/core/curl/files/CURLINFO_PROXYAUTH_AVAIL.3 +++ b/core/curl/files/CURLINFO_PROXYAUTH_AVAIL.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_PROXYAUTH_AVAIL.md -.TH CURLINFO_PROXYAUTH_AVAIL 3 "2024-06-01" libcurl +.TH CURLINFO_PROXYAUTH_AVAIL 3 "2024-07-29" libcurl .SH NAME CURLINFO_PROXYAUTH_AVAIL \- get available HTTP proxy authentication methods .SH SYNOPSIS @@ -12,10 +12,9 @@ CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_PROXYAUTH_AVAIL, .SH DESCRIPTION Pass a pointer to a long to receive a bitmask indicating the authentication method(s) available according to the previous response. The meaning of the -bits is explained in the \fICURLOPT_PROXYAUTH(3)\fP option for -\fIcurl_easy_setopt(3)\fP. +bits is explained in the \fICURLOPT_PROXYAUTH(3)\fP option for \fIcurl_easy_setopt(3)\fP. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -49,8 +48,7 @@ int main(void) } .fi .SH AVAILABILITY -Added RFC 2617 in 7.10.8 -Added RFC 7616 in 7.57.0 +Added in curl 7.10.8 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_PROXY_ERROR.3 b/core/curl/files/CURLINFO_PROXY_ERROR.3 index 1cb813f6..28028f08 100644 --- a/core/curl/files/CURLINFO_PROXY_ERROR.3 +++ b/core/curl/files/CURLINFO_PROXY_ERROR.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_PROXY_ERROR.md -.TH CURLINFO_PROXY_ERROR 3 "2024-06-01" libcurl +.TH CURLINFO_PROXY_ERROR 3 "2024-07-29" libcurl .SH NAME CURLINFO_PROXY_ERROR \- get the detailed (SOCKS) proxy error .SH SYNOPSIS @@ -53,7 +53,7 @@ transfer returned a \fBCURLE_PROXY\fP error. That error code matches the The error code is zero (\fBCURLPX_OK\fP) if no response code was available. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -76,7 +76,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.73.0 +Added in curl 7.73.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_PROXY_SSL_VERIFYRESULT.3 b/core/curl/files/CURLINFO_PROXY_SSL_VERIFYRESULT.3 index 2f1abc50..eeb28d41 100644 --- a/core/curl/files/CURLINFO_PROXY_SSL_VERIFYRESULT.3 +++ b/core/curl/files/CURLINFO_PROXY_SSL_VERIFYRESULT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_PROXY_SSL_VERIFYRESULT.md -.TH CURLINFO_PROXY_SSL_VERIFYRESULT 3 "2024-06-01" libcurl +.TH CURLINFO_PROXY_SSL_VERIFYRESULT 3 "2024-07-29" libcurl .SH NAME CURLINFO_PROXY_SSL_VERIFYRESULT \- get the result of the proxy certificate verification .SH SYNOPSIS @@ -16,7 +16,7 @@ option. This is only used for HTTPS proxies. 0 is a positive result. Non\-zero is an error. .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS and OpenSSL @@ -50,7 +50,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.52.0 +Added in curl 7.52.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_QUEUE_TIME_T.3 b/core/curl/files/CURLINFO_QUEUE_TIME_T.3 index a21fa6fb..041b280f 100644 --- a/core/curl/files/CURLINFO_QUEUE_TIME_T.3 +++ b/core/curl/files/CURLINFO_QUEUE_TIME_T.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_QUEUE_TIME_T.md -.TH CURLINFO_QUEUE_TIME_T 3 "2024-06-01" libcurl +.TH CURLINFO_QUEUE_TIME_T 3 "2024-07-29" libcurl .SH NAME CURLINFO_QUEUE_TIME_T \- time this transfer was queued .SH SYNOPSIS @@ -17,7 +17,7 @@ connection etc due to set conditions and limits imposed by the application. See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -41,7 +41,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 8.6.0 +Added in curl 8.6.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_REDIRECT_COUNT.3 b/core/curl/files/CURLINFO_REDIRECT_COUNT.3 index 1f02c63e..6c6b488d 100644 --- a/core/curl/files/CURLINFO_REDIRECT_COUNT.3 +++ b/core/curl/files/CURLINFO_REDIRECT_COUNT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_REDIRECT_COUNT.md -.TH CURLINFO_REDIRECT_COUNT 3 "2024-06-01" libcurl +.TH CURLINFO_REDIRECT_COUNT 3 "2024-07-29" libcurl .SH NAME CURLINFO_REDIRECT_COUNT \- get the number of redirects .SH SYNOPSIS @@ -13,7 +13,7 @@ CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_REDIRECT_COUNT, Pass a pointer to a long to receive the total number of redirections that were actually followed. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -33,7 +33,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.9.7 +Added in curl 7.9.7 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_REDIRECT_TIME.3 b/core/curl/files/CURLINFO_REDIRECT_TIME.3 index cba12587..a2524620 100644 --- a/core/curl/files/CURLINFO_REDIRECT_TIME.3 +++ b/core/curl/files/CURLINFO_REDIRECT_TIME.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_REDIRECT_TIME.md -.TH CURLINFO_REDIRECT_TIME 3 "2024-06-01" libcurl +.TH CURLINFO_REDIRECT_TIME 3 "2024-07-29" libcurl .SH NAME CURLINFO_REDIRECT_TIME \- get the time for all redirection steps .SH SYNOPSIS @@ -17,7 +17,7 @@ the complete execution time for multiple redirections. See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -40,7 +40,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.9.7 +Added in curl 7.9.7 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_REDIRECT_TIME_T.3 b/core/curl/files/CURLINFO_REDIRECT_TIME_T.3 index b77ecf57..75a78010 100644 --- a/core/curl/files/CURLINFO_REDIRECT_TIME_T.3 +++ b/core/curl/files/CURLINFO_REDIRECT_TIME_T.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_REDIRECT_TIME_T.md -.TH CURLINFO_REDIRECT_TIME_T 3 "2024-06-01" libcurl +.TH CURLINFO_REDIRECT_TIME_T 3 "2024-07-29" libcurl .SH NAME CURLINFO_REDIRECT_TIME_T \- get the time for all redirection steps .SH SYNOPSIS @@ -18,7 +18,7 @@ multiple redirections. See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.61.0 +Added in curl 7.61.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_REDIRECT_URL.3 b/core/curl/files/CURLINFO_REDIRECT_URL.3 index 9bffaea6..cc1f64b1 100644 --- a/core/curl/files/CURLINFO_REDIRECT_URL.3 +++ b/core/curl/files/CURLINFO_REDIRECT_URL.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_REDIRECT_URL.md -.TH CURLINFO_REDIRECT_URL 3 "2024-06-01" libcurl +.TH CURLINFO_REDIRECT_URL 3 "2024-07-29" libcurl .SH NAME CURLINFO_REDIRECT_URL \- get the URL a redirect would go to .SH SYNOPSIS @@ -9,16 +9,16 @@ CURLINFO_REDIRECT_URL \- get the URL a redirect would go to CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_REDIRECT_URL, char **urlp); .fi .SH DESCRIPTION -Pass a pointer to a char pointer to receive the URL a redirect \fIwould\fP -take you to if you would enable \fICURLOPT_FOLLOWLOCATION(3)\fP. This can come -handy if you think using the built\-in libcurl redirect logic is not good enough -for you but you would still prefer to avoid implementing all the magic of -figuring out the new URL. +Pass a pointer to a char pointer to receive the URL a redirect \fIwould\fP take +you to if you would enable \fICURLOPT_FOLLOWLOCATION(3)\fP. This can come handy if +you think using the built\-in libcurl redirect logic is not good enough for you +but you would still prefer to avoid implementing all the magic of figuring out +the new URL. -This URL is also set if the \fICURLOPT_MAXREDIRS(3)\fP limit prevented a -redirect to happen (since 7.54.1). +This URL is also set if the \fICURLOPT_MAXREDIRS(3)\fP limit prevented a redirect to +happen (since 7.54.1). .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -39,7 +39,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.18.2 +Added in curl 7.18.2 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_REFERER.3 b/core/curl/files/CURLINFO_REFERER.3 index 2e05fd76..ee3404d4 100644 --- a/core/curl/files/CURLINFO_REFERER.3 +++ b/core/curl/files/CURLINFO_REFERER.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_REFERER.md -.TH CURLINFO_REFERER 3 "2024-06-01" libcurl +.TH CURLINFO_REFERER 3 "2024-07-29" libcurl .SH NAME CURLINFO_REFERER \- get the used referrer request header .SH SYNOPSIS @@ -16,7 +16,7 @@ The \fBhdrp\fP pointer is NULL or points to private memory you MUST NOT free \- it gets freed when you call \fIcurl_easy_cleanup(3)\fP on the corresponding CURL handle. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -38,7 +38,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.76.0 +Added in curl 7.76.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_REQUEST_SIZE.3 b/core/curl/files/CURLINFO_REQUEST_SIZE.3 index b654f309..a347da41 100644 --- a/core/curl/files/CURLINFO_REQUEST_SIZE.3 +++ b/core/curl/files/CURLINFO_REQUEST_SIZE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_REQUEST_SIZE.md -.TH CURLINFO_REQUEST_SIZE 3 "2024-06-01" libcurl +.TH CURLINFO_REQUEST_SIZE 3 "2024-07-29" libcurl .SH NAME CURLINFO_REQUEST_SIZE \- get size of sent request .SH SYNOPSIS @@ -13,7 +13,7 @@ Pass a pointer to a long to receive the total size of the issued requests. This is so far only for HTTP requests. Note that this may be more than one request if \fICURLOPT_FOLLOWLOCATION(3)\fP is enabled. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -34,7 +34,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.4.1 +Added in curl 7.4.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_RESPONSE_CODE.3 b/core/curl/files/CURLINFO_RESPONSE_CODE.3 index 59302af6..e875f719 100644 --- a/core/curl/files/CURLINFO_RESPONSE_CODE.3 +++ b/core/curl/files/CURLINFO_RESPONSE_CODE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_RESPONSE_CODE.md -.TH CURLINFO_RESPONSE_CODE 3 "2024-06-01" libcurl +.TH CURLINFO_RESPONSE_CODE 3 "2024-07-29" libcurl .SH NAME CURLINFO_RESPONSE_CODE \- get the last response code .SH SYNOPSIS @@ -17,7 +17,7 @@ no server response code has been received. Note that a proxy\(aqs CONNECT response should be read with \fICURLINFO_HTTP_CONNECTCODE(3)\fP and not this. .SH PROTOCOLS -FTP, HTTP, LDAP and SMTP +This functionality affects ftp, http, ldap and smtp .SH EXAMPLE .nf int main(void) @@ -35,9 +35,11 @@ int main(void) } } .fi +.SH NOTES +The former name, CURLINFO_HTTP_CODE, was added in 7.4.1. Support for SMTP +responses added in 7.25.0, for OpenLDAP in 7.81.0. .SH AVAILABILITY -Added in 7.10.8. CURLINFO_HTTP_CODE was added in 7.4.1. -Support for SMTP responses added in 7.25.0, for OpenLDAP in 7.81.0. +Added in curl 7.10.8 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_RETRY_AFTER.3 b/core/curl/files/CURLINFO_RETRY_AFTER.3 index 3be558a5..b04075fc 100644 --- a/core/curl/files/CURLINFO_RETRY_AFTER.3 +++ b/core/curl/files/CURLINFO_RETRY_AFTER.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_RETRY_AFTER.md -.TH CURLINFO_RETRY_AFTER 3 "2024-06-01" libcurl +.TH CURLINFO_RETRY_AFTER 3 "2024-07-29" libcurl .SH NAME CURLINFO_RETRY_AFTER \- returns the Retry\-After retry delay .SH SYNOPSIS @@ -18,9 +18,9 @@ While the HTTP header might contain a fixed date string, the \fICURLINFO_RETRY_AFTER(3)\fP always returns the number of seconds to wait \- or zero if there was no header or the header could not be parsed. .SH DEFAULT -Returns zero delay if there was no header. +Zero if there was no header. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -41,7 +41,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.66.0 +Added in curl 7.66.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_RTSP_CLIENT_CSEQ.3 b/core/curl/files/CURLINFO_RTSP_CLIENT_CSEQ.3 index fbc35842..0a1b28b3 100644 --- a/core/curl/files/CURLINFO_RTSP_CLIENT_CSEQ.3 +++ b/core/curl/files/CURLINFO_RTSP_CLIENT_CSEQ.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_RTSP_CLIENT_CSEQ.md -.TH CURLINFO_RTSP_CLIENT_CSEQ 3 "2024-06-01" libcurl +.TH CURLINFO_RTSP_CLIENT_CSEQ 3 "2024-07-29" libcurl .SH NAME CURLINFO_RTSP_CLIENT_CSEQ \- get the next RTSP client CSeq .SH SYNOPSIS @@ -13,7 +13,7 @@ CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_RTSP_CLIENT_CSEQ, Pass a pointer to a long to receive the next CSeq that is expected to be used by the application. .SH PROTOCOLS -RTSP +This functionality affects rtsp only .SH EXAMPLE .nf int main(void) @@ -32,7 +32,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.20.0 +Added in curl 7.20.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_RTSP_CSEQ_RECV.3 b/core/curl/files/CURLINFO_RTSP_CSEQ_RECV.3 index a0ae5908..0a1001d3 100644 --- a/core/curl/files/CURLINFO_RTSP_CSEQ_RECV.3 +++ b/core/curl/files/CURLINFO_RTSP_CSEQ_RECV.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_RTSP_CSEQ_RECV.md -.TH CURLINFO_RTSP_CSEQ_RECV 3 "2024-06-01" libcurl +.TH CURLINFO_RTSP_CSEQ_RECV 3 "2024-07-29" libcurl .SH NAME CURLINFO_RTSP_CSEQ_RECV \- get the recently received CSeq .SH SYNOPSIS @@ -14,7 +14,7 @@ server. If your application encounters a \fICURLE_RTSP_CSEQ_ERROR\fP then you may wish to troubleshoot and/or fix the CSeq mismatch by peeking at this value. .SH PROTOCOLS -RTSP +This functionality affects rtsp only .SH EXAMPLE .nf int main(void) @@ -33,7 +33,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.20.0 +Added in curl 7.20.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_RTSP_SERVER_CSEQ.3 b/core/curl/files/CURLINFO_RTSP_SERVER_CSEQ.3 index bbec31b4..7106f76a 100644 --- a/core/curl/files/CURLINFO_RTSP_SERVER_CSEQ.3 +++ b/core/curl/files/CURLINFO_RTSP_SERVER_CSEQ.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_RTSP_SERVER_CSEQ.md -.TH CURLINFO_RTSP_SERVER_CSEQ 3 "2024-06-01" libcurl +.TH CURLINFO_RTSP_SERVER_CSEQ 3 "2024-07-29" libcurl .SH NAME CURLINFO_RTSP_SERVER_CSEQ \- get the next RTSP server CSeq .SH SYNOPSIS @@ -18,7 +18,7 @@ Listening for server initiated requests is not implemented! Applications wishing to resume an RTSP session on another connection should retrieve this info before closing the active connection. .SH PROTOCOLS -RTSP +This functionality affects rtsp only .SH EXAMPLE .nf int main(void) @@ -37,7 +37,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.20.0 +Added in curl 7.20.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_RTSP_SESSION_ID.3 b/core/curl/files/CURLINFO_RTSP_SESSION_ID.3 index 7f8dbe03..9b9c6133 100644 --- a/core/curl/files/CURLINFO_RTSP_SESSION_ID.3 +++ b/core/curl/files/CURLINFO_RTSP_SESSION_ID.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_RTSP_SESSION_ID.md -.TH CURLINFO_RTSP_SESSION_ID 3 "2024-06-01" libcurl +.TH CURLINFO_RTSP_SESSION_ID 3 "2024-07-29" libcurl .SH NAME CURLINFO_RTSP_SESSION_ID \- get RTSP session ID .SH SYNOPSIS @@ -19,7 +19,7 @@ The \fBid\fP pointer is NULL or points to private memory. You MUST NOT free \- it gets freed when you call \fIcurl_easy_cleanup(3)\fP on the corresponding CURL handle. .SH PROTOCOLS -RTSP +This functionality affects rtsp only .SH EXAMPLE .nf int main(void) @@ -38,7 +38,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.20.0 +Added in curl 7.20.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_SCHEME.3 b/core/curl/files/CURLINFO_SCHEME.3 index fdfb974d..1e87244c 100644 --- a/core/curl/files/CURLINFO_SCHEME.3 +++ b/core/curl/files/CURLINFO_SCHEME.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_SCHEME.md -.TH CURLINFO_SCHEME 3 "2024-06-01" libcurl +.TH CURLINFO_SCHEME 3 "2024-07-29" libcurl .SH NAME CURLINFO_SCHEME \- get the URL scheme (sometimes called protocol) used in the connection .SH SYNOPSIS @@ -20,7 +20,7 @@ CURL handle. The returned scheme might be upper or lowercase. Do comparisons case insensitively. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -41,7 +41,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.52.0 +Added in curl 7.52.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_SIZE_DOWNLOAD.3 b/core/curl/files/CURLINFO_SIZE_DOWNLOAD.3 index c69c804a..82ea7c5d 100644 --- a/core/curl/files/CURLINFO_SIZE_DOWNLOAD.3 +++ b/core/curl/files/CURLINFO_SIZE_DOWNLOAD.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_SIZE_DOWNLOAD.md -.TH CURLINFO_SIZE_DOWNLOAD 3 "2024-06-01" libcurl +.TH CURLINFO_SIZE_DOWNLOAD 3 "2024-07-29" libcurl .SH NAME CURLINFO_SIZE_DOWNLOAD \- get the number of downloaded bytes .SH SYNOPSIS @@ -18,7 +18,7 @@ number. \fICURLINFO_SIZE_DOWNLOAD_T(3)\fP is a newer replacement that returns a more sensible variable type. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -42,8 +42,10 @@ int main(void) } } .fi +.SH DEPRECATED +Deprecated since 7.55.0. .SH AVAILABILITY -Added in 7.4.1. Deprecated since 7.55.0. +Added in curl 7.4.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_SIZE_DOWNLOAD_T.3 b/core/curl/files/CURLINFO_SIZE_DOWNLOAD_T.3 index 5c42d709..3f540674 100644 --- a/core/curl/files/CURLINFO_SIZE_DOWNLOAD_T.3 +++ b/core/curl/files/CURLINFO_SIZE_DOWNLOAD_T.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_SIZE_DOWNLOAD_T.md -.TH CURLINFO_SIZE_DOWNLOAD_T 3 "2024-06-01" libcurl +.TH CURLINFO_SIZE_DOWNLOAD_T 3 "2024-07-29" libcurl .SH NAME CURLINFO_SIZE_DOWNLOAD_T \- get the number of downloaded bytes .SH SYNOPSIS @@ -15,7 +15,7 @@ were downloaded. The amount is only for the latest transfer and gets reset again for each new transfer. This counts actual payload data, what\(aqs also commonly called body. All meta and header data is excluded from this amount. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -40,7 +40,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.55.0 +Added in curl 7.55.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_SIZE_UPLOAD.3 b/core/curl/files/CURLINFO_SIZE_UPLOAD.3 index b4159d18..9c9b7ae4 100644 --- a/core/curl/files/CURLINFO_SIZE_UPLOAD.3 +++ b/core/curl/files/CURLINFO_SIZE_UPLOAD.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_SIZE_UPLOAD.md -.TH CURLINFO_SIZE_UPLOAD 3 "2024-06-01" libcurl +.TH CURLINFO_SIZE_UPLOAD 3 "2024-07-29" libcurl .SH NAME CURLINFO_SIZE_UPLOAD \- get the number of uploaded bytes .SH SYNOPSIS @@ -16,7 +16,7 @@ uploaded. \fICURLINFO_SIZE_UPLOAD_T(3)\fP is a newer replacement that returns a more sensible variable type. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -39,8 +39,10 @@ int main(void) } } .fi +.SH DEPRECATED +Deprecated since 7.55.0. .SH AVAILABILITY -Added in 7.4.1. Deprecated since 7.55.0. +Added in curl 7.4.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_SIZE_UPLOAD_T.3 b/core/curl/files/CURLINFO_SIZE_UPLOAD_T.3 index 68dc2f5e..11f0195d 100644 --- a/core/curl/files/CURLINFO_SIZE_UPLOAD_T.3 +++ b/core/curl/files/CURLINFO_SIZE_UPLOAD_T.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_SIZE_UPLOAD_T.md -.TH CURLINFO_SIZE_UPLOAD_T 3 "2024-06-01" libcurl +.TH CURLINFO_SIZE_UPLOAD_T 3 "2024-07-29" libcurl .SH NAME CURLINFO_SIZE_UPLOAD_T \- get the number of uploaded bytes .SH SYNOPSIS @@ -13,7 +13,7 @@ CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SIZE_UPLOAD_T, Pass a pointer to a \fIcurl_off_t\fP to receive the total amount of bytes that were uploaded. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -37,7 +37,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.55.0 +Added in curl 7.55.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_SPEED_DOWNLOAD.3 b/core/curl/files/CURLINFO_SPEED_DOWNLOAD.3 index 6c22db9b..091b177b 100644 --- a/core/curl/files/CURLINFO_SPEED_DOWNLOAD.3 +++ b/core/curl/files/CURLINFO_SPEED_DOWNLOAD.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_SPEED_DOWNLOAD.md -.TH CURLINFO_SPEED_DOWNLOAD 3 "2024-06-01" libcurl +.TH CURLINFO_SPEED_DOWNLOAD 3 "2024-07-29" libcurl .SH NAME CURLINFO_SPEED_DOWNLOAD \- get download speed .SH SYNOPSIS @@ -16,7 +16,7 @@ measured for the complete download. Measured in bytes/second. \fICURLINFO_SPEED_DOWNLOAD_T(3)\fP is a newer replacement that returns a more sensible variable type. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -39,8 +39,10 @@ int main(void) } } .fi +.SH DEPRECATED +Deprecated since 7.55.0. .SH AVAILABILITY -Added in 7.4.1. Deprecated since 7.55.0. +Added in curl 7.4.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_SPEED_DOWNLOAD_T.3 b/core/curl/files/CURLINFO_SPEED_DOWNLOAD_T.3 index 96a22fc5..9a0df62c 100644 --- a/core/curl/files/CURLINFO_SPEED_DOWNLOAD_T.3 +++ b/core/curl/files/CURLINFO_SPEED_DOWNLOAD_T.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_SPEED_DOWNLOAD_T.md -.TH CURLINFO_SPEED_DOWNLOAD_T 3 "2024-06-01" libcurl +.TH CURLINFO_SPEED_DOWNLOAD_T 3 "2024-07-29" libcurl .SH NAME CURLINFO_SPEED_DOWNLOAD_T \- get download speed .SH SYNOPSIS @@ -13,7 +13,7 @@ CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SPEED_DOWNLOAD_T, Pass a pointer to a \fIcurl_off_t\fP to receive the average download speed that curl measured for the complete download. Measured in bytes/second. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -38,7 +38,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.55.0 +Added in curl 7.55.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_SPEED_UPLOAD.3 b/core/curl/files/CURLINFO_SPEED_UPLOAD.3 index 5687c007..99ac57a9 100644 --- a/core/curl/files/CURLINFO_SPEED_UPLOAD.3 +++ b/core/curl/files/CURLINFO_SPEED_UPLOAD.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_SPEED_UPLOAD.md -.TH CURLINFO_SPEED_UPLOAD 3 "2024-06-01" libcurl +.TH CURLINFO_SPEED_UPLOAD 3 "2024-07-29" libcurl .SH NAME CURLINFO_SPEED_UPLOAD \- get upload speed .SH SYNOPSIS @@ -15,7 +15,7 @@ measured for the complete upload. Measured in bytes/second. \fICURLINFO_SPEED_UPLOAD_T(3)\fP is a newer replacement that returns a more sensible variable type. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -38,8 +38,10 @@ int main(void) } } .fi +.SH DEPRECATED +Deprecated since 7.55.0. .SH AVAILABILITY -Added in 7.4.1. Deprecated since 7.55.0. +Added in curl 7.4.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_SPEED_UPLOAD_T.3 b/core/curl/files/CURLINFO_SPEED_UPLOAD_T.3 index 54c83831..f96c3ec8 100644 --- a/core/curl/files/CURLINFO_SPEED_UPLOAD_T.3 +++ b/core/curl/files/CURLINFO_SPEED_UPLOAD_T.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_SPEED_UPLOAD_T.md -.TH CURLINFO_SPEED_UPLOAD_T 3 "2024-06-01" libcurl +.TH CURLINFO_SPEED_UPLOAD_T 3 "2024-07-29" libcurl .SH NAME CURLINFO_SPEED_UPLOAD_T \- get upload speed .SH SYNOPSIS @@ -13,7 +13,7 @@ CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SPEED_UPLOAD_T, Pass a pointer to a \fIcurl_off_t\fP to receive the average upload speed that curl measured for the complete upload. Measured in bytes/second. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -37,7 +37,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.55.0 +Added in curl 7.55.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_SSL_ENGINES.3 b/core/curl/files/CURLINFO_SSL_ENGINES.3 index fb9f34e2..ecb55355 100644 --- a/core/curl/files/CURLINFO_SSL_ENGINES.3 +++ b/core/curl/files/CURLINFO_SSL_ENGINES.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_SSL_ENGINES.md -.TH CURLINFO_SSL_ENGINES 3 "2024-06-01" libcurl +.TH CURLINFO_SSL_ENGINES 3 "2024-07-29" libcurl .SH NAME CURLINFO_SSL_ENGINES \- get an slist of OpenSSL crypto\-engines .SH SYNOPSIS @@ -17,7 +17,7 @@ available at runtime. \fBNOTE:\fP you must call \fIcurl_slist_free_all(3)\fP on the list pointer once you are done with it, as libcurl does not free this data for you. .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: OpenSSL @@ -40,7 +40,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.12.3. Available in OpenSSL builds with "engine" support. +Added in curl 7.12.3 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_SSL_VERIFYRESULT.3 b/core/curl/files/CURLINFO_SSL_VERIFYRESULT.3 index 45116b86..0d446925 100644 --- a/core/curl/files/CURLINFO_SSL_VERIFYRESULT.3 +++ b/core/curl/files/CURLINFO_SSL_VERIFYRESULT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_SSL_VERIFYRESULT.md -.TH CURLINFO_SSL_VERIFYRESULT 3 "2024-06-01" libcurl +.TH CURLINFO_SSL_VERIFYRESULT 3 "2024-07-29" libcurl .SH NAME CURLINFO_SSL_VERIFYRESULT \- get the result of the certificate verification .SH SYNOPSIS @@ -16,7 +16,7 @@ option). 0 is a positive result. Non\-zero is an error. .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS and OpenSSL @@ -49,7 +49,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.5. Only set by the OpenSSL/libressl/boringssl and GnuTLS backends. +Added in curl 7.5 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_STARTTRANSFER_TIME.3 b/core/curl/files/CURLINFO_STARTTRANSFER_TIME.3 index 5b2af03c..ca0dd082 100644 --- a/core/curl/files/CURLINFO_STARTTRANSFER_TIME.3 +++ b/core/curl/files/CURLINFO_STARTTRANSFER_TIME.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_STARTTRANSFER_TIME.md -.TH CURLINFO_STARTTRANSFER_TIME 3 "2024-06-01" libcurl +.TH CURLINFO_STARTTRANSFER_TIME 3 "2024-07-29" libcurl .SH NAME CURLINFO_STARTTRANSFER_TIME \- get the time until the first byte is received .SH SYNOPSIS @@ -19,7 +19,7 @@ When a redirect is followed, the time from each request is added together. See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.9.2 +Added in curl 7.9.2 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_STARTTRANSFER_TIME_T.3 b/core/curl/files/CURLINFO_STARTTRANSFER_TIME_T.3 index 913481c6..fb9d044f 100644 --- a/core/curl/files/CURLINFO_STARTTRANSFER_TIME_T.3 +++ b/core/curl/files/CURLINFO_STARTTRANSFER_TIME_T.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_STARTTRANSFER_TIME_T.md -.TH CURLINFO_STARTTRANSFER_TIME_T 3 "2024-06-01" libcurl +.TH CURLINFO_STARTTRANSFER_TIME_T 3 "2024-07-29" libcurl .SH NAME CURLINFO_STARTTRANSFER_TIME_T \- get the time until the first byte is received .SH SYNOPSIS @@ -20,7 +20,7 @@ When a redirect is followed, the time from each request is added together. See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -44,7 +44,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.61.0 +Added in curl 7.61.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_TLS_SESSION.3 b/core/curl/files/CURLINFO_TLS_SESSION.3 index 69c010a5..36743f86 100644 --- a/core/curl/files/CURLINFO_TLS_SESSION.3 +++ b/core/curl/files/CURLINFO_TLS_SESSION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_TLS_SESSION.md -.TH CURLINFO_TLS_SESSION 3 "2024-06-01" libcurl +.TH CURLINFO_TLS_SESSION 3 "2024-07-29" libcurl .SH NAME CURLINFO_TLS_SESSION \- get TLS session info .SH SYNOPSIS @@ -27,7 +27,7 @@ function \fISSL_get_SSL_CTX(3)\fP. Therefore unless you need compatibility with older versions of libcurl use \fICURLINFO_TLS_SSL_PTR(3)\fP. Refer to that document for more information. .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS and OpenSSL @@ -48,9 +48,10 @@ int main(void) } } .fi +.SH DEPRECATED +Deprecated since 7.48.0 .SH AVAILABILITY -Added in 7.34.0. Deprecated since 7.48.0 and supported by OpenSSL and GnuTLS -only up until this version was released. +Added in curl 7.34.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_TLS_SSL_PTR.3 b/core/curl/files/CURLINFO_TLS_SSL_PTR.3 index c31de329..29335db1 100644 --- a/core/curl/files/CURLINFO_TLS_SSL_PTR.3 +++ b/core/curl/files/CURLINFO_TLS_SSL_PTR.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_TLS_SSL_PTR.md -.TH CURLINFO_TLS_SSL_PTR 3 "2024-06-01" libcurl +.TH CURLINFO_TLS_SSL_PTR 3 "2024-07-29" libcurl .SH NAME CURLINFO_TLS_SESSION, CURLINFO_TLS_SSL_PTR \- get TLS session info .SH SYNOPSIS @@ -35,8 +35,8 @@ struct curl_tlssessioninfo { The \fIbackend\fP struct member is one of the defines in the CURLSSLBACKEND_* series: CURLSSLBACKEND_NONE (when built without TLS support), CURLSSLBACKEND_WOLFSSL, CURLSSLBACKEND_SECURETRANSPORT, CURLSSLBACKEND_GNUTLS, -CURLSSLBACKEND_MBEDTLS, CURLSSLBACKEND_NSS, CURLSSLBACKEND_OPENSSL, -CURLSSLBACKEND_SCHANNEL or CURLSSLBACKEND_MESALINK. (Note that the OpenSSL +CURLSSLBACKEND_MBEDTLS, CURLSSLBACKEND_NSS, CURLSSLBACKEND_OPENSSL or +CURLSSLBACKEND_SCHANNEL. (Note that the OpenSSL forks are all reported as just OpenSSL here.) The \fIinternals\fP struct member points to a TLS library specific pointer for @@ -57,7 +57,7 @@ as well: \fBSSLContext \fP* .IP wolfSSL \fBSSL \fP* - +.PP If the \fIinternals\fP pointer is NULL then either the SSL backend is not supported, an SSL session has not yet been established or the connection is no longer associated with the easy handle (e.g. \fIcurl_easy_perform(3)\fP has @@ -92,7 +92,7 @@ How are you using this option? Are you affected by any of these limitations? Please let us know by making a comment at https://github.com/curl/curl/issues/685 .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: BearSSL, GnuTLS, OpenSSL, Schannel, Secure Transport, mbedTLS and wolfSSL @@ -127,11 +127,11 @@ int main(int argc, char **argv) return res; } .fi -.SH AVAILABILITY -Added in 7.48.0. - +.SH HISTORY This option supersedes \fICURLINFO_TLS_SESSION(3)\fP which was added in 7.34.0. This option is exactly the same as that option except in the case of OpenSSL. +.SH AVAILABILITY +Added in curl 7.48.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_TOTAL_TIME.3 b/core/curl/files/CURLINFO_TOTAL_TIME.3 index 2f77dfdf..72913eb1 100644 --- a/core/curl/files/CURLINFO_TOTAL_TIME.3 +++ b/core/curl/files/CURLINFO_TOTAL_TIME.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_TOTAL_TIME.md -.TH CURLINFO_TOTAL_TIME 3 "2024-06-01" libcurl +.TH CURLINFO_TOTAL_TIME 3 "2024-07-29" libcurl .SH NAME CURLINFO_TOTAL_TIME \- get total time of previous transfer .SH SYNOPSIS @@ -17,7 +17,7 @@ When a redirect is followed, the time from each request is added together. See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -40,7 +40,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.4.1 +Added in curl 7.4.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_TOTAL_TIME_T.3 b/core/curl/files/CURLINFO_TOTAL_TIME_T.3 index 8605421c..ece4d308 100644 --- a/core/curl/files/CURLINFO_TOTAL_TIME_T.3 +++ b/core/curl/files/CURLINFO_TOTAL_TIME_T.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_TOTAL_TIME_T.md -.TH CURLINFO_TOTAL_TIME_T 3 "2024-06-01" libcurl +.TH CURLINFO_TOTAL_TIME_T 3 "2024-07-29" libcurl .SH NAME CURLINFO_TOTAL_TIME_T \- get total time of previous transfer in microseconds .SH SYNOPSIS @@ -18,7 +18,7 @@ When a redirect is followed, the time from each request is added together. See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.61.0 +Added in curl 7.61.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_USED_PROXY.3 b/core/curl/files/CURLINFO_USED_PROXY.3 index 5c7a2b1b..f4897096 100644 --- a/core/curl/files/CURLINFO_USED_PROXY.3 +++ b/core/curl/files/CURLINFO_USED_PROXY.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_USED_PROXY.md -.TH CURLINFO_USED_PROXY 3 "2024-06-01" libcurl +.TH CURLINFO_USED_PROXY 3 "2024-07-29" libcurl .SH NAME CURLINFO_USED_PROXY \- whether the transfer used a proxy .SH SYNOPSIS @@ -13,7 +13,7 @@ CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_USED_PROXY, Pass a pointer to a long. It gets set to zero set if no proxy was used in the previous transfer or a non\-zero value if a proxy was used. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(int argc, char *argv[]) @@ -40,7 +40,7 @@ int main(int argc, char *argv[]) } .fi .SH AVAILABILITY -Added in 8.7.0 +Added in curl 8.7.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLINFO_XFER_ID.3 b/core/curl/files/CURLINFO_XFER_ID.3 index 1d1dbe35..83377768 100644 --- a/core/curl/files/CURLINFO_XFER_ID.3 +++ b/core/curl/files/CURLINFO_XFER_ID.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLINFO_XFER_ID.md -.TH CURLINFO_XFER_ID 3 "2024-06-01" libcurl +.TH CURLINFO_XFER_ID 3 "2024-07-29" libcurl .SH NAME CURLINFO_XFER_ID \- get the ID of a transfer .SH SYNOPSIS @@ -18,7 +18,7 @@ The transfer id is unique among all transfers performed using the same connection cache. This is implicitly the case for all transfers in the same multi handle. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 8.2.0 +Added in curl 8.2.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE.3 b/core/curl/files/CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE.3 index b3817a74..bf683684 100644 --- a/core/curl/files/CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE.3 +++ b/core/curl/files/CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE.md -.TH CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE 3 "2024-06-01" libcurl +.TH CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE 3 "2024-07-29" libcurl .SH NAME CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE \- chunk length threshold for pipelining .SH SYNOPSIS @@ -18,9 +18,9 @@ current chunk length larger than \fICURLMOPT_CHUNK_LENGTH_PENALTY_SIZE(3)\fP, that pipeline is not considered for additional requests, even if it is shorter than \fICURLMOPT_MAX_PIPELINE_LENGTH(3)\fP. .SH DEFAULT -The default value is 0, which means that the penalization is inactive. +0, which means that penalization is inactive. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -31,7 +31,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.30.0 +Added in curl 7.30.0 .SH RETURN VALUE Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE.3 b/core/curl/files/CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE.3 index 9069613d..17c094d3 100644 --- a/core/curl/files/CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE.3 +++ b/core/curl/files/CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE.md -.TH CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE 3 "2024-06-01" libcurl +.TH CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE 3 "2024-07-29" libcurl .SH NAME CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE \- size threshold for pipelining penalty .SH SYNOPSIS @@ -18,9 +18,9 @@ currently processing a request with a Content\-Length larger than this for additional requests, even if it is shorter than \fICURLMOPT_MAX_PIPELINE_LENGTH(3)\fP. .SH DEFAULT -The default value is 0, which means that the size penalization is inactive. +0, which means that the size penalization is inactive. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -31,7 +31,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.30.0 +Added in curl 7.30.0 .SH RETURN VALUE Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLMOPT_MAXCONNECTS.3 b/core/curl/files/CURLMOPT_MAXCONNECTS.3 index bc19120b..b04a8f52 100644 --- a/core/curl/files/CURLMOPT_MAXCONNECTS.3 +++ b/core/curl/files/CURLMOPT_MAXCONNECTS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLMOPT_MAXCONNECTS.md -.TH CURLMOPT_MAXCONNECTS 3 "2024-06-01" libcurl +.TH CURLMOPT_MAXCONNECTS 3 "2024-07-29" libcurl .SH NAME CURLMOPT_MAXCONNECTS \- size of connection cache .SH SYNOPSIS @@ -34,7 +34,7 @@ ones to get made. .SH DEFAULT See DESCRIPTION .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -45,7 +45,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.16.3 +Added in curl 7.16.3 .SH RETURN VALUE Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLMOPT_MAX_CONCURRENT_STREAMS.3 b/core/curl/files/CURLMOPT_MAX_CONCURRENT_STREAMS.3 index 4499dee4..fef99a53 100644 --- a/core/curl/files/CURLMOPT_MAX_CONCURRENT_STREAMS.3 +++ b/core/curl/files/CURLMOPT_MAX_CONCURRENT_STREAMS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLMOPT_MAX_CONCURRENT_STREAMS.md -.TH CURLMOPT_MAX_CONCURRENT_STREAMS 3 "2024-06-01" libcurl +.TH CURLMOPT_MAX_CONCURRENT_STREAMS 3 "2024-07-29" libcurl .SH NAME CURLMOPT_MAX_CONCURRENT_STREAMS \- max concurrent streams for http2 .SH SYNOPSIS @@ -19,7 +19,7 @@ value passed here would be honored based on other system resources properties. .SH DEFAULT 100 .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -30,7 +30,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.67.0 +Added in curl 7.67.0 .SH RETURN VALUE Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLMOPT_MAX_HOST_CONNECTIONS.3 b/core/curl/files/CURLMOPT_MAX_HOST_CONNECTIONS.3 index 080d452d..999556af 100644 --- a/core/curl/files/CURLMOPT_MAX_HOST_CONNECTIONS.3 +++ b/core/curl/files/CURLMOPT_MAX_HOST_CONNECTIONS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLMOPT_MAX_HOST_CONNECTIONS.md -.TH CURLMOPT_MAX_HOST_CONNECTIONS 3 "2024-06-01" libcurl +.TH CURLMOPT_MAX_HOST_CONNECTIONS 3 "2024-07-29" libcurl .SH NAME CURLMOPT_MAX_HOST_CONNECTIONS \- max number of connections to a single host .SH SYNOPSIS @@ -37,7 +37,7 @@ ones to get made. .SH DEFAULT 0 .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -48,7 +48,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.30.0 +Added in curl 7.30.0 .SH RETURN VALUE Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLMOPT_MAX_PIPELINE_LENGTH.3 b/core/curl/files/CURLMOPT_MAX_PIPELINE_LENGTH.3 index 5cc7f4fc..22f5bbd1 100644 --- a/core/curl/files/CURLMOPT_MAX_PIPELINE_LENGTH.3 +++ b/core/curl/files/CURLMOPT_MAX_PIPELINE_LENGTH.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLMOPT_MAX_PIPELINE_LENGTH.md -.TH CURLMOPT_MAX_PIPELINE_LENGTH 3 "2024-06-01" libcurl +.TH CURLMOPT_MAX_PIPELINE_LENGTH 3 "2024-07-29" libcurl .SH NAME CURLMOPT_MAX_PIPELINE_LENGTH \- maximum number of requests in a pipeline .SH SYNOPSIS @@ -25,7 +25,7 @@ of the pipelines to the host is ready to accept a request. Thus, the total .SH DEFAULT 5 .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -36,7 +36,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.30.0 +Added in curl 7.30.0 .SH RETURN VALUE Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLMOPT_MAX_TOTAL_CONNECTIONS.3 b/core/curl/files/CURLMOPT_MAX_TOTAL_CONNECTIONS.3 index 927543b8..38a757c9 100644 --- a/core/curl/files/CURLMOPT_MAX_TOTAL_CONNECTIONS.3 +++ b/core/curl/files/CURLMOPT_MAX_TOTAL_CONNECTIONS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLMOPT_MAX_TOTAL_CONNECTIONS.md -.TH CURLMOPT_MAX_TOTAL_CONNECTIONS 3 "2024-06-01" libcurl +.TH CURLMOPT_MAX_TOTAL_CONNECTIONS 3 "2024-07-29" libcurl .SH NAME CURLMOPT_MAX_TOTAL_CONNECTIONS \- max simultaneously open connections .SH SYNOPSIS @@ -27,10 +27,10 @@ transfer might never even start before it times out. Even in the queued up situation, the \fICURLOPT_CONNECTTIMEOUT_MS(3)\fP timeout is however treated as a per\-connect timeout. .SH DEFAULT -The default value is 0, which means that there is no limit. It is then simply -controlled by the number of easy handles added. +0, which means that there is no limit. It is then simply controlled by the +number of easy handles added. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -41,7 +41,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.30.0 +Added in curl 7.30.0 .SH RETURN VALUE Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLMOPT_PIPELINING.3 b/core/curl/files/CURLMOPT_PIPELINING.3 index 87463208..4f8272f9 100644 --- a/core/curl/files/CURLMOPT_PIPELINING.3 +++ b/core/curl/files/CURLMOPT_PIPELINING.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLMOPT_PIPELINING.md -.TH CURLMOPT_PIPELINING 3 "2024-06-01" libcurl +.TH CURLMOPT_PIPELINING 3 "2024-07-29" libcurl .SH NAME CURLMOPT_PIPELINING \- enable HTTP multiplexing .SH SYNOPSIS @@ -22,11 +22,9 @@ This bit is deprecated and has no effect since version 7.62.0. If this bit is set, libcurl tries to multiplex the new transfer over an existing connection if possible. This requires HTTP/2 or HTTP/3. .SH DEFAULT -Since 7.62.0, \fBCURLPIPE_MULTIPLEX\fP is enabled by default. - -Before that, default was \fBCURLPIPE_NOTHING\fP. +\fBCURLPIPE_MULTIPLEX\fP .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -36,9 +34,15 @@ int main(void) curl_multi_setopt(m, CURLMOPT_PIPELINING, CURLPIPE_MULTIPLEX); } .fi +.SH HISTORY +The multiplex support bit was added in 7.43.0. HTTP/1 Pipelining support was +disabled in 7.62.0. + +Since 7.62.0, \fBCURLPIPE_MULTIPLEX\fP is enabled by default. + +Before that, default was \fBCURLPIPE_NOTHING\fP. .SH AVAILABILITY -Added in 7.16.0. Multiplex support bit added in 7.43.0. HTTP/1 Pipelining -support was disabled in 7.62.0. +Added in curl 7.16.0 .SH RETURN VALUE Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLMOPT_PIPELINING_SERVER_BL.3 b/core/curl/files/CURLMOPT_PIPELINING_SERVER_BL.3 index 5fd4db49..76b394c9 100644 --- a/core/curl/files/CURLMOPT_PIPELINING_SERVER_BL.3 +++ b/core/curl/files/CURLMOPT_PIPELINING_SERVER_BL.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLMOPT_PIPELINING_SERVER_BL.md -.TH CURLMOPT_PIPELINING_SERVER_BL 3 "2024-06-01" libcurl +.TH CURLMOPT_PIPELINING_SERVER_BL 3 "2024-07-29" libcurl .SH NAME CURLMOPT_PIPELINING_SERVER_BL \- pipelining server block list .SH SYNOPSIS @@ -23,9 +23,9 @@ both be blocked by having "Ninja" in the list. Pass a NULL pointer to clear the block list. .SH DEFAULT -The default value is NULL, which means that there is no block list. +NULL, which means that there is no block list. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf static char *server_block_list[] = @@ -41,7 +41,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.30.0 +Added in curl 7.30.0 .SH RETURN VALUE Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLMOPT_PIPELINING_SITE_BL.3 b/core/curl/files/CURLMOPT_PIPELINING_SITE_BL.3 index 0e75a8d7..88c5645d 100644 --- a/core/curl/files/CURLMOPT_PIPELINING_SITE_BL.3 +++ b/core/curl/files/CURLMOPT_PIPELINING_SITE_BL.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLMOPT_PIPELINING_SITE_BL.md -.TH CURLMOPT_PIPELINING_SITE_BL 3 "2024-06-01" libcurl +.TH CURLMOPT_PIPELINING_SITE_BL 3 "2024-07-29" libcurl .SH NAME CURLMOPT_PIPELINING_SITE_BL \- pipelining host block list .SH SYNOPSIS @@ -18,9 +18,9 @@ support HTTP pipelining. The array is copied by libcurl. Pass a NULL pointer to clear the block list. .SH DEFAULT -The default value is NULL, which means that there is no block list. +NULL, which means that there is no block list. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf static char *site_block_list[] = @@ -37,7 +37,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.30.0 +Added in curl 7.30.0 .SH RETURN VALUE Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLMOPT_PUSHDATA.3 b/core/curl/files/CURLMOPT_PUSHDATA.3 index 15565975..3ac03075 100644 --- a/core/curl/files/CURLMOPT_PUSHDATA.3 +++ b/core/curl/files/CURLMOPT_PUSHDATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLMOPT_PUSHDATA.md -.TH CURLMOPT_PUSHDATA 3 "2024-06-01" libcurl +.TH CURLMOPT_PUSHDATA 3 "2024-07-29" libcurl .SH NAME CURLMOPT_PUSHDATA \- pointer to pass to push callback .SH SYNOPSIS @@ -15,7 +15,7 @@ libcurl itself, only passed on to the callback function. .SH DEFAULT NULL .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf #include @@ -56,7 +56,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.44.0 +Added in curl 7.44.0 .SH RETURN VALUE Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLMOPT_PUSHFUNCTION.3 b/core/curl/files/CURLMOPT_PUSHFUNCTION.3 index 4bf3546f..83f4926b 100644 --- a/core/curl/files/CURLMOPT_PUSHFUNCTION.3 +++ b/core/curl/files/CURLMOPT_PUSHFUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLMOPT_PUSHFUNCTION.md -.TH CURLMOPT_PUSHFUNCTION 3 "2024-06-01" libcurl +.TH CURLMOPT_PUSHFUNCTION 3 "2024-07-29" libcurl .SH NAME CURLMOPT_PUSHFUNCTION \- callback that approves or denies server pushes .SH SYNOPSIS @@ -65,7 +65,7 @@ All other return codes are reserved for future use. .SH DEFAULT NULL, no callback .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf #include @@ -106,7 +106,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.44.0 +Added in curl 7.44.0 .SH RETURN VALUE Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLMOPT_SOCKETDATA.3 b/core/curl/files/CURLMOPT_SOCKETDATA.3 index c4873710..e130d395 100644 --- a/core/curl/files/CURLMOPT_SOCKETDATA.3 +++ b/core/curl/files/CURLMOPT_SOCKETDATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLMOPT_SOCKETDATA.md -.TH CURLMOPT_SOCKETDATA 3 "2024-06-01" libcurl +.TH CURLMOPT_SOCKETDATA 3 "2024-07-29" libcurl .SH NAME CURLMOPT_SOCKETDATA \- custom pointer passed to the socket callback .SH SYNOPSIS @@ -17,7 +17,7 @@ callback\(aqs \fBclientp\fP argument. .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf struct priv { @@ -52,7 +52,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.15.4 +Added in curl 7.15.4 .SH RETURN VALUE Returns CURLM_OK. .SH SEE ALSO diff --git a/core/curl/files/CURLMOPT_SOCKETFUNCTION.3 b/core/curl/files/CURLMOPT_SOCKETFUNCTION.3 index 64d2c60c..a95f50c7 100644 --- a/core/curl/files/CURLMOPT_SOCKETFUNCTION.3 +++ b/core/curl/files/CURLMOPT_SOCKETFUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLMOPT_SOCKETFUNCTION.md -.TH CURLMOPT_SOCKETFUNCTION 3 "2024-06-01" libcurl +.TH CURLMOPT_SOCKETFUNCTION 3 "2024-07-29" libcurl .SH NAME CURLMOPT_SOCKETFUNCTION \- callback informed about what to wait for .SH SYNOPSIS @@ -60,7 +60,7 @@ active transfer. It might soon be added again. .SH DEFAULT NULL (no callback) .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf struct priv { @@ -95,7 +95,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.15.4 +Added in curl 7.15.4 .SH RETURN VALUE Returns CURLM_OK. .SH SEE ALSO diff --git a/core/curl/files/CURLMOPT_TIMERDATA.3 b/core/curl/files/CURLMOPT_TIMERDATA.3 index 93571331..65531b75 100644 --- a/core/curl/files/CURLMOPT_TIMERDATA.3 +++ b/core/curl/files/CURLMOPT_TIMERDATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLMOPT_TIMERDATA.md -.TH CURLMOPT_TIMERDATA 3 "2024-06-01" libcurl +.TH CURLMOPT_TIMERDATA 3 "2024-07-29" libcurl .SH NAME CURLMOPT_TIMERDATA \- custom pointer to pass to timer callback .SH SYNOPSIS @@ -17,7 +17,7 @@ callback\(aqs \fBclientp\fP argument. .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf struct priv { @@ -46,7 +46,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.16.0 +Added in curl 7.16.0 .SH RETURN VALUE Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLMOPT_TIMERFUNCTION.3 b/core/curl/files/CURLMOPT_TIMERFUNCTION.3 index 129641f8..0c76c18b 100644 --- a/core/curl/files/CURLMOPT_TIMERFUNCTION.3 +++ b/core/curl/files/CURLMOPT_TIMERFUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLMOPT_TIMERFUNCTION.md -.TH CURLMOPT_TIMERFUNCTION 3 "2024-06-01" libcurl +.TH CURLMOPT_TIMERFUNCTION 3 "2024-07-29" libcurl .SH NAME CURLMOPT_TIMERFUNCTION \- callback to receive timeout values .SH SYNOPSIS @@ -45,7 +45,7 @@ callback with a zero timeout... .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf struct priv { @@ -74,7 +74,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.16.0 +Added in curl 7.16.0 .SH RETURN VALUE Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_ABSTRACT_UNIX_SOCKET.3 b/core/curl/files/CURLOPT_ABSTRACT_UNIX_SOCKET.3 index bc7deed9..390e306d 100644 --- a/core/curl/files/CURLOPT_ABSTRACT_UNIX_SOCKET.3 +++ b/core/curl/files/CURLOPT_ABSTRACT_UNIX_SOCKET.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_ABSTRACT_UNIX_SOCKET.md -.TH CURLOPT_ABSTRACT_UNIX_SOCKET 3 "2024-06-01" libcurl +.TH CURLOPT_ABSTRACT_UNIX_SOCKET 3 "2024-07-29" libcurl .SH NAME CURLOPT_ABSTRACT_UNIX_SOCKET \- abstract Unix domain socket .SH SYNOPSIS @@ -24,9 +24,9 @@ This option shares the same semantics as \fICURLOPT_UNIX_SOCKET_PATH(3)\fP in which documentation more details can be found. Internally, these two options share the same storage and therefore only one of them can be set per handle. .SH DEFAULT -Default is NULL. +NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.53.0. +Added in curl 7.53.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_ACCEPTTIMEOUT_MS.3 b/core/curl/files/CURLOPT_ACCEPTTIMEOUT_MS.3 index 984160d2..44a4822e 100644 --- a/core/curl/files/CURLOPT_ACCEPTTIMEOUT_MS.3 +++ b/core/curl/files/CURLOPT_ACCEPTTIMEOUT_MS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_ACCEPTTIMEOUT_MS.md -.TH CURLOPT_ACCEPTTIMEOUT_MS 3 "2024-06-01" libcurl +.TH CURLOPT_ACCEPTTIMEOUT_MS 3 "2024-07-29" libcurl .SH NAME CURLOPT_ACCEPTTIMEOUT_MS \- timeout waiting for FTP server to connect back .SH SYNOPSIS @@ -14,7 +14,7 @@ server to connect back to libcurl when an active FTP connection is used. .SH DEFAULT 60000 milliseconds .SH PROTOCOLS -FTP +This functionality affects ftp only .SH EXAMPLE .nf int main(void) @@ -31,7 +31,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.24.0 +Added in curl 7.24.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_ACCEPT_ENCODING.3 b/core/curl/files/CURLOPT_ACCEPT_ENCODING.3 index 2933dcfb..e0038f45 100644 --- a/core/curl/files/CURLOPT_ACCEPT_ENCODING.3 +++ b/core/curl/files/CURLOPT_ACCEPT_ENCODING.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_ACCEPT_ENCODING.md -.TH CURLOPT_ACCEPT_ENCODING 3 "2024-06-01" libcurl +.TH CURLOPT_ACCEPT_ENCODING 3 "2024-07-29" libcurl .SH NAME CURLOPT_ACCEPT_ENCODING \- automatic decompression of HTTP downloads .SH SYNOPSIS @@ -53,10 +53,17 @@ sending the length of the non\-compressed content is a common server mistake). The application does not have to keep the string around after setting this option. +.SH HISTORY +This option was called CURLOPT_ENCODING before 7.21.6 +.SH NOTES +The specific libcurl you are using must have been built with zlib to be able to +decompress gzip and deflate responses, with the brotli library to +decompress brotli responses and with the zstd library to decompress zstd +responses. .SH DEFAULT NULL .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -74,12 +81,7 @@ int main(void) } .fi .SH AVAILABILITY -This option was called CURLOPT_ENCODING before 7.21.6 - -The specific libcurl you are using must have been built with zlib to be able to -decompress gzip and deflate responses, with the brotli library to -decompress brotli responses and with the zstd library to decompress zstd -responses. +Added in curl 7.21.6 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_ADDRESS_SCOPE.3 b/core/curl/files/CURLOPT_ADDRESS_SCOPE.3 index f461a161..d2f1a177 100644 --- a/core/curl/files/CURLOPT_ADDRESS_SCOPE.3 +++ b/core/curl/files/CURLOPT_ADDRESS_SCOPE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_ADDRESS_SCOPE.md -.TH CURLOPT_ADDRESS_SCOPE 3 "2024-06-01" libcurl +.TH CURLOPT_ADDRESS_SCOPE 3 "2024-07-29" libcurl .SH NAME CURLOPT_ADDRESS_SCOPE \- scope id for IPv6 addresses .SH SYNOPSIS @@ -13,7 +13,7 @@ Pass a long specifying the scope id value to use when connecting to IPv6 address .SH DEFAULT 0 .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf #include /* for if_nametoindex() */ @@ -33,7 +33,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.19.0 +Added in curl 7.19.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. Returns CURLE_BAD_FUNCTION_ARGUMENT if set to a negative value. diff --git a/core/curl/files/CURLOPT_ALTSVC.3 b/core/curl/files/CURLOPT_ALTSVC.3 index e930c0ae..a7c2e1ec 100644 --- a/core/curl/files/CURLOPT_ALTSVC.3 +++ b/core/curl/files/CURLOPT_ALTSVC.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_ALTSVC.md -.TH CURLOPT_ALTSVC 3 "2024-06-01" libcurl +.TH CURLOPT_ALTSVC 3 "2024-07-29" libcurl .SH NAME CURLOPT_ALTSVC \- alt\-svc cache filename .SH SYNOPSIS @@ -18,7 +18,7 @@ Specify a blank filename ("") to make libcurl not load from a file at all. .SH DEFAULT NULL. The alt\-svc cache is not read nor written to file. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -62,7 +62,7 @@ Boolean (1 or 0) if "persist" was set for this entry .IP 0 Integer priority value (not currently used) .SH AVAILABILITY -Added in 7.64.1 +Added in curl 7.64.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_ALTSVC_CTRL.3 b/core/curl/files/CURLOPT_ALTSVC_CTRL.3 index 2e35ebfd..27104ac7 100644 --- a/core/curl/files/CURLOPT_ALTSVC_CTRL.3 +++ b/core/curl/files/CURLOPT_ALTSVC_CTRL.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_ALTSVC_CTRL.md -.TH CURLOPT_ALTSVC_CTRL 3 "2024-06-01" libcurl +.TH CURLOPT_ALTSVC_CTRL 3 "2024-07-29" libcurl .SH NAME CURLOPT_ALTSVC_CTRL \- control alt\-svc behavior .SH SYNOPSIS @@ -26,6 +26,11 @@ Alternative services are only used when setting up new connections. If there exists an existing connection to the host in the connection pool, then that is preferred. +If \fICURLOPT_ALTSVC(3)\fP is set, \fICURLOPT_ALTSVC_CTRL(3)\fP gets a default value +corresponding to CURLALTSVC_H1 | CURLALTSVC_H2 | CURLALTSVC_H3 \- the HTTP/2 +and HTTP/3 bits are only set if libcurl was built with support for those +versions. + Setting any bit enables the alt\-svc engine. .IP CURLALTSVC_READONLYFILE Do not write the alt\-svc cache back to the file specified with @@ -40,12 +45,9 @@ was also built to actually support HTTP/2, otherwise this bit is ignored. Accept alternative services offered over HTTP/3. This is only used if libcurl was also built to actually support HTTP/3, otherwise this bit is ignored. .SH DEFAULT -Alt\-Svc handling is disabled by default. If \fICURLOPT_ALTSVC(3)\fP is set, -\fICURLOPT_ALTSVC_CTRL(3)\fP has a default value corresponding to -CURLALTSVC_H1 | CURLALTSVC_H2 | CURLALTSVC_H3 \- the HTTP/2 and HTTP/3 bits are -only set if libcurl was built with support for those versions. +0 \- Alt\-Svc handling is disabled .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -59,7 +61,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.64.1 +Added in curl 7.64.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_APPEND.3 b/core/curl/files/CURLOPT_APPEND.3 index fea06025..75f1876c 100644 --- a/core/curl/files/CURLOPT_APPEND.3 +++ b/core/curl/files/CURLOPT_APPEND.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_APPEND.md -.TH CURLOPT_APPEND 3 "2024-06-01" libcurl +.TH CURLOPT_APPEND 3 "2024-07-29" libcurl .SH NAME CURLOPT_APPEND \- append to the remote file .SH SYNOPSIS @@ -14,7 +14,7 @@ instead of overwrite it. This is only useful when uploading to an FTP site. .SH DEFAULT 0 (disabled) .SH PROTOCOLS -FTP +This functionality affects ftp only .SH EXAMPLE .nf int main(void) @@ -30,8 +30,10 @@ int main(void) } } .fi -.SH AVAILABILITY +.SH HISTORY This option was known as CURLOPT_FTPAPPEND up to 7.16.4 +.SH AVAILABILITY +Added in curl 7.17.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_AUTOREFERER.3 b/core/curl/files/CURLOPT_AUTOREFERER.3 index 552c684c..71cca6eb 100644 --- a/core/curl/files/CURLOPT_AUTOREFERER.3 +++ b/core/curl/files/CURLOPT_AUTOREFERER.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_AUTOREFERER.md -.TH CURLOPT_AUTOREFERER 3 "2024-06-01" libcurl +.TH CURLOPT_AUTOREFERER 3 "2024-07-29" libcurl .SH NAME CURLOPT_AUTOREFERER \- automatically update the referer header .SH SYNOPSIS @@ -22,7 +22,7 @@ referer header after the transfer. .SH DEFAULT 0, disabled .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -45,7 +45,7 @@ int main(void) } .fi .SH AVAILABILITY -Along with HTTP +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_AWS_SIGV4.3 b/core/curl/files/CURLOPT_AWS_SIGV4.3 index 9ca8b1ae..502d138c 100644 --- a/core/curl/files/CURLOPT_AWS_SIGV4.3 +++ b/core/curl/files/CURLOPT_AWS_SIGV4.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_AWS_SIGV4.md -.TH CURLOPT_AWS_SIGV4 3 "2024-06-01" libcurl +.TH CURLOPT_AWS_SIGV4 3 "2024-07-29" libcurl .SH NAME CURLOPT_AWS_SIGV4 \- V4 signature .SH SYNOPSIS @@ -24,24 +24,25 @@ It is extracted from the hostname specified in the URL if omitted. .IP service The argument is a function provided by a cloud. It is extracted from the hostname specified in the URL if omitted. - -NOTE: This call set \fICURLOPT_HTTPAUTH(3)\fP to CURLAUTH_AWS_SIGV4. -Calling \fICURLOPT_HTTPAUTH(3)\fP with CURLAUTH_AWS_SIGV4 is the same -as calling this with \fB"aws:amz"\fP in parameter. +.PP +NOTE: This call set \fICURLOPT_HTTPAUTH(3)\fP to CURLAUTH_AWS_SIGV4. Calling +\fICURLOPT_HTTPAUTH(3)\fP with CURLAUTH_AWS_SIGV4 is the same as calling this with +\fB"aws:amz"\fP in parameter. Example with "Test:Try", when curl uses the algorithm, it generates -\fB"TEST\-HMAC\-SHA256"\fP for "Algorithm", \fB"x\-try\-date"\fP and -\fB"X\-Try\-Date"\fP for "date", \fB"test4_request"\fP for "request type", +\fB"TEST\-HMAC\-SHA256"\fP for "Algorithm", \fB"x\-try\-date"\fP and \fB"X\-Try\-Date"\fP +for "date", \fB"test4_request"\fP for "request type", \fB"SignedHeaders=content\-type;host;x\-try\-date"\fP for "signed headers" If you use just "test", instead of "test:try", test is used for every generated string. + +Setting \fICURLOPT_HTTPAUTH(3)\fP with the CURLAUTH_AWS_SIGV4 bit set is the same as +setting this option with a \fB"aws:amz"\fP parameter. .SH DEFAULT -By default, the value of this parameter is NULL. -Calling \fICURLOPT_HTTPAUTH(3)\fP with CURLAUTH_AWS_SIGV4 is the same -as calling this with \fB"aws:amz"\fP in parameter. +NULL .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -63,14 +64,10 @@ int main(void) } } .fi -.SH AVAILABILITY -Added in 7.75.0 -.SH RETURN VALUE -Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH NOTES This option overrides the other auth types you might have set in -\fICURLOPT_HTTPAUTH(3)\fP which should be highlighted as this makes this auth -method special. This method cannot be combined with other auth types. +\fICURLOPT_HTTPAUTH(3)\fP which should be highlighted as this makes this auth method +special. This method cannot be combined with other auth types. A sha256 checksum of the request payload is used as input to the signature calculation. For POST requests, this is a checksum of the provided @@ -78,9 +75,13 @@ calculation. For POST requests, this is a checksum of the provided requests like PUT, you can provide your own checksum in an HTTP header named \fBx\-provider2\-content\-sha256\fP. -For \fBaws:s3\fP, a \fBx\-amz\-content\-sha256\fP header is added to every request -if not already present. For s3 requests with unknown payload, this header takes +For \fBaws:s3\fP, a \fBx\-amz\-content\-sha256\fP header is added to every request if +not already present. For s3 requests with unknown payload, this header takes the special value "UNSIGNED\-PAYLOAD". +.SH AVAILABILITY +Added in curl 7.75.0 +.SH RETURN VALUE +Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO .BR CURLOPT_HEADEROPT (3), .BR CURLOPT_HTTPAUTH (3), diff --git a/core/curl/files/CURLOPT_BUFFERSIZE.3 b/core/curl/files/CURLOPT_BUFFERSIZE.3 index 3f2462f2..4ab8d736 100644 --- a/core/curl/files/CURLOPT_BUFFERSIZE.3 +++ b/core/curl/files/CURLOPT_BUFFERSIZE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_BUFFERSIZE.md -.TH CURLOPT_BUFFERSIZE 3 "2024-06-01" libcurl +.TH CURLOPT_BUFFERSIZE 3 "2024-07-29" libcurl .SH NAME CURLOPT_BUFFERSIZE \- receive buffer size .SH SYNOPSIS @@ -33,7 +33,7 @@ allocated as long as there are active transfers. .SH DEFAULT CURL_MAX_WRITE_SIZE (16kB) .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -53,7 +53,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.10. Growing the buffer was added in 7.53.0. +Added in curl 7.10 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_CAINFO.3 b/core/curl/files/CURLOPT_CAINFO.3 index 7fe3e529..b9bc32ad 100644 --- a/core/curl/files/CURLOPT_CAINFO.3 +++ b/core/curl/files/CURLOPT_CAINFO.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_CAINFO.md -.TH CURLOPT_CAINFO 3 "2024-06-01" libcurl +.TH CURLOPT_CAINFO 3 "2024-07-29" libcurl .SH NAME CURLOPT_CAINFO \- path to Certificate Authority (CA) bundle .SH SYNOPSIS @@ -36,7 +36,7 @@ The default value for this can be figured out with \fICURLINFO_CAINFO(3)\fP. Built\-in system specific. When curl is built with Secure Transport or Schannel, this option is not set by default. .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. All TLS backends support this option. .SH EXAMPLE @@ -52,8 +52,10 @@ int main(void) } } .fi -.SH AVAILABILITY +.SH HISTORY Schannel support added in libcurl 7.60. +.SH AVAILABILITY +Added in curl 7.4.2 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_CAINFO_BLOB.3 b/core/curl/files/CURLOPT_CAINFO_BLOB.3 index a6111c75..dea2132c 100644 --- a/core/curl/files/CURLOPT_CAINFO_BLOB.3 +++ b/core/curl/files/CURLOPT_CAINFO_BLOB.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_CAINFO_BLOB.md -.TH CURLOPT_CAINFO_BLOB 3 "2024-06-01" libcurl +.TH CURLOPT_CAINFO_BLOB 3 "2024-07-29" libcurl .SH NAME CURLOPT_CAINFO_BLOB \- Certificate Authority (CA) bundle in PEM format .SH SYNOPSIS @@ -25,7 +25,7 @@ This option overrides \fICURLOPT_CAINFO(3)\fP. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: BearSSL, OpenSSL, Schannel, Secure Transport, mbedTLS, rustls and wolfSSL @@ -50,12 +50,12 @@ int main(void) } } .fi -.SH AVAILABILITY -Added in 7.77.0. - +.SH HISTORY This option is supported by the BearSSL (since 7.79.0), mbedTLS (since 7.81.0), rustls (since 7.82.0), wolfSSL (since 8.2.0), OpenSSL, Secure Transport and Schannel backends. +.SH AVAILABILITY +Added in curl 7.77.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_CAPATH.3 b/core/curl/files/CURLOPT_CAPATH.3 index 8d9a78ca..73b34de6 100644 --- a/core/curl/files/CURLOPT_CAPATH.3 +++ b/core/curl/files/CURLOPT_CAPATH.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_CAPATH.md -.TH CURLOPT_CAPATH 3 "2024-06-01" libcurl +.TH CURLOPT_CAPATH 3 "2024-07-29" libcurl .SH NAME CURLOPT_CAPATH \- directory holding CA certificates .SH SYNOPSIS @@ -23,9 +23,9 @@ option. The default value for this can be figured out with \fICURLINFO_CAPATH(3)\fP. .SH DEFAULT -A default path detected at build time. +A path detected at build time. .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS, OpenSSL, mbedTLS and wolfSSL @@ -44,7 +44,7 @@ int main(void) } .fi .SH AVAILABILITY -This option is supported by the OpenSSL, GnuTLS, mbedTLS and wolfSSL backends. +Added in curl 7.9.8 .SH RETURN VALUE CURLE_OK if supported; or an error such as: diff --git a/core/curl/files/CURLOPT_CA_CACHE_TIMEOUT.3 b/core/curl/files/CURLOPT_CA_CACHE_TIMEOUT.3 index 80899831..fb97c434 100644 --- a/core/curl/files/CURLOPT_CA_CACHE_TIMEOUT.3 +++ b/core/curl/files/CURLOPT_CA_CACHE_TIMEOUT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_CA_CACHE_TIMEOUT.md -.TH CURLOPT_CA_CACHE_TIMEOUT 3 "2024-06-01" libcurl +.TH CURLOPT_CA_CACHE_TIMEOUT 3 "2024-07-29" libcurl .SH NAME CURLOPT_CA_CACHE_TIMEOUT \- life\-time for cached certificate stores .SH SYNOPSIS @@ -10,23 +10,24 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CA_CACHE_TIMEOUT, long age); .fi .SH DESCRIPTION Pass a long, this sets the timeout in seconds. This tells libcurl the maximum -time any cached certificate store it has in memory may be kept and reused for -new connections. Once the timeout has expired, a subsequent fetch requiring a -certificate has to reload it. +time any cached CA certificate store it has in memory may be kept and reused +for new connections. Once the timeout has expired, a subsequent fetch +requiring a CA certificate has to reload it. -Building a certificate store from a \fICURLOPT_CAINFO(3)\fP file is a slow -operation so curl may cache the generated certificate store internally to speed -up future connections. +Building a CA certificate store from a \fICURLOPT_CAINFO(3)\fP file is a slow +operation so curl may cache the generated certificate store internally to +speed up future connections. -Set to zero to completely disable caching, or set to \-1 to retain the cached -store remain forever. By default, libcurl caches this info for 24 hours. +Set the timeout to zero to completely disable caching, or set to \-1 to retain +the cached store remain forever. By default, libcurl caches this info for 24 +hours. .SH DEFAULT 86400 (24 hours) .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: -OpenSSL +GnuTLS, OpenSSL, Schannel and wolfSSL .SH EXAMPLE .nf int main(void) @@ -49,11 +50,11 @@ int main(void) } } .fi +.SH HISTORY +This option is supported by OpenSSL and its forks (since 7.87.0), Schannel +(since 8.5.0), wolfSSL (since 8.9.0) and GnuTLS (since 8.9.0). .SH AVAILABILITY -This option was added in curl 7.87.0. - -This option is supported by OpenSSL and its forks (since 7.87.0) and Schannel -(since 8.5.0). +Added in curl 7.87.0 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_CERTINFO.3 b/core/curl/files/CURLOPT_CERTINFO.3 index ab0c7f36..a4664761 100644 --- a/core/curl/files/CURLOPT_CERTINFO.3 +++ b/core/curl/files/CURLOPT_CERTINFO.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_CERTINFO.md -.TH CURLOPT_CERTINFO 3 "2024-06-01" libcurl +.TH CURLOPT_CERTINFO 3 "2024-07-29" libcurl .SH NAME CURLOPT_CERTINFO \- request SSL certificate information .SH SYNOPSIS @@ -17,7 +17,7 @@ its option \fICURLINFO_CERTINFO(3)\fP. .SH DEFAULT 0 .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS, OpenSSL, Schannel and Secure Transport @@ -58,8 +58,11 @@ int main(void) } } .fi -.SH AVAILABILITY +.SH HISTORY Schannel support added in 7.50.0. Secure Transport support added in 7.79.0. +mbedTLS support added in 8.9.0. +.SH AVAILABILITY +Added in curl 7.19.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_CHUNK_BGN_FUNCTION.3 b/core/curl/files/CURLOPT_CHUNK_BGN_FUNCTION.3 index 984b27cc..ea12f7ed 100644 --- a/core/curl/files/CURLOPT_CHUNK_BGN_FUNCTION.3 +++ b/core/curl/files/CURLOPT_CHUNK_BGN_FUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_CHUNK_BGN_FUNCTION.md -.TH CURLOPT_CHUNK_BGN_FUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_CHUNK_BGN_FUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_CHUNK_BGN_FUNCTION \- callback before a transfer with FTP wildcard match .SH SYNOPSIS @@ -65,7 +65,7 @@ Return \fICURL_CHUNK_BGN_FUNC_OK\fP if everything is fine, .SH DEFAULT NULL .SH PROTOCOLS -FTP +This functionality affects ftp only .SH EXAMPLE .nf #include @@ -123,7 +123,7 @@ int main() } .fi .SH AVAILABILITY -This was added in 7.21.0 +Added in curl 7.21.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_CHUNK_DATA.3 b/core/curl/files/CURLOPT_CHUNK_DATA.3 index 101c5109..e8ac68f6 100644 --- a/core/curl/files/CURLOPT_CHUNK_DATA.3 +++ b/core/curl/files/CURLOPT_CHUNK_DATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_CHUNK_DATA.md -.TH CURLOPT_CHUNK_DATA 3 "2024-06-01" libcurl +.TH CURLOPT_CHUNK_DATA 3 "2024-07-29" libcurl .SH NAME CURLOPT_CHUNK_DATA \- pointer passed to the FTP chunk callbacks .SH SYNOPSIS @@ -15,7 +15,7 @@ argument to the \fICURLOPT_CHUNK_BGN_FUNCTION(3)\fP and .SH DEFAULT NULL .SH PROTOCOLS -FTP +This functionality affects ftp only .SH EXAMPLE .nf #include @@ -73,7 +73,7 @@ int main() } .fi .SH AVAILABILITY -Added in 7.21.0 +Added in curl 7.21.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_CHUNK_END_FUNCTION.3 b/core/curl/files/CURLOPT_CHUNK_END_FUNCTION.3 index 9cc1f589..07183861 100644 --- a/core/curl/files/CURLOPT_CHUNK_END_FUNCTION.3 +++ b/core/curl/files/CURLOPT_CHUNK_END_FUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_CHUNK_END_FUNCTION.md -.TH CURLOPT_CHUNK_END_FUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_CHUNK_END_FUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_CHUNK_END_FUNCTION \- callback after a transfer with FTP wildcard match .SH SYNOPSIS @@ -23,7 +23,7 @@ Return \fICURL_CHUNK_END_FUNC_OK\fP if everything is fine or .SH DEFAULT NULL .SH PROTOCOLS -FTP +This functionality affects ftp only .SH EXAMPLE .nf #include @@ -53,7 +53,7 @@ int main() } .fi .SH AVAILABILITY -Added in 7.21.0 +Added in curl 7.21.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_CLOSESOCKETDATA.3 b/core/curl/files/CURLOPT_CLOSESOCKETDATA.3 index e6faab49..57a10af2 100644 --- a/core/curl/files/CURLOPT_CLOSESOCKETDATA.3 +++ b/core/curl/files/CURLOPT_CLOSESOCKETDATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_CLOSESOCKETDATA.md -.TH CURLOPT_CLOSESOCKETDATA 3 "2024-06-01" libcurl +.TH CURLOPT_CLOSESOCKETDATA 3 "2024-07-29" libcurl .SH NAME CURLOPT_CLOSESOCKETDATA \- pointer passed to the socket close callback .SH SYNOPSIS @@ -14,9 +14,9 @@ Pass a \fIpointer\fP that remains untouched by libcurl and passed as the first argument in the closesocket callback set with \fICURLOPT_CLOSESOCKETFUNCTION(3)\fP. .SH DEFAULT -The default value of this parameter is NULL. +NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf struct priv { @@ -46,7 +46,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.21.7 +Added in curl 7.21.7 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_CLOSESOCKETFUNCTION.3 b/core/curl/files/CURLOPT_CLOSESOCKETFUNCTION.3 index 04f80a14..412dbc92 100644 --- a/core/curl/files/CURLOPT_CLOSESOCKETFUNCTION.3 +++ b/core/curl/files/CURLOPT_CLOSESOCKETFUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_CLOSESOCKETFUNCTION.md -.TH CURLOPT_CLOSESOCKETFUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_CLOSESOCKETFUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_CLOSESOCKETFUNCTION \- callback to socket close replacement .SH SYNOPSIS @@ -25,9 +25,9 @@ The \fIclientp\fP pointer is set with \fICURLOPT_CLOSESOCKETDATA(3)\fP. \fIitem\fP is the socket libcurl wants to be closed. .SH DEFAULT -By default libcurl uses the standard socket close function. +Use the standard socket close function. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf struct priv { @@ -57,7 +57,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.21.7 +Added in curl 7.21.7 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_CONNECTTIMEOUT.3 b/core/curl/files/CURLOPT_CONNECTTIMEOUT.3 index 38890d71..063be852 100644 --- a/core/curl/files/CURLOPT_CONNECTTIMEOUT.3 +++ b/core/curl/files/CURLOPT_CONNECTTIMEOUT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_CONNECTTIMEOUT.md -.TH CURLOPT_CONNECTTIMEOUT 3 "2024-06-01" libcurl +.TH CURLOPT_CONNECTTIMEOUT 3 "2024-07-29" libcurl .SH NAME CURLOPT_CONNECTTIMEOUT \- timeout for the connect phase .SH SYNOPSIS @@ -9,22 +9,22 @@ CURLOPT_CONNECTTIMEOUT \- timeout for the connect phase CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CONNECTTIMEOUT, long timeout); .fi .SH DESCRIPTION -Pass a long. It should contain the maximum time in seconds that you allow the -connection phase to the server to take. This timeout only limits the -connection phase, it has no impact once it has connected. Set to zero to -switch to the default built\-in connection timeout \- 300 seconds. See also the -\fICURLOPT_TIMEOUT(3)\fP option. +Pass a long. It sets the maximum time in seconds that you allow the connection +phase to take. This timeout only limits the connection phase, it has no impact +once libcurl has connected. The connection phase includes the name resolve +(DNS) and all protocol handshakes and negotiations until there is an +established connection with the remote side. + +Set this option to zero to switch to the default built\-in connection timeout \- +300 seconds. See also the \fICURLOPT_TIMEOUT(3)\fP option. \fICURLOPT_CONNECTTIMEOUT_MS(3)\fP is the same function but set in milliseconds. If both \fICURLOPT_CONNECTTIMEOUT(3)\fP and \fICURLOPT_CONNECTTIMEOUT_MS(3)\fP are set, the value set last is used. -The "connection phase" is considered complete when the requested TCP, TLS or -QUIC handshakes are done. - -The connection timeout set with \fICURLOPT_CONNECTTIMEOUT(3)\fP is included in -the general all\-covering \fICURLOPT_TIMEOUT(3)\fP. +The connection timeout is included in the general all\-covering +\fICURLOPT_TIMEOUT(3)\fP: With \fICURLOPT_CONNECTTIMEOUT(3)\fP set to 3 and \fICURLOPT_TIMEOUT(3)\fP set to 5, the operation can never last longer than 5 seconds, and the connection @@ -40,7 +40,7 @@ signals to be used unless \fICURLOPT_NOSIGNAL(3)\fP is set. .SH DEFAULT 300 .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -57,12 +57,11 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.7 .SH RETURN VALUE Returns CURLE_OK. Returns CURLE_BAD_FUNCTION_ARGUMENT if set to a negative value or a value that when converted to milliseconds is too large. .SH SEE ALSO -.BR CURLOPT_CONNECTTIMEOUT_MS (3), .BR CURLOPT_LOW_SPEED_LIMIT (3), .BR CURLOPT_MAX_RECV_SPEED_LARGE (3), .BR CURLOPT_TIMEOUT (3) diff --git a/core/curl/files/CURLOPT_CONNECTTIMEOUT_MS.3 b/core/curl/files/CURLOPT_CONNECTTIMEOUT_MS.3 index 2804fef0..41836e19 100644 --- a/core/curl/files/CURLOPT_CONNECTTIMEOUT_MS.3 +++ b/core/curl/files/CURLOPT_CONNECTTIMEOUT_MS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_CONNECTTIMEOUT_MS.md -.TH CURLOPT_CONNECTTIMEOUT_MS 3 "2024-06-01" libcurl +.TH CURLOPT_CONNECTTIMEOUT_MS 3 "2024-07-29" libcurl .SH NAME CURLOPT_CONNECTTIMEOUT_MS \- timeout for the connect phase .SH SYNOPSIS @@ -10,14 +10,38 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CONNECTTIMEOUT_MS, long timeout); .fi .SH DESCRIPTION -Pass a long. It should contain the maximum time in milliseconds that you allow -the connection phase to the server to take. +Pass a long. It sets the maximum time in milliseconds that you allow the +connection phase to take. This timeout only limits the connection phase, it +has no impact once libcurl has connected. The connection phase includes the +name resolve (DNS) and all protocol handshakes and negotiations until there is +an established connection with the remote side. -See \fICURLOPT_CONNECTTIMEOUT(3)\fP for details. +Set this option to zero to switch to the default built\-in connection timeout \- +300 seconds. See also the \fICURLOPT_TIMEOUT_MS(3)\fP option. + +\fICURLOPT_CONNECTTIMEOUT(3)\fP is the same function but set in seconds. + +If both \fICURLOPT_CONNECTTIMEOUT(3)\fP and \fICURLOPT_CONNECTTIMEOUT_MS(3)\fP are set, +the value set last is used. + +The connection timeout is included in the general all\-covering +\fICURLOPT_TIMEOUT_MS(3)\fP: + +With \fICURLOPT_CONNECTTIMEOUT_MS(3)\fP set to 3000 and \fICURLOPT_TIMEOUT_MS(3)\fP set to +5000, the operation can never last longer than 5000 milliseconds, and the +connection phase cannot last longer than 3000 milliseconds. + +With \fICURLOPT_CONNECTTIMEOUT_MS(3)\fP set to 4000 and \fICURLOPT_TIMEOUT_MS(3)\fP set to +2000, the operation can never last longer than 2000 milliseconds. Including +the connection phase. + +This option may cause libcurl to use the SIGALRM signal to timeout system +calls on builds not using asynch DNS. In unix\-like systems, this might cause +signals to be used unless \fICURLOPT_NOSIGNAL(3)\fP is set. .SH DEFAULT 300000 .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -34,10 +58,10 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.16.2 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO -.BR CURLOPT_CONNECTTIMEOUT (3), .BR CURLOPT_LOW_SPEED_LIMIT (3), -.BR CURLOPT_TIMEOUT (3) +.BR CURLOPT_MAX_RECV_SPEED_LARGE (3), +.BR CURLOPT_TIMEOUT_MS (3) diff --git a/core/curl/files/CURLOPT_CONNECT_ONLY.3 b/core/curl/files/CURLOPT_CONNECT_ONLY.3 index f0900fd4..4031b453 100644 --- a/core/curl/files/CURLOPT_CONNECT_ONLY.3 +++ b/core/curl/files/CURLOPT_CONNECT_ONLY.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_CONNECT_ONLY.md -.TH CURLOPT_CONNECT_ONLY 3 "2024-06-01" libcurl +.TH CURLOPT_CONNECT_ONLY 3 "2024-07-29" libcurl .SH NAME CURLOPT_CONNECT_ONLY \- stop when connected to target server .SH SYNOPSIS @@ -34,7 +34,7 @@ application wants to use it. Once it has been removed with .SH DEFAULT 0 .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -51,8 +51,10 @@ int main(void) } } .fi +.SH HISTORY +WS and WSS support added in 7.86.0. .SH AVAILABILITY -Added in 7.15.2. WS and WSS support added in 7.86.0. +Added in curl 7.15.2 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_CONNECT_TO.3 b/core/curl/files/CURLOPT_CONNECT_TO.3 index 3dd2dced..e15e49f5 100644 --- a/core/curl/files/CURLOPT_CONNECT_TO.3 +++ b/core/curl/files/CURLOPT_CONNECT_TO.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_CONNECT_TO.md -.TH CURLOPT_CONNECT_TO 3 "2024-06-01" libcurl +.TH CURLOPT_CONNECT_TO 3 "2024-07-29" libcurl .SH NAME CURLOPT_CONNECT_TO \- connect to another host and port instead .SH SYNOPSIS @@ -59,7 +59,7 @@ a transfer before you call \fIcurl_slist_free_all(3)\fP on the list. .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -83,7 +83,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.49.0 +Added in curl 7.49.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_CONV_FROM_NETWORK_FUNCTION.3 b/core/curl/files/CURLOPT_CONV_FROM_NETWORK_FUNCTION.3 index 5a4407ce..1b9bf58e 100644 --- a/core/curl/files/CURLOPT_CONV_FROM_NETWORK_FUNCTION.3 +++ b/core/curl/files/CURLOPT_CONV_FROM_NETWORK_FUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_CONV_FROM_NETWORK_FUNCTION.md -.TH CURLOPT_CONV_FROM_NETWORK_FUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_CONV_FROM_NETWORK_FUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_CONV_FROM_NETWORK_FUNCTION \- convert data from network to host encoding .SH SYNOPSIS @@ -54,7 +54,7 @@ You need to override these definitions if they are different on your system. .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf static CURLcode my_conv_from_ascii_to_ebcdic(char *buffer, size_t length) @@ -81,11 +81,13 @@ int main(void) my_conv_from_ascii_to_ebcdic); } .fi -.SH AVAILABILITY +.SH DEPRECATED Not available and deprecated since 7.82.0. Available only if \fBCURL_DOES_CONVERSIONS\fP was defined when libcurl was built. +.SH AVAILABILITY +Added in curl 7.15.4 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_CONV_FROM_UTF8_FUNCTION.3 b/core/curl/files/CURLOPT_CONV_FROM_UTF8_FUNCTION.3 index a7338d74..c8fc95d5 100644 --- a/core/curl/files/CURLOPT_CONV_FROM_UTF8_FUNCTION.3 +++ b/core/curl/files/CURLOPT_CONV_FROM_UTF8_FUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_CONV_FROM_UTF8_FUNCTION.md -.TH CURLOPT_CONV_FROM_UTF8_FUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_CONV_FROM_UTF8_FUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_CONV_FROM_UTF8_FUNCTION \- convert data from UTF8 to host encoding .SH SYNOPSIS @@ -51,7 +51,7 @@ You need to override these definitions if they are different on your system. .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf static CURLcode my_conv_from_utf8_to_ebcdic(char *buffer, size_t length) @@ -74,11 +74,13 @@ int main(void) my_conv_from_utf8_to_ebcdic); } .fi -.SH AVAILABILITY +.SH DEPRECATED Not available and deprecated since 7.82.0. Available only if \fBCURL_DOES_CONVERSIONS\fP was defined when libcurl was built. +.SH AVAILABILITY +Added in curl 7.15.4 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_CONV_TO_NETWORK_FUNCTION.3 b/core/curl/files/CURLOPT_CONV_TO_NETWORK_FUNCTION.3 index ba087fb1..5a079638 100644 --- a/core/curl/files/CURLOPT_CONV_TO_NETWORK_FUNCTION.3 +++ b/core/curl/files/CURLOPT_CONV_TO_NETWORK_FUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_CONV_TO_NETWORK_FUNCTION.md -.TH CURLOPT_CONV_TO_NETWORK_FUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_CONV_TO_NETWORK_FUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_CONV_TO_NETWORK_FUNCTION \- convert data to network from host encoding .SH SYNOPSIS @@ -53,7 +53,7 @@ You need to override these definitions if they are different on your system. .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf static CURLcode my_conv_from_ebcdic_to_ascii(char *buffer, size_t length) @@ -77,11 +77,13 @@ int main(void) my_conv_from_ebcdic_to_ascii); } .fi -.SH AVAILABILITY +.SH DEPRECATED Not available and deprecated since 7.82.0. Available only if \fBCURL_DOES_CONVERSIONS\fP was defined when libcurl was built. +.SH AVAILABILITY +Added in curl 7.15.4 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_COOKIE.3 b/core/curl/files/CURLOPT_COOKIE.3 index 18085d32..4941bacb 100644 --- a/core/curl/files/CURLOPT_COOKIE.3 +++ b/core/curl/files/CURLOPT_COOKIE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_COOKIE.md -.TH CURLOPT_COOKIE 3 "2024-06-01" libcurl +.TH CURLOPT_COOKIE 3 "2024-07-29" libcurl .SH NAME CURLOPT_COOKIE \- HTTP Cookie header .SH SYNOPSIS @@ -48,7 +48,7 @@ ability to stop super cookies. PSL support is identified by the .SH DEFAULT NULL, no cookies .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -64,7 +64,7 @@ int main(void) } .fi .SH AVAILABILITY -If HTTP is enabled +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK if HTTP is enabled, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_COOKIEFILE.3 b/core/curl/files/CURLOPT_COOKIEFILE.3 index 2dda7a01..2046febc 100644 --- a/core/curl/files/CURLOPT_COOKIEFILE.3 +++ b/core/curl/files/CURLOPT_COOKIEFILE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_COOKIEFILE.md -.TH CURLOPT_COOKIEFILE 3 "2024-06-01" libcurl +.TH CURLOPT_COOKIEFILE 3 "2024-07-29" libcurl .SH NAME CURLOPT_COOKIEFILE \- filename to read cookies from .SH SYNOPSIS @@ -46,7 +46,7 @@ run. .SH DEFAULT NULL .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -69,7 +69,7 @@ int main(void) The cookie file format and general cookie concepts in curl are described online here: https://curl.se/docs/http\-cookies.html .SH AVAILABILITY -As long as HTTP is supported +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_COOKIEJAR.3 b/core/curl/files/CURLOPT_COOKIEJAR.3 index ee4a2d5e..1e51d45e 100644 --- a/core/curl/files/CURLOPT_COOKIEJAR.3 +++ b/core/curl/files/CURLOPT_COOKIEJAR.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_COOKIEJAR.md -.TH CURLOPT_COOKIEJAR 3 "2024-06-01" libcurl +.TH CURLOPT_COOKIEJAR 3 "2024-07-29" libcurl .SH NAME CURLOPT_COOKIEJAR \- filename to store cookies to .SH SYNOPSIS @@ -34,7 +34,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -55,7 +55,7 @@ int main(void) } .fi .SH AVAILABILITY -Along with HTTP +Added in curl 7.9 .SH RETURN VALUE Returns CURLE_OK if HTTP is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_COOKIELIST.3 b/core/curl/files/CURLOPT_COOKIELIST.3 index 0d4bea29..56f51df7 100644 --- a/core/curl/files/CURLOPT_COOKIELIST.3 +++ b/core/curl/files/CURLOPT_COOKIELIST.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_COOKIELIST.md -.TH CURLOPT_COOKIELIST 3 "2024-06-01" libcurl +.TH CURLOPT_COOKIELIST 3 "2024-07-29" libcurl .SH NAME CURLOPT_COOKIELIST \- add to or manipulate cookies held in memory .SH SYNOPSIS @@ -41,7 +41,7 @@ loads all cookies from the files specified by \fICURLOPT_COOKIEFILE(3)\fP .SH DEFAULT NULL .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf /* an inline import of a cookie in Netscape format. */ @@ -87,7 +87,7 @@ int main(void) .SH Cookie file format The cookie file format and general cookie concepts in curl are described online here: https://curl.se/docs/http\-cookies.html -.SH AVAILABILITY +.SH HISTORY \fBALL\fP was added in 7.14.1 \fBSESS\fP was added in 7.15.4 @@ -95,6 +95,8 @@ online here: https://curl.se/docs/http\-cookies.html \fBFLUSH\fP was added in 7.17.1 \fBRELOAD\fP was added in 7.39.0 +.SH AVAILABILITY +Added in curl 7.14.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_COOKIESESSION.3 b/core/curl/files/CURLOPT_COOKIESESSION.3 index 608c0d66..93217fa2 100644 --- a/core/curl/files/CURLOPT_COOKIESESSION.3 +++ b/core/curl/files/CURLOPT_COOKIESESSION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_COOKIESESSION.md -.TH CURLOPT_COOKIESESSION 3 "2024-06-01" libcurl +.TH CURLOPT_COOKIESESSION 3 "2024-07-29" libcurl .SH NAME CURLOPT_COOKIESESSION \- start a new cookie session .SH SYNOPSIS @@ -22,7 +22,7 @@ the same session. .SH DEFAULT 0 .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -45,7 +45,7 @@ int main(void) } .fi .SH AVAILABILITY -Along with HTTP +Added in curl 7.9.7 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_COPYPOSTFIELDS.3 b/core/curl/files/CURLOPT_COPYPOSTFIELDS.3 index 17fa16b5..8e568bc3 100644 --- a/core/curl/files/CURLOPT_COPYPOSTFIELDS.3 +++ b/core/curl/files/CURLOPT_COPYPOSTFIELDS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_COPYPOSTFIELDS.md -.TH CURLOPT_COPYPOSTFIELDS 3 "2024-06-01" libcurl +.TH CURLOPT_COPYPOSTFIELDS 3 "2024-07-29" libcurl .SH NAME CURLOPT_COPYPOSTFIELDS \- have libcurl copy data to POST .SH SYNOPSIS @@ -25,7 +25,7 @@ copy. In any case, the size must not be changed after .SH DEFAULT NULL .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -46,7 +46,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.17.1 +Added in curl 7.17.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_CRLF.3 b/core/curl/files/CURLOPT_CRLF.3 index 950faf37..25e73d8b 100644 --- a/core/curl/files/CURLOPT_CRLF.3 +++ b/core/curl/files/CURLOPT_CRLF.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_CRLF.md -.TH CURLOPT_CRLF 3 "2024-06-01" libcurl +.TH CURLOPT_CRLF 3 "2024-07-29" libcurl .SH NAME CURLOPT_CRLF \- CRLF conversion .SH SYNOPSIS @@ -17,7 +17,7 @@ This is a legacy option of questionable use. .SH DEFAULT 0 .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -33,7 +33,7 @@ int main(void) } .fi .SH AVAILABILITY -SMTP since 7.40.0, other protocols since they were introduced +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_CRLFILE.3 b/core/curl/files/CURLOPT_CRLFILE.3 index 5d164edf..7ddbc950 100644 --- a/core/curl/files/CURLOPT_CRLFILE.3 +++ b/core/curl/files/CURLOPT_CRLFILE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_CRLFILE.md -.TH CURLOPT_CRLFILE 3 "2024-06-01" libcurl +.TH CURLOPT_CRLFILE 3 "2024-07-29" libcurl .SH NAME CURLOPT_CRLFILE \- Certificate Revocation List file .SH SYNOPSIS @@ -35,7 +35,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS, OpenSSL and mbedTLS @@ -54,7 +54,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.19.0 +Added in curl 7.19.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_CURLU.3 b/core/curl/files/CURLOPT_CURLU.3 index 6fe416bc..40b43cd0 100644 --- a/core/curl/files/CURLOPT_CURLU.3 +++ b/core/curl/files/CURLOPT_CURLU.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_CURLU.md -.TH CURLOPT_CURLU 3 "2024-06-01" libcurl +.TH CURLOPT_CURLU 3 "2024-07-29" libcurl .SH NAME CURLOPT_CURLU \- URL in URL handle format .SH SYNOPSIS @@ -21,9 +21,9 @@ contents. An application can update the contents of the URL handle after a transfer is done and if the same handle is used in a subsequent request the updated contents is used. .SH DEFAULT -The default value of this parameter is NULL. +NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -45,7 +45,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.63.0. +Added in curl 7.63.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_CUSTOMREQUEST.3 b/core/curl/files/CURLOPT_CUSTOMREQUEST.3 index 4914d80a..f9178615 100644 --- a/core/curl/files/CURLOPT_CUSTOMREQUEST.3 +++ b/core/curl/files/CURLOPT_CUSTOMREQUEST.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_CUSTOMREQUEST.md -.TH CURLOPT_CUSTOMREQUEST 3 "2024-06-01" libcurl +.TH CURLOPT_CUSTOMREQUEST 3 "2024-07-29" libcurl .SH NAME CURLOPT_CUSTOMREQUEST \- custom request method .SH SYNOPSIS @@ -62,13 +62,10 @@ Normally a multi line response is returned which can be used, in conjunction with \fICURLOPT_MAIL_RCPT(3)\fP, to specify an EXPN request. If the \fICURLOPT_NOBODY(3)\fP option is specified then the request can be used to issue \fBNOOP\fP and \fBRSET\fP commands. - -The application does not have to keep the string around after setting this -option. .SH DEFAULT NULL .SH PROTOCOLS -FTP, HTTP, IMAP, POP3 and SMTP +This functionality affects ftp, http, imap, pop3 and smtp .SH EXAMPLE .nf int main(void) @@ -88,7 +85,7 @@ int main(void) } .fi .SH AVAILABILITY -IMAP is supported since 7.30.0, POP3 since 7.26.0 and SMTP since 7.34.0. +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_DEBUGDATA.3 b/core/curl/files/CURLOPT_DEBUGDATA.3 index bfd5295e..1f7306d8 100644 --- a/core/curl/files/CURLOPT_DEBUGDATA.3 +++ b/core/curl/files/CURLOPT_DEBUGDATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_DEBUGDATA.md -.TH CURLOPT_DEBUGDATA 3 "2024-06-01" libcurl +.TH CURLOPT_DEBUGDATA 3 "2024-07-29" libcurl .SH NAME CURLOPT_DEBUGDATA \- pointer passed to the debug callback .SH SYNOPSIS @@ -15,7 +15,7 @@ not used by libcurl, it is only passed to the callback. .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf struct data { @@ -57,7 +57,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.9.6 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_DEBUGFUNCTION.3 b/core/curl/files/CURLOPT_DEBUGFUNCTION.3 index 73b86de4..d8d1cf45 100644 --- a/core/curl/files/CURLOPT_DEBUGFUNCTION.3 +++ b/core/curl/files/CURLOPT_DEBUGFUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_DEBUGFUNCTION.md -.TH CURLOPT_DEBUGFUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_DEBUGFUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_DEBUGFUNCTION \- debug callback .SH SYNOPSIS @@ -57,16 +57,16 @@ The data is protocol data sent to the peer. The data is SSL/TLS (binary) data sent to the peer. .IP CURLINFO_SSL_DATA_IN The data is SSL/TLS (binary) data received from the peer. +.PP +WARNING: This callback may be called with the curl \fIhandle\fP set to an internal +handle. (Added in 8.4.0) -WARNING: This callback may be called with the curl \fIhandle\fP set to an -internal handle. (Added in 8.4.0) - -If you need to distinguish your curl \fIhandle\fP from internal handles then -set \fICURLOPT_PRIVATE(3)\fP on your handle. +If you need to distinguish your curl \fIhandle\fP from internal handles then set +\fICURLOPT_PRIVATE(3)\fP on your handle. .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf static @@ -170,7 +170,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.9.6 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_DEFAULT_PROTOCOL.3 b/core/curl/files/CURLOPT_DEFAULT_PROTOCOL.3 index a1a28692..0995e4e3 100644 --- a/core/curl/files/CURLOPT_DEFAULT_PROTOCOL.3 +++ b/core/curl/files/CURLOPT_DEFAULT_PROTOCOL.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_DEFAULT_PROTOCOL.md -.TH CURLOPT_DEFAULT_PROTOCOL 3 "2024-06-01" libcurl +.TH CURLOPT_DEFAULT_PROTOCOL 3 "2024-07-29" libcurl .SH NAME CURLOPT_DEFAULT_PROTOCOL \- default protocol to use if the URL is missing a scheme name @@ -36,7 +36,7 @@ option. .SH DEFAULT NULL (make a guess based on the host) .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -55,7 +55,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.45.0 +Added in curl 7.45.0 .SH RETURN VALUE CURLE_OK if the option is supported. diff --git a/core/curl/files/CURLOPT_DIRLISTONLY.3 b/core/curl/files/CURLOPT_DIRLISTONLY.3 index bf0ce832..9fbbb847 100644 --- a/core/curl/files/CURLOPT_DIRLISTONLY.3 +++ b/core/curl/files/CURLOPT_DIRLISTONLY.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_DIRLISTONLY.md -.TH CURLOPT_DIRLISTONLY 3 "2024-06-01" libcurl +.TH CURLOPT_DIRLISTONLY 3 "2024-07-29" libcurl .SH NAME CURLOPT_DIRLISTONLY \- ask for names only in a directory listing .SH SYNOPSIS @@ -33,7 +33,7 @@ effectively breaks that feature. .SH DEFAULT 0, disabled .SH PROTOCOLS -FTP, POP3 and SFTP +This functionality affects ftp, pop3 and sftp .SH EXAMPLE .nf int main(void) @@ -52,9 +52,11 @@ int main(void) } } .fi -.SH AVAILABILITY +.SH HISTORY This option was known as CURLOPT_FTPLISTONLY up to 7.16.4. POP3 is supported since 7.21.5. +.SH AVAILABILITY +Added in curl 7.17.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_DISALLOW_USERNAME_IN_URL.3 b/core/curl/files/CURLOPT_DISALLOW_USERNAME_IN_URL.3 index 836626e8..2284bddc 100644 --- a/core/curl/files/CURLOPT_DISALLOW_USERNAME_IN_URL.3 +++ b/core/curl/files/CURLOPT_DISALLOW_USERNAME_IN_URL.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_DISALLOW_USERNAME_IN_URL.md -.TH CURLOPT_DISALLOW_USERNAME_IN_URL 3 "2024-06-01" libcurl +.TH CURLOPT_DISALLOW_USERNAME_IN_URL 3 "2024-07-29" libcurl .SH NAME CURLOPT_DISALLOW_USERNAME_IN_URL \- disallow specifying username in the URL .SH SYNOPSIS @@ -16,9 +16,9 @@ username. This is the equivalent to the \fICURLU_DISALLOW_USER\fP flag for the \fIcurl_url_set(3)\fP function. .SH DEFAULT -0 (disabled) \- usernames are allowed by default. +0 (disabled) .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -34,14 +34,14 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.61.0 +Added in curl 7.61.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. \fIcurl_easy_perform(3)\fP returns CURLE_LOGIN_DENIED if this option is enabled and a URL containing a username is specified. .SH SEE ALSO -.BR CURLOPT_PROTOCOLS (3), +.BR CURLOPT_PROTOCOLS_STR (3), .BR CURLOPT_URL (3), .BR curl_url_set (3), .BR libcurl-security (3) diff --git a/core/curl/files/CURLOPT_DNS_CACHE_TIMEOUT.3 b/core/curl/files/CURLOPT_DNS_CACHE_TIMEOUT.3 index 51688c20..54e61641 100644 --- a/core/curl/files/CURLOPT_DNS_CACHE_TIMEOUT.3 +++ b/core/curl/files/CURLOPT_DNS_CACHE_TIMEOUT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_DNS_CACHE_TIMEOUT.md -.TH CURLOPT_DNS_CACHE_TIMEOUT 3 "2024-06-01" libcurl +.TH CURLOPT_DNS_CACHE_TIMEOUT 3 "2024-07-29" libcurl .SH NAME CURLOPT_DNS_CACHE_TIMEOUT \- life\-time for DNS cache entries .SH SYNOPSIS @@ -33,7 +33,7 @@ Since version 8.1.0, libcurl prunes entries from the DNS cache if it exceeds .SH DEFAULT 60 .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -57,7 +57,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.9.3 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_DNS_INTERFACE.3 b/core/curl/files/CURLOPT_DNS_INTERFACE.3 index a8106ca4..fc07416c 100644 --- a/core/curl/files/CURLOPT_DNS_INTERFACE.3 +++ b/core/curl/files/CURLOPT_DNS_INTERFACE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_DNS_INTERFACE.md -.TH CURLOPT_DNS_INTERFACE 3 "2024-06-01" libcurl +.TH CURLOPT_DNS_INTERFACE 3 "2024-07-29" libcurl .SH NAME CURLOPT_DNS_INTERFACE \- interface to speak DNS over .SH SYNOPSIS @@ -19,7 +19,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -34,10 +34,11 @@ int main(void) } } .fi +.SH NOTES +This option requires that libcurl was built with a resolver backend that +supports this operation. The c\-ares backend is the only such one. .SH AVAILABILITY -Added in 7.33.0. This option also requires that libcurl was built with a -resolver backend that supports this operation. The c\-ares backend is the only -such one. +Added in curl 7.33.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_NOT_BUILT_IN if support was disabled at compile\-time. diff --git a/core/curl/files/CURLOPT_DNS_LOCAL_IP4.3 b/core/curl/files/CURLOPT_DNS_LOCAL_IP4.3 index 72c86264..059994c6 100644 --- a/core/curl/files/CURLOPT_DNS_LOCAL_IP4.3 +++ b/core/curl/files/CURLOPT_DNS_LOCAL_IP4.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_DNS_LOCAL_IP4.md -.TH CURLOPT_DNS_LOCAL_IP4 3 "2024-06-01" libcurl +.TH CURLOPT_DNS_LOCAL_IP4 3 "2024-07-29" libcurl .SH NAME CURLOPT_DNS_LOCAL_IP4 \- IPv4 address to bind DNS resolves to .SH SYNOPSIS @@ -19,7 +19,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -34,11 +34,11 @@ int main(void) } } .fi -.SH AVAILABILITY +.SH NOTES This option requires that libcurl was built with a resolver backend that supports this operation. The c\-ares backend is the only such one. - -Added in 7.33.0 +.SH AVAILABILITY +Added in curl 7.33.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, CURLE_NOT_BUILT_IN if support was disabled at compile\-time, or diff --git a/core/curl/files/CURLOPT_DNS_LOCAL_IP6.3 b/core/curl/files/CURLOPT_DNS_LOCAL_IP6.3 index 8abe0243..d3d7fa71 100644 --- a/core/curl/files/CURLOPT_DNS_LOCAL_IP6.3 +++ b/core/curl/files/CURLOPT_DNS_LOCAL_IP6.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_DNS_LOCAL_IP6.md -.TH CURLOPT_DNS_LOCAL_IP6 3 "2024-06-01" libcurl +.TH CURLOPT_DNS_LOCAL_IP6 3 "2024-07-29" libcurl .SH NAME CURLOPT_DNS_LOCAL_IP6 \- IPv6 address to bind DNS resolves to .SH SYNOPSIS @@ -19,7 +19,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -34,11 +34,11 @@ int main(void) } } .fi -.SH AVAILABILITY +.SH NOTES This option requires that libcurl was built with a resolver backend that supports this operation. The c\-ares backend is the only such one. - -Added in 7.33.0 +.SH AVAILABILITY +Added in curl 7.33.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, CURLE_NOT_BUILT_IN if support was disabled at compile\-time, or diff --git a/core/curl/files/CURLOPT_DNS_SERVERS.3 b/core/curl/files/CURLOPT_DNS_SERVERS.3 index 2c198db0..60613974 100644 --- a/core/curl/files/CURLOPT_DNS_SERVERS.3 +++ b/core/curl/files/CURLOPT_DNS_SERVERS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_DNS_SERVERS.md -.TH CURLOPT_DNS_SERVERS 3 "2024-06-01" libcurl +.TH CURLOPT_DNS_SERVERS 3 "2024-07-29" libcurl .SH NAME CURLOPT_DNS_SERVERS \- DNS servers to use .SH SYNOPSIS @@ -21,9 +21,9 @@ For example: The application does not have to keep the string around after setting this option. .SH DEFAULT -NULL \- use system default +NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -39,11 +39,11 @@ int main(void) } } .fi -.SH AVAILABILITY +.SH NOTES This option requires that libcurl was built with a resolver backend that supports this operation. The c\-ares backend is the only such one. - -Added in 7.24.0 +.SH AVAILABILITY +Added in curl 7.24.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, CURLE_NOT_BUILT_IN if support was disabled at compile\-time, diff --git a/core/curl/files/CURLOPT_DNS_SHUFFLE_ADDRESSES.3 b/core/curl/files/CURLOPT_DNS_SHUFFLE_ADDRESSES.3 index 7475e2ba..d0b0ea72 100644 --- a/core/curl/files/CURLOPT_DNS_SHUFFLE_ADDRESSES.3 +++ b/core/curl/files/CURLOPT_DNS_SHUFFLE_ADDRESSES.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_DNS_SHUFFLE_ADDRESSES.md -.TH CURLOPT_DNS_SHUFFLE_ADDRESSES 3 "2024-06-01" libcurl +.TH CURLOPT_DNS_SHUFFLE_ADDRESSES 3 "2024-07-29" libcurl .SH NAME CURLOPT_DNS_SHUFFLE_ADDRESSES \- shuffle IP addresses for hostname .SH SYNOPSIS @@ -28,7 +28,7 @@ performance impacts and may cause IPv4 to be used before IPv6 or vice versa. .SH DEFAULT 0 (disabled) .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -46,7 +46,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.60.0 +Added in curl 7.60.0 .SH RETURN VALUE CURLE_OK or an error such as CURLE_UNKNOWN_OPTION. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_DNS_USE_GLOBAL_CACHE.3 b/core/curl/files/CURLOPT_DNS_USE_GLOBAL_CACHE.3 index 0b311825..afe50946 100644 --- a/core/curl/files/CURLOPT_DNS_USE_GLOBAL_CACHE.3 +++ b/core/curl/files/CURLOPT_DNS_USE_GLOBAL_CACHE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_DNS_USE_GLOBAL_CACHE.md -.TH CURLOPT_DNS_USE_GLOBAL_CACHE 3 "2024-06-01" libcurl +.TH CURLOPT_DNS_USE_GLOBAL_CACHE 3 "2024-07-29" libcurl .SH NAME CURLOPT_DNS_USE_GLOBAL_CACHE \- global DNS cache .SH SYNOPSIS @@ -21,7 +21,7 @@ cache between transfers. .SH DEFAULT 0 .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -38,8 +38,10 @@ int main(void) } .fi +.SH DEPRECATED +Deprecated since 7.11.1. Functionality removed in 7.62.0. .SH AVAILABILITY -Deprecated since 7.11.1. Function removed in 7.62.0. +Added in curl 7.9.3 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_DOH_SSL_VERIFYHOST.3 b/core/curl/files/CURLOPT_DOH_SSL_VERIFYHOST.3 index 8b7b7e18..1629244a 100644 --- a/core/curl/files/CURLOPT_DOH_SSL_VERIFYHOST.3 +++ b/core/curl/files/CURLOPT_DOH_SSL_VERIFYHOST.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_DOH_SSL_VERIFYHOST.md -.TH CURLOPT_DOH_SSL_VERIFYHOST 3 "2024-06-01" libcurl +.TH CURLOPT_DOH_SSL_VERIFYHOST 3 "2024-07-29" libcurl .SH NAME CURLOPT_DOH_SSL_VERIFYHOST \- verify the hostname in the DoH SSL certificate .SH SYNOPSIS @@ -36,7 +36,7 @@ of the DoH server certificate. .SH DEFAULT 2 .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. All TLS backends support this option. .SH EXAMPLE @@ -58,9 +58,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.76.0 - -If built TLS enabled. +Added in curl 7.76.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_DOH_SSL_VERIFYPEER.3 b/core/curl/files/CURLOPT_DOH_SSL_VERIFYPEER.3 index 4645b48a..1a8af02f 100644 --- a/core/curl/files/CURLOPT_DOH_SSL_VERIFYPEER.3 +++ b/core/curl/files/CURLOPT_DOH_SSL_VERIFYPEER.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_DOH_SSL_VERIFYPEER.md -.TH CURLOPT_DOH_SSL_VERIFYPEER 3 "2024-06-01" libcurl +.TH CURLOPT_DOH_SSL_VERIFYPEER 3 "2024-07-29" libcurl .SH NAME CURLOPT_DOH_SSL_VERIFYPEER \- verify the DoH SSL certificate .SH SYNOPSIS @@ -46,7 +46,7 @@ the correct end\-point. .SH DEFAULT 1 .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. All TLS backends support this option. .SH EXAMPLE @@ -68,9 +68,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.76.0 - -If built TLS enabled. +Added in curl 7.76.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_DOH_SSL_VERIFYSTATUS.3 b/core/curl/files/CURLOPT_DOH_SSL_VERIFYSTATUS.3 index 66e68944..ae264012 100644 --- a/core/curl/files/CURLOPT_DOH_SSL_VERIFYSTATUS.3 +++ b/core/curl/files/CURLOPT_DOH_SSL_VERIFYSTATUS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_DOH_SSL_VERIFYSTATUS.md -.TH CURLOPT_DOH_SSL_VERIFYSTATUS 3 "2024-06-01" libcurl +.TH CURLOPT_DOH_SSL_VERIFYSTATUS 3 "2024-07-29" libcurl .SH NAME CURLOPT_DOH_SSL_VERIFYSTATUS \- verify the DoH SSL certificate\(aqs status .SH SYNOPSIS @@ -24,7 +24,7 @@ the verification fails. .SH DEFAULT 0 .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS and OpenSSL @@ -47,7 +47,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.76.0. +Added in curl 7.76.0 .SH RETURN VALUE Returns CURLE_OK if OCSP stapling is supported by the SSL backend, otherwise returns CURLE_NOT_BUILT_IN. diff --git a/core/curl/files/CURLOPT_DOH_URL.3 b/core/curl/files/CURLOPT_DOH_URL.3 index cf8b2842..8dce4a57 100644 --- a/core/curl/files/CURLOPT_DOH_URL.3 +++ b/core/curl/files/CURLOPT_DOH_URL.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_DOH_URL.md -.TH CURLOPT_DOH_URL 3 "2024-06-01" libcurl +.TH CURLOPT_DOH_URL 3 "2024-07-29" libcurl .SH NAME CURLOPT_DOH_URL \- provide the DNS\-over\-HTTPS URL .SH SYNOPSIS @@ -40,10 +40,9 @@ mechanism. This includes name resolves done for \fICURLOPT_INTERFACE(3)\fP, \fICURLOPT_FTPPORT(3)\fP, a proxy type set to \fBCURLPROXY_SOCKS4\fP or \fBCURLPROXY_SOCKS5\fP and probably some more. .SH DEFAULT -NULL \- there is no default DoH URL. If this option is not set, libcurl uses -the default name resolver. +NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -57,7 +56,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.62.0 +Added in curl 7.62.0 .SH RETURN VALUE Returns CURLE_OK on success or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_ECH.3 b/core/curl/files/CURLOPT_ECH.3 index 050cba6d..abe722d0 100644 --- a/core/curl/files/CURLOPT_ECH.3 +++ b/core/curl/files/CURLOPT_ECH.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_ECH.md -.TH CURLOPT_ECH 3 "2024-06-01" libcurl +.TH CURLOPT_ECH 3 "2024-07-29" libcurl .SH NAME CURLOPT_ECH \- configuration for Encrypted Client Hello .SH SYNOPSIS @@ -29,7 +29,7 @@ is attempted but fails.) Instructs client to attempt ECH, if possible, but to not fail if attempting ECH is not possible. .IP hard -Instructs client to attempt ECH and fail if if attempting ECH is not possible. +Instructs client to attempt ECH and fail if attempting ECH is not possible. .IP ecl:\ If the string starts with \fIecl:\fP then the remainder of the string should be a base64\-encoded ECHConfigList that is used for ECH rather than attempting to @@ -41,7 +41,7 @@ ECHConfigList that is used for ECH. .SH DEFAULT NULL, meaning ECH is disabled. .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: OpenSSL and wolfSSL @@ -56,7 +56,7 @@ if(curl) { } .fi .SH AVAILABILITY -Added in 8.8.0 +Added in curl 8.8.0 .SH RETURN VALUE Returns CURLE_OK on success or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_EGDSOCKET.3 b/core/curl/files/CURLOPT_EGDSOCKET.3 index 63ffb5f0..a3f40183 100644 --- a/core/curl/files/CURLOPT_EGDSOCKET.3 +++ b/core/curl/files/CURLOPT_EGDSOCKET.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_EGDSOCKET.md -.TH CURLOPT_EGDSOCKET 3 "2024-06-01" libcurl +.TH CURLOPT_EGDSOCKET 3 "2024-07-29" libcurl .SH NAME CURLOPT_EGDSOCKET \- EGD socket path .SH SYNOPSIS @@ -12,8 +12,10 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_EGDSOCKET, char *path); Deprecated option. It serves no purpose anymore. .SH DEFAULT NULL -.SH AVAILABILITY +.SH DEPRECATED This option was deprecated in 7.84.0. +.SH AVAILABILITY +Added in curl 7.7 .SH RETURN VALUE Returns CURLE_OK. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_ERRORBUFFER.3 b/core/curl/files/CURLOPT_ERRORBUFFER.3 index a26ce02d..30c1b2f7 100644 --- a/core/curl/files/CURLOPT_ERRORBUFFER.3 +++ b/core/curl/files/CURLOPT_ERRORBUFFER.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_ERRORBUFFER.md -.TH CURLOPT_ERRORBUFFER 3 "2024-06-01" libcurl +.TH CURLOPT_ERRORBUFFER 3 "2024-07-29" libcurl .SH NAME CURLOPT_ERRORBUFFER \- error buffer for error messages .SH SYNOPSIS @@ -29,7 +29,7 @@ debug and trace why errors happen. .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf #include /* for strlen() */ @@ -68,7 +68,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_EXPECT_100_TIMEOUT_MS.3 b/core/curl/files/CURLOPT_EXPECT_100_TIMEOUT_MS.3 index eaaecc8a..c6ff3519 100644 --- a/core/curl/files/CURLOPT_EXPECT_100_TIMEOUT_MS.3 +++ b/core/curl/files/CURLOPT_EXPECT_100_TIMEOUT_MS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_EXPECT_100_TIMEOUT_MS.md -.TH CURLOPT_EXPECT_100_TIMEOUT_MS 3 "2024-06-01" libcurl +.TH CURLOPT_EXPECT_100_TIMEOUT_MS 3 "2024-07-29" libcurl .SH NAME CURLOPT_EXPECT_100_TIMEOUT_MS \- timeout for Expect: 100\-continue response .SH SYNOPSIS @@ -18,7 +18,7 @@ sent anyway. .SH DEFAULT 1000 milliseconds .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -35,7 +35,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.36.0 +Added in curl 7.36.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_FAILONERROR.3 b/core/curl/files/CURLOPT_FAILONERROR.3 index c0bbffb8..c2c1bfbe 100644 --- a/core/curl/files/CURLOPT_FAILONERROR.3 +++ b/core/curl/files/CURLOPT_FAILONERROR.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_FAILONERROR.md -.TH CURLOPT_FAILONERROR 3 "2024-06-01" libcurl +.TH CURLOPT_FAILONERROR 3 "2024-07-29" libcurl .SH NAME CURLOPT_FAILONERROR \- request failure on HTTP response >= 400 .SH SYNOPSIS @@ -26,7 +26,7 @@ get closed and \fICURLE_HTTP_RETURNED_ERROR\fP is returned. .SH DEFAULT 0, do not fail on error .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -44,7 +44,7 @@ int main(void) } .fi .SH AVAILABILITY -Along with HTTP. +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK if HTTP is enabled, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_FILETIME.3 b/core/curl/files/CURLOPT_FILETIME.3 index 26aa8c79..5af95575 100644 --- a/core/curl/files/CURLOPT_FILETIME.3 +++ b/core/curl/files/CURLOPT_FILETIME.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_FILETIME.md -.TH CURLOPT_FILETIME 3 "2024-06-01" libcurl +.TH CURLOPT_FILETIME 3 "2024-07-29" libcurl .SH NAME CURLOPT_FILETIME \- get the modification time of the remote resource .SH SYNOPSIS @@ -17,7 +17,7 @@ transfer to extract the received time (if any). .SH DEFAULT 0 .SH PROTOCOLS -FILE, FTP, HTTP, SFTP and SMB +This functionality affects file, ftp, http, sftp and smb .SH EXAMPLE .nf int main(void) @@ -43,7 +43,7 @@ int main(void) } .fi .SH AVAILABILITY -Always, for SFTP since 7.49.0 +Added in curl 7.5 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_FNMATCH_DATA.3 b/core/curl/files/CURLOPT_FNMATCH_DATA.3 index f348952d..346b5895 100644 --- a/core/curl/files/CURLOPT_FNMATCH_DATA.3 +++ b/core/curl/files/CURLOPT_FNMATCH_DATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_FNMATCH_DATA.md -.TH CURLOPT_FNMATCH_DATA 3 "2024-06-01" libcurl +.TH CURLOPT_FNMATCH_DATA 3 "2024-07-29" libcurl .SH NAME CURLOPT_FNMATCH_DATA \- pointer passed to the fnmatch callback .SH SYNOPSIS @@ -15,7 +15,7 @@ the \fICURLOPT_FNMATCH_FUNCTION(3)\fP. .SH DEFAULT NULL .SH PROTOCOLS -FTP +This functionality affects ftp only .SH EXAMPLE .nf extern int string_match(const char *s1, const char *s2); @@ -51,7 +51,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.21.0 +Added in curl 7.21.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_FNMATCH_FUNCTION.3 b/core/curl/files/CURLOPT_FNMATCH_FUNCTION.3 index 06d72a00..9b583ee6 100644 --- a/core/curl/files/CURLOPT_FNMATCH_FUNCTION.3 +++ b/core/curl/files/CURLOPT_FNMATCH_FUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_FNMATCH_FUNCTION.md -.TH CURLOPT_FNMATCH_FUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_FNMATCH_FUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_FNMATCH_FUNCTION \- wildcard match callback .SH SYNOPSIS @@ -25,7 +25,7 @@ error occurred. .SH DEFAULT NULL == an internal function for wildcard matching. .SH PROTOCOLS -FTP +This functionality affects ftp only .SH EXAMPLE .nf extern int string_match(const char *s1, const char *s2); @@ -58,7 +58,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.21.0 +Added in curl 7.21.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_FOLLOWLOCATION.3 b/core/curl/files/CURLOPT_FOLLOWLOCATION.3 index 92e160f0..eafe7579 100644 --- a/core/curl/files/CURLOPT_FOLLOWLOCATION.3 +++ b/core/curl/files/CURLOPT_FOLLOWLOCATION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_FOLLOWLOCATION.md -.TH CURLOPT_FOLLOWLOCATION 3 "2024-06-01" libcurl +.TH CURLOPT_FOLLOWLOCATION 3 "2024-07-29" libcurl .SH NAME CURLOPT_FOLLOWLOCATION \- follow HTTP 3xx redirects .SH SYNOPSIS @@ -19,7 +19,7 @@ maximum limit is reached. \fICURLOPT_MAXREDIRS(3)\fP is used to limit the number of redirects libcurl follows. libcurl restricts what protocols it automatically follow redirects to. The -accepted target protocols are set with \fICURLOPT_REDIR_PROTOCOLS(3)\fP. By +accepted target protocols are set with \fICURLOPT_REDIR_PROTOCOLS_STR(3)\fP. By default libcurl allows HTTP, HTTPS, FTP and FTPS on redirects. When following a redirect, the specific 30x response code also dictates which @@ -42,7 +42,7 @@ would otherwise select internally. .SH DEFAULT 0, disabled .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -59,12 +59,12 @@ int main(void) } .fi .SH AVAILABILITY -Along with HTTP +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO .BR CURLINFO_REDIRECT_COUNT (3), .BR CURLINFO_REDIRECT_URL (3), .BR CURLOPT_POSTREDIR (3), -.BR CURLOPT_PROTOCOLS (3), -.BR CURLOPT_REDIR_PROTOCOLS (3) +.BR CURLOPT_PROTOCOLS_STR (3), +.BR CURLOPT_REDIR_PROTOCOLS_STR (3) diff --git a/core/curl/files/CURLOPT_FORBID_REUSE.3 b/core/curl/files/CURLOPT_FORBID_REUSE.3 index 1dda0e96..5520f66c 100644 --- a/core/curl/files/CURLOPT_FORBID_REUSE.3 +++ b/core/curl/files/CURLOPT_FORBID_REUSE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_FORBID_REUSE.md -.TH CURLOPT_FORBID_REUSE 3 "2024-06-01" libcurl +.TH CURLOPT_FORBID_REUSE 3 "2024-07-29" libcurl .SH NAME CURLOPT_FORBID_REUSE \- make connection get closed at once after use .SH SYNOPSIS @@ -20,7 +20,7 @@ Set to 0 to have libcurl keep the connection open for possible later reuse .SH DEFAULT 0 .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -39,7 +39,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.7 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_FRESH_CONNECT.3 b/core/curl/files/CURLOPT_FRESH_CONNECT.3 index 0aa5eadb..dae343df 100644 --- a/core/curl/files/CURLOPT_FRESH_CONNECT.3 +++ b/core/curl/files/CURLOPT_FRESH_CONNECT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_FRESH_CONNECT.md -.TH CURLOPT_FRESH_CONNECT 3 "2024-06-01" libcurl +.TH CURLOPT_FRESH_CONNECT 3 "2024-07-29" libcurl .SH NAME CURLOPT_FRESH_CONNECT \- force a new connection to be used .SH SYNOPSIS @@ -22,7 +22,7 @@ Set \fIfresh\fP to 0 to have libcurl attempt reusing an existing connection .SH DEFAULT 0 .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -38,7 +38,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.7 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_FTPPORT.3 b/core/curl/files/CURLOPT_FTPPORT.3 index b4ba5dd9..9f84c6bd 100644 --- a/core/curl/files/CURLOPT_FTPPORT.3 +++ b/core/curl/files/CURLOPT_FTPPORT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_FTPPORT.md -.TH CURLOPT_FTPPORT 3 "2024-06-01" libcurl +.TH CURLOPT_FTPPORT 3 "2024-07-29" libcurl .SH NAME CURLOPT_FTPPORT \- make FTP transfer active .SH SYNOPSIS @@ -52,7 +52,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -FTP +This functionality affects ftp only .SH EXAMPLE .nf int main(void) @@ -69,7 +69,7 @@ int main(void) } .fi .SH AVAILABILITY -Port range support was added in 7.19.5 +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_FTPSSLAUTH.3 b/core/curl/files/CURLOPT_FTPSSLAUTH.3 index 51a5404b..66a51ca2 100644 --- a/core/curl/files/CURLOPT_FTPSSLAUTH.3 +++ b/core/curl/files/CURLOPT_FTPSSLAUTH.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_FTPSSLAUTH.md -.TH CURLOPT_FTPSSLAUTH 3 "2024-06-01" libcurl +.TH CURLOPT_FTPSSLAUTH 3 "2024-07-29" libcurl .SH NAME CURLOPT_FTPSSLAUTH \- order in which to attempt TLS vs SSL .SH SYNOPSIS @@ -23,7 +23,7 @@ Try "AUTH TLS" first, and only if that fails try "AUTH SSL". .SH DEFAULT CURLFTPAUTH_DEFAULT .SH PROTOCOLS -FTP +This functionality affects ftp only .SH EXAMPLE .nf int main(void) @@ -41,7 +41,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.12.2 +Added in curl 7.12.2 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_FTP_ACCOUNT.3 b/core/curl/files/CURLOPT_FTP_ACCOUNT.3 index 1621f44c..36e23146 100644 --- a/core/curl/files/CURLOPT_FTP_ACCOUNT.3 +++ b/core/curl/files/CURLOPT_FTP_ACCOUNT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_FTP_ACCOUNT.md -.TH CURLOPT_FTP_ACCOUNT 3 "2024-06-01" libcurl +.TH CURLOPT_FTP_ACCOUNT 3 "2024-07-29" libcurl .SH NAME CURLOPT_FTP_ACCOUNT \- account info for FTP .SH SYNOPSIS @@ -18,7 +18,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -FTP +This functionality affects ftp only .SH EXAMPLE .nf int main(void) @@ -37,7 +37,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.13.0 +Added in curl 7.13.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_FTP_ALTERNATIVE_TO_USER.3 b/core/curl/files/CURLOPT_FTP_ALTERNATIVE_TO_USER.3 index 36b889df..c51ea5e1 100644 --- a/core/curl/files/CURLOPT_FTP_ALTERNATIVE_TO_USER.3 +++ b/core/curl/files/CURLOPT_FTP_ALTERNATIVE_TO_USER.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_FTP_ALTERNATIVE_TO_USER.md -.TH CURLOPT_FTP_ALTERNATIVE_TO_USER 3 "2024-06-01" libcurl +.TH CURLOPT_FTP_ALTERNATIVE_TO_USER 3 "2024-07-29" libcurl .SH NAME CURLOPT_FTP_ALTERNATIVE_TO_USER \- command to use instead of USER with FTP .SH SYNOPSIS @@ -21,7 +21,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -FTP +This functionality affects ftp only .SH EXAMPLE .nf int main(void) @@ -38,7 +38,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.15.5 +Added in curl 7.15.5 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_FTP_CREATE_MISSING_DIRS.3 b/core/curl/files/CURLOPT_FTP_CREATE_MISSING_DIRS.3 index efb1734a..6deabfc5 100644 --- a/core/curl/files/CURLOPT_FTP_CREATE_MISSING_DIRS.3 +++ b/core/curl/files/CURLOPT_FTP_CREATE_MISSING_DIRS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_FTP_CREATE_MISSING_DIRS.md -.TH CURLOPT_FTP_CREATE_MISSING_DIRS 3 "2024-06-01" libcurl +.TH CURLOPT_FTP_CREATE_MISSING_DIRS 3 "2024-07-29" libcurl .SH NAME CURLOPT_FTP_CREATE_MISSING_DIRS \- create missing directories for FTP and SFTP .SH SYNOPSIS @@ -37,7 +37,7 @@ but then another connection does \fBMKD\fP before this connection and thus .SH DEFAULT CURLFTP_CREATE_DIR_NONE (0) .SH PROTOCOLS -FTP +This functionality affects ftp only .SH EXAMPLE .nf int main(void) @@ -57,8 +57,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.10.7. SFTP support added in 7.16.3. The retry option was added in -7.19.4. +Added in curl 7.10.7 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if the create value is not. diff --git a/core/curl/files/CURLOPT_FTP_FILEMETHOD.3 b/core/curl/files/CURLOPT_FTP_FILEMETHOD.3 index 2b730669..719de7c7 100644 --- a/core/curl/files/CURLOPT_FTP_FILEMETHOD.3 +++ b/core/curl/files/CURLOPT_FTP_FILEMETHOD.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_FTP_FILEMETHOD.md -.TH CURLOPT_FTP_FILEMETHOD 3 "2024-06-01" libcurl +.TH CURLOPT_FTP_FILEMETHOD 3 "2024-07-29" libcurl .SH NAME CURLOPT_FTP_FILEMETHOD \- select directory traversing method for FTP .SH SYNOPSIS @@ -32,7 +32,7 @@ compliant than \(aqnocwd\(aq but without the full penalty of \(aqmulticwd\(aq. .SH DEFAULT CURLFTPMETHOD_MULTICWD .SH PROTOCOLS -FTP +This functionality affects ftp only .SH EXAMPLE .nf int main(void) @@ -51,7 +51,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.15.1 +Added in curl 7.15.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_FTP_SKIP_PASV_IP.3 b/core/curl/files/CURLOPT_FTP_SKIP_PASV_IP.3 index 6845f654..5996c8d2 100644 --- a/core/curl/files/CURLOPT_FTP_SKIP_PASV_IP.3 +++ b/core/curl/files/CURLOPT_FTP_SKIP_PASV_IP.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_FTP_SKIP_PASV_IP.md -.TH CURLOPT_FTP_SKIP_PASV_IP 3 "2024-06-01" libcurl +.TH CURLOPT_FTP_SKIP_PASV_IP 3 "2024-07-29" libcurl .SH NAME CURLOPT_FTP_SKIP_PASV_IP \- ignore the IP address in the PASV response .SH SYNOPSIS @@ -24,7 +24,7 @@ This option has no effect if PORT, EPRT or EPSV is used instead of PASV. .SH DEFAULT 1 since 7.74.0, was 0 before then. .SH PROTOCOLS -FTP +This functionality affects ftp only .SH EXAMPLE .nf int main(void) @@ -43,7 +43,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.14.2 +Added in curl 7.15.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_FTP_SSL_CCC.3 b/core/curl/files/CURLOPT_FTP_SSL_CCC.3 index 7e1e9a82..dd538ac5 100644 --- a/core/curl/files/CURLOPT_FTP_SSL_CCC.3 +++ b/core/curl/files/CURLOPT_FTP_SSL_CCC.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_FTP_SSL_CCC.md -.TH CURLOPT_FTP_SSL_CCC 3 "2024-06-01" libcurl +.TH CURLOPT_FTP_SSL_CCC 3 "2024-07-29" libcurl .SH NAME CURLOPT_FTP_SSL_CCC \- switch off SSL again with FTP after auth .SH SYNOPSIS @@ -24,7 +24,7 @@ Initiate the shutdown and wait for a reply. .SH DEFAULT CURLFTPSSL_CCC_NONE .SH PROTOCOLS -FTP +This functionality affects ftp only .SH EXAMPLE .nf int main(void) @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.16.1 +Added in curl 7.16.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_FTP_USE_EPRT.3 b/core/curl/files/CURLOPT_FTP_USE_EPRT.3 index 329e8e55..64a9e6f3 100644 --- a/core/curl/files/CURLOPT_FTP_USE_EPRT.3 +++ b/core/curl/files/CURLOPT_FTP_USE_EPRT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_FTP_USE_EPRT.md -.TH CURLOPT_FTP_USE_EPRT 3 "2024-06-01" libcurl +.TH CURLOPT_FTP_USE_EPRT 3 "2024-07-29" libcurl .SH NAME CURLOPT_FTP_USE_EPRT \- use EPRT for FTP .SH SYNOPSIS @@ -24,7 +24,7 @@ If the server is an IPv6 host, this option has no effect as EPRT is necessary then. .SH DEFAULT .SH PROTOCOLS -FTP +This functionality affects ftp only .SH EXAMPLE .nf int main(void) @@ -47,7 +47,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.10.5 +Added in curl 7.10.5 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_FTP_USE_EPSV.3 b/core/curl/files/CURLOPT_FTP_USE_EPSV.3 index 7b90f1ce..864f5912 100644 --- a/core/curl/files/CURLOPT_FTP_USE_EPSV.3 +++ b/core/curl/files/CURLOPT_FTP_USE_EPSV.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_FTP_USE_EPSV.md -.TH CURLOPT_FTP_USE_EPSV 3 "2024-06-01" libcurl +.TH CURLOPT_FTP_USE_EPSV 3 "2024-07-29" libcurl .SH NAME CURLOPT_FTP_USE_EPSV \- use EPSV for FTP .SH SYNOPSIS @@ -23,7 +23,7 @@ If the server is an IPv6 host, this option has no effect. .SH DEFAULT 1 .SH PROTOCOLS -FTP +This functionality affects ftp only .SH EXAMPLE .nf int main(void) @@ -44,7 +44,7 @@ int main(void) } .fi .SH AVAILABILITY -Along with FTP +Added in curl 7.9.2 .SH RETURN VALUE Returns CURLE_OK if FTP is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_FTP_USE_PRET.3 b/core/curl/files/CURLOPT_FTP_USE_PRET.3 index d6aee67d..e78e8da3 100644 --- a/core/curl/files/CURLOPT_FTP_USE_PRET.3 +++ b/core/curl/files/CURLOPT_FTP_USE_PRET.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_FTP_USE_PRET.md -.TH CURLOPT_FTP_USE_PRET 3 "2024-06-01" libcurl +.TH CURLOPT_FTP_USE_PRET 3 "2024-07-29" libcurl .SH NAME CURLOPT_FTP_USE_PRET \- use PRET for FTP .SH SYNOPSIS @@ -16,7 +16,7 @@ no effect when using the active FTP transfers mode. .SH DEFAULT 0 .SH PROTOCOLS -FTP +This functionality affects ftp only .SH EXAMPLE .nf int main(void) @@ -37,7 +37,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.20.0 +Added in curl 7.20.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_GSSAPI_DELEGATION.3 b/core/curl/files/CURLOPT_GSSAPI_DELEGATION.3 index a01ea508..8216ec59 100644 --- a/core/curl/files/CURLOPT_GSSAPI_DELEGATION.3 +++ b/core/curl/files/CURLOPT_GSSAPI_DELEGATION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_GSSAPI_DELEGATION.md -.TH CURLOPT_GSSAPI_DELEGATION 3 "2024-06-01" libcurl +.TH CURLOPT_GSSAPI_DELEGATION 3 "2024-07-29" libcurl .SH NAME CURLOPT_GSSAPI_DELEGATION \- allowed GSS\-API delegation .SH SYNOPSIS @@ -19,7 +19,7 @@ available at compile\-time. .SH DEFAULT CURLGSSAPI_DELEGATION_NONE .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -36,7 +36,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.22.0 +Added in curl 7.22.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS.3 b/core/curl/files/CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS.3 index e074b587..bab04494 100644 --- a/core/curl/files/CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS.3 +++ b/core/curl/files/CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS.md -.TH CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS 3 "2024-06-01" libcurl +.TH CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS 3 "2024-07-29" libcurl .SH NAME CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS \- head start for IPv6 for happy eyeballs .SH SYNOPSIS @@ -23,7 +23,7 @@ currently defaults to 200 ms. Firefox and Chrome currently default to 300 ms. .SH DEFAULT CURL_HET_DEFAULT (currently defined as 200L) .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -41,7 +41,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.59.0 +Added in curl 7.59.0 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_HAPROXYPROTOCOL.3 b/core/curl/files/CURLOPT_HAPROXYPROTOCOL.3 index 10b569e6..f8bf9a6f 100644 --- a/core/curl/files/CURLOPT_HAPROXYPROTOCOL.3 +++ b/core/curl/files/CURLOPT_HAPROXYPROTOCOL.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HAPROXYPROTOCOL.md -.TH CURLOPT_HAPROXYPROTOCOL 3 "2024-06-01" libcurl +.TH CURLOPT_HAPROXYPROTOCOL 3 "2024-07-29" libcurl .SH NAME CURLOPT_HAPROXYPROTOCOL \- send HAProxy PROXY protocol v1 header .SH SYNOPSIS @@ -21,7 +21,7 @@ Most applications do not need this option. .SH DEFAULT 0, do not send any HAProxy PROXY protocol header .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -36,7 +36,7 @@ int main(void) } .fi .SH AVAILABILITY -Along with HTTP. Added in 7.60.0. +Added in curl 7.60.0 .SH RETURN VALUE Returns CURLE_OK if HTTP is enabled, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_HAPROXY_CLIENT_IP.3 b/core/curl/files/CURLOPT_HAPROXY_CLIENT_IP.3 index 38d8c294..fa3c8f51 100644 --- a/core/curl/files/CURLOPT_HAPROXY_CLIENT_IP.3 +++ b/core/curl/files/CURLOPT_HAPROXY_CLIENT_IP.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HAPROXY_CLIENT_IP.md -.TH CURLOPT_HAPROXY_CLIENT_IP 3 "2024-06-01" libcurl +.TH CURLOPT_HAPROXY_CLIENT_IP 3 "2024-07-29" libcurl .SH NAME CURLOPT_HAPROXY_CLIENT_IP \- set HAProxy PROXY protocol client IP .SH SYNOPSIS @@ -19,7 +19,7 @@ cannot use a specified address. .SH DEFAULT NULL, no HAProxy header is sent .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -34,7 +34,7 @@ int main(void) } .fi .SH AVAILABILITY -Along with HTTP. Added in 8.2.0. +Added in curl 8.2.0 .SH RETURN VALUE Returns CURLE_OK if HTTP is enabled, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_HEADER.3 b/core/curl/files/CURLOPT_HEADER.3 index d376a657..e71e114d 100644 --- a/core/curl/files/CURLOPT_HEADER.3 +++ b/core/curl/files/CURLOPT_HEADER.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HEADER.md -.TH CURLOPT_HEADER 3 "2024-06-01" libcurl +.TH CURLOPT_HEADER 3 "2024-07-29" libcurl .SH NAME CURLOPT_HEADER \- pass headers to the data stream .SH SYNOPSIS @@ -31,7 +31,7 @@ custom HTTP headers! .SH DEFAULT 0 .SH PROTOCOLS -FTP, HTTP, IMAP, POP3 and SMTP +This functionality affects ftp, http, imap, pop3 and smtp .SH EXAMPLE .nf int main(void) @@ -47,7 +47,7 @@ int main(void) } .fi .SH AVAILABILITY -Provided in all libcurl versions. +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_HEADERDATA.3 b/core/curl/files/CURLOPT_HEADERDATA.3 index 651a6b8a..ba195dde 100644 --- a/core/curl/files/CURLOPT_HEADERDATA.3 +++ b/core/curl/files/CURLOPT_HEADERDATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HEADERDATA.md -.TH CURLOPT_HEADERDATA 3 "2024-06-01" libcurl +.TH CURLOPT_HEADERDATA 3 "2024-07-29" libcurl .SH NAME CURLOPT_HEADERDATA \- pointer to pass to header callback .SH SYNOPSIS @@ -24,7 +24,7 @@ this option or you might experience crashes. .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf struct my_info { @@ -59,7 +59,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.10 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_HEADERFUNCTION.3 b/core/curl/files/CURLOPT_HEADERFUNCTION.3 index 8b88d33b..4f39768f 100644 --- a/core/curl/files/CURLOPT_HEADERFUNCTION.3 +++ b/core/curl/files/CURLOPT_HEADERFUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HEADERFUNCTION.md -.TH CURLOPT_HEADERFUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_HEADERFUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_HEADERFUNCTION \- callback that receives header data .SH SYNOPSIS @@ -75,7 +75,7 @@ although strictly they are just continuations of the previous lines. .SH DEFAULT Nothing. .SH PROTOCOLS -FTP, HTTP, IMAP, POP3 and SMTP +This functionality affects ftp, http, imap, pop3 and smtp .SH EXAMPLE .nf static size_t header_callback(char *buffer, size_t size, @@ -99,7 +99,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.7.2 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_HEADEROPT.3 b/core/curl/files/CURLOPT_HEADEROPT.3 index 465a18bc..331a4d5b 100644 --- a/core/curl/files/CURLOPT_HEADEROPT.3 +++ b/core/curl/files/CURLOPT_HEADEROPT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HEADEROPT.md -.TH CURLOPT_HEADEROPT 3 "2024-06-01" libcurl +.TH CURLOPT_HEADEROPT 3 "2024-07-29" libcurl .SH NAME CURLOPT_HEADEROPT \- send HTTP headers to both proxy and host or separately .SH SYNOPSIS @@ -26,7 +26,7 @@ proxy and then \fICURLOPT_HTTPHEADER(3)\fP headers only to the server. .SH DEFAULT CURLHEADER_SEPARATE (changed in 7.42.1, used CURLHEADER_UNIFIED before then) .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -52,7 +52,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.37.0 +Added in curl 7.37.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_HSTS.3 b/core/curl/files/CURLOPT_HSTS.3 index ba0ce62c..64e065ff 100644 --- a/core/curl/files/CURLOPT_HSTS.3 +++ b/core/curl/files/CURLOPT_HSTS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HSTS.md -.TH CURLOPT_HSTS 3 "2024-06-01" libcurl +.TH CURLOPT_HSTS 3 "2024-07-29" libcurl .SH NAME CURLOPT_HSTS \- HSTS cache filename .SH SYNOPSIS @@ -38,7 +38,7 @@ currently no length or size limit. .SH DEFAULT NULL, no filename .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -51,7 +51,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.74.0 +Added in curl 7.74.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_HSTSREADDATA.3 b/core/curl/files/CURLOPT_HSTSREADDATA.3 index 14e08e12..f56bc674 100644 --- a/core/curl/files/CURLOPT_HSTSREADDATA.3 +++ b/core/curl/files/CURLOPT_HSTSREADDATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HSTSREADDATA.md -.TH CURLOPT_HSTSREADDATA 3 "2024-06-01" libcurl +.TH CURLOPT_HSTSREADDATA 3 "2024-07-29" libcurl .SH NAME CURLOPT_HSTSREADDATA \- pointer passed to the HSTS read callback .SH SYNOPSIS @@ -18,7 +18,7 @@ do that. .SH DEFAULT NULL .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf struct MyData { @@ -41,7 +41,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.74.0 +Added in curl 7.74.0 .SH RETURN VALUE This returns CURLE_OK. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_HSTSREADFUNCTION.3 b/core/curl/files/CURLOPT_HSTSREADFUNCTION.3 index 01280af5..2a80f4ec 100644 --- a/core/curl/files/CURLOPT_HSTSREADFUNCTION.3 +++ b/core/curl/files/CURLOPT_HSTSREADFUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HSTSREADFUNCTION.md -.TH CURLOPT_HSTSREADFUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_HSTSREADFUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_HSTSREADFUNCTION \- read callback for HSTS hosts .SH SYNOPSIS @@ -43,7 +43,7 @@ do that. .SH DEFAULT NULL \- no callback. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf struct priv { @@ -75,7 +75,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.74.0 +Added in curl 7.74.0 .SH RETURN VALUE This returns CURLE_OK. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_HSTSWRITEDATA.3 b/core/curl/files/CURLOPT_HSTSWRITEDATA.3 index 0658ac10..909950a0 100644 --- a/core/curl/files/CURLOPT_HSTSWRITEDATA.3 +++ b/core/curl/files/CURLOPT_HSTSWRITEDATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HSTSWRITEDATA.md -.TH CURLOPT_HSTSWRITEDATA 3 "2024-06-01" libcurl +.TH CURLOPT_HSTSWRITEDATA 3 "2024-07-29" libcurl .SH NAME CURLOPT_HSTSWRITEDATA \- pointer passed to the HSTS write callback .SH SYNOPSIS @@ -18,7 +18,7 @@ do that. .SH DEFAULT NULL .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf struct MyData { @@ -41,7 +41,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.74.0 +Added in curl 7.74.0 .SH RETURN VALUE This returns CURLE_OK. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_HSTSWRITEFUNCTION.3 b/core/curl/files/CURLOPT_HSTSWRITEFUNCTION.3 index 9285f69e..b46948b9 100644 --- a/core/curl/files/CURLOPT_HSTSWRITEFUNCTION.3 +++ b/core/curl/files/CURLOPT_HSTSWRITEFUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HSTSWRITEFUNCTION.md -.TH CURLOPT_HSTSWRITEFUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_HSTSWRITEFUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_HSTSWRITEFUNCTION \- write callback for HSTS hosts .SH SYNOPSIS @@ -47,7 +47,7 @@ do that. .SH DEFAULT NULL \- no callback. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf struct priv { @@ -79,7 +79,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.74.0 +Added in curl 7.74.0 .SH RETURN VALUE This returns CURLE_OK. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_HSTS_CTRL.3 b/core/curl/files/CURLOPT_HSTS_CTRL.3 index 80548f3c..bd192b55 100644 --- a/core/curl/files/CURLOPT_HSTS_CTRL.3 +++ b/core/curl/files/CURLOPT_HSTS_CTRL.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HSTS_CTRL.md -.TH CURLOPT_HSTS_CTRL 3 "2024-06-01" libcurl +.TH CURLOPT_HSTS_CTRL 3 "2024-07-29" libcurl .SH NAME CURLOPT_HSTS_CTRL \- control HSTS behavior .SH SYNOPSIS @@ -27,9 +27,9 @@ Enable the in\-memory HSTS cache for this handle. Make the HSTS file (if specified) read\-only \- makes libcurl not save the cache to the file when closing the handle. .SH DEFAULT -0. HSTS is disabled by default. +0 .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.74.0 +Added in curl 7.74.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_HTTP09_ALLOWED.3 b/core/curl/files/CURLOPT_HTTP09_ALLOWED.3 index 2eace7f3..60dea8dc 100644 --- a/core/curl/files/CURLOPT_HTTP09_ALLOWED.3 +++ b/core/curl/files/CURLOPT_HTTP09_ALLOWED.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HTTP09_ALLOWED.md -.TH CURLOPT_HTTP09_ALLOWED 3 "2024-06-01" libcurl +.TH CURLOPT_HTTP09_ALLOWED 3 "2024-07-29" libcurl .SH NAME CURLOPT_HTTP09_ALLOWED \- allow HTTP/0.9 response .SH SYNOPSIS @@ -15,12 +15,9 @@ An HTTP/0.9 response is a server response entirely without headers and only a body. You can connect to lots of random TCP services and still get a response that curl might consider to be HTTP/0.9! .SH DEFAULT -curl allowed HTTP/0.9 responses by default before 7.66.0 - -Since 7.66.0, libcurl requires this option set to 1L to allow HTTP/0.9 -responses. +0 .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -34,8 +31,13 @@ int main(void) } } .fi +.SH HISTORY +curl allowed HTTP/0.9 responses by default before 7.66.0 + +Since 7.66.0, libcurl requires this option set to 1L to allow HTTP/0.9 +responses. .SH AVAILABILITY -Option added in 7.64.0, present along with HTTP. +Added in curl 7.64.0 .SH RETURN VALUE Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_HTTP200ALIASES.3 b/core/curl/files/CURLOPT_HTTP200ALIASES.3 index f46510c7..01625f9b 100644 --- a/core/curl/files/CURLOPT_HTTP200ALIASES.3 +++ b/core/curl/files/CURLOPT_HTTP200ALIASES.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HTTP200ALIASES.md -.TH CURLOPT_HTTP200ALIASES 3 "2024-06-01" libcurl +.TH CURLOPT_HTTP200ALIASES 3 "2024-07-29" libcurl .SH NAME CURLOPT_HTTP200ALIASES \- alternative matches for HTTP 200 OK .SH SYNOPSIS @@ -26,7 +26,7 @@ assumed to match HTTP 1.0 when an alias match. .SH DEFAULT NULL .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -46,7 +46,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.10.3 +Added in curl 7.10.3 .SH RETURN VALUE Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_HTTPAUTH.3 b/core/curl/files/CURLOPT_HTTPAUTH.3 index 1bbe0b3f..f4b09cb7 100644 --- a/core/curl/files/CURLOPT_HTTPAUTH.3 +++ b/core/curl/files/CURLOPT_HTTPAUTH.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HTTPAUTH.md -.TH CURLOPT_HTTPAUTH 3 "2024-06-01" libcurl +.TH CURLOPT_HTTPAUTH 3 "2024-07-29" libcurl .SH NAME CURLOPT_HTTPAUTH \- HTTP server authentication methods to try .SH SYNOPSIS @@ -84,7 +84,7 @@ see \fICURLOPT_AWS_SIGV4(3)\fP. .SH DEFAULT CURLAUTH_BASIC .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -100,9 +100,7 @@ int main(void) } } .fi -.SH AVAILABILITY -Option Added in 7.10.6. - +.SH HISTORY CURLAUTH_DIGEST_IE was added in 7.19.3 CURLAUTH_ONLY was added in 7.21.3 @@ -112,6 +110,8 @@ CURLAUTH_NTLM_WB was added in 7.22.0 CURLAUTH_BEARER was added in 7.61.0 CURLAUTH_AWS_SIGV4 was added in 7.74.0 +.SH AVAILABILITY +Added in curl 7.10.6 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_NOT_BUILT_IN if the bitmask specified no supported authentication diff --git a/core/curl/files/CURLOPT_HTTPGET.3 b/core/curl/files/CURLOPT_HTTPGET.3 index 1d1132aa..ba4ac4ab 100644 --- a/core/curl/files/CURLOPT_HTTPGET.3 +++ b/core/curl/files/CURLOPT_HTTPGET.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HTTPGET.md -.TH CURLOPT_HTTPGET 3 "2024-06-01" libcurl +.TH CURLOPT_HTTPGET 3 "2024-07-29" libcurl .SH NAME CURLOPT_HTTPGET \- ask for an HTTP GET request .SH SYNOPSIS @@ -22,7 +22,7 @@ reset a handle to default method, consider \fIcurl_easy_reset(3)\fP. .SH DEFAULT 0 .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -40,7 +40,7 @@ int main(void) } .fi .SH AVAILABILITY -Along with HTTP +Added in curl 7.8.1 .SH RETURN VALUE Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_HTTPHEADER.3 b/core/curl/files/CURLOPT_HTTPHEADER.3 index 2f33991d..57669621 100644 --- a/core/curl/files/CURLOPT_HTTPHEADER.3 +++ b/core/curl/files/CURLOPT_HTTPHEADER.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HTTPHEADER.md -.TH CURLOPT_HTTPHEADER 3 "2024-06-01" libcurl +.TH CURLOPT_HTTPHEADER 3 "2024-07-29" libcurl .SH NAME CURLOPT_HTTPHEADER \- set of HTTP headers .SH SYNOPSIS @@ -79,10 +79,10 @@ MIME mail is only composed of alternative representations of the same data (i.e.: HTML and plain text), this header must be set to "multipart/alternative". In all cases the value must be of the form "multipart/*" to respect the document structure and may not include the "boundary=" parameter. - +.PP Other specific headers that do not have a libcurl default value but are strongly desired by mail delivery and user agents should also be included. -These are "From:", "To:", "Date:" and "Subject:" among others and their +These are \fIFrom:\fP, \fITo:\fP, \fIDate:\fP and \fISubject:\fP among others and their presence and value is generally checked by anti\-spam utilities. .SH SECURITY CONCERNS By default, this option makes libcurl send the given headers in all HTTP @@ -110,7 +110,7 @@ with the \fICURLOPT_UNRESTRICTED_AUTH(3)\fP option. .SH DEFAULT NULL .SH PROTOCOLS -HTTP, IMAP and SMTP +This functionality affects http, imap and smtp .SH EXAMPLE .nf int main(void) @@ -133,8 +133,10 @@ int main(void) } } .fi +.SH HISTORY +Use for MIME mail added in 7.56.0. .SH AVAILABILITY -As long as HTTP is enabled. Use in MIME mail added in 7.56.0. +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_HTTPPOST.3 b/core/curl/files/CURLOPT_HTTPPOST.3 index 4cfb9db4..eb409cc4 100644 --- a/core/curl/files/CURLOPT_HTTPPOST.3 +++ b/core/curl/files/CURLOPT_HTTPPOST.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HTTPPOST.md -.TH CURLOPT_HTTPPOST 3 "2024-06-01" libcurl +.TH CURLOPT_HTTPPOST 3 "2024-07-29" libcurl .SH NAME CURLOPT_HTTPPOST \- multipart formpost content .SH SYNOPSIS @@ -27,7 +27,7 @@ When setting \fICURLOPT_HTTPPOST(3)\fP, libcurl automatically sets .SH DEFAULT NULL .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -66,8 +66,10 @@ int main(void) curl_formfree(formpost); } .fi +.SH DEPRECATED +Deprecated in 7.56.0. .SH AVAILABILITY -As long as HTTP is enabled. Deprecated in 7.56.0. +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK if HTTP is enabled, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_HTTPPROXYTUNNEL.3 b/core/curl/files/CURLOPT_HTTPPROXYTUNNEL.3 index a710951e..ff665730 100644 --- a/core/curl/files/CURLOPT_HTTPPROXYTUNNEL.3 +++ b/core/curl/files/CURLOPT_HTTPPROXYTUNNEL.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HTTPPROXYTUNNEL.md -.TH CURLOPT_HTTPPROXYTUNNEL 3 "2024-06-01" libcurl +.TH CURLOPT_HTTPPROXYTUNNEL 3 "2024-07-29" libcurl .SH NAME CURLOPT_HTTPPROXYTUNNEL \- tunnel through HTTP proxy .SH SYNOPSIS @@ -30,7 +30,7 @@ rarely works through the proxy anyway). .SH DEFAULT 0 .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -45,7 +45,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.3 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_HTTP_CONTENT_DECODING.3 b/core/curl/files/CURLOPT_HTTP_CONTENT_DECODING.3 index d901668c..8f19f9ac 100644 --- a/core/curl/files/CURLOPT_HTTP_CONTENT_DECODING.3 +++ b/core/curl/files/CURLOPT_HTTP_CONTENT_DECODING.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HTTP_CONTENT_DECODING.md -.TH CURLOPT_HTTP_CONTENT_DECODING 3 "2024-06-01" libcurl +.TH CURLOPT_HTTP_CONTENT_DECODING 3 "2024-07-29" libcurl .SH NAME CURLOPT_HTTP_CONTENT_DECODING \- HTTP content decoding control .SH SYNOPSIS @@ -17,7 +17,7 @@ default content decoding but requires you to use .SH DEFAULT 1 .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -32,7 +32,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.16.2 +Added in curl 7.16.2 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_HTTP_TRANSFER_DECODING.3 b/core/curl/files/CURLOPT_HTTP_TRANSFER_DECODING.3 index 397763ec..b04d9535 100644 --- a/core/curl/files/CURLOPT_HTTP_TRANSFER_DECODING.3 +++ b/core/curl/files/CURLOPT_HTTP_TRANSFER_DECODING.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HTTP_TRANSFER_DECODING.md -.TH CURLOPT_HTTP_TRANSFER_DECODING 3 "2024-06-01" libcurl +.TH CURLOPT_HTTP_TRANSFER_DECODING 3 "2024-07-29" libcurl .SH NAME CURLOPT_HTTP_TRANSFER_DECODING \- HTTP transfer decoding control .SH SYNOPSIS @@ -13,10 +13,13 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HTTP_TRANSFER_DECODING, Pass a long to tell libcurl how to act on transfer decoding. If set to zero, transfer decoding is disabled, if set to 1 it is enabled (default). libcurl does chunked transfer decoding by default unless this option is set to zero. +.SH NOTES +This option does not work with the hyper backend as that always has transfer +decoding enabled. .SH DEFAULT 1 .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -31,8 +34,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.16.2 Does not work with the hyper backend (it always has transfer -decoding enabled). +Added in curl 7.16.2 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_HTTP_VERSION.3 b/core/curl/files/CURLOPT_HTTP_VERSION.3 index 9a63e504..dd273d3a 100644 --- a/core/curl/files/CURLOPT_HTTP_VERSION.3 +++ b/core/curl/files/CURLOPT_HTTP_VERSION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_HTTP_VERSION.md -.TH CURLOPT_HTTP_VERSION 3 "2024-06-01" libcurl +.TH CURLOPT_HTTP_VERSION 3 "2024-07-29" libcurl .SH NAME CURLOPT_HTTP_VERSION \- HTTP protocol version to use .SH SYNOPSIS @@ -53,7 +53,7 @@ Since curl 7.62.0: CURL_HTTP_VERSION_2TLS Before that: CURL_HTTP_VERSION_1_1 .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -72,7 +72,7 @@ int main(void) } .fi .SH AVAILABILITY -Along with HTTP +Added in curl 7.9.1 .SH RETURN VALUE Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_IGNORE_CONTENT_LENGTH.3 b/core/curl/files/CURLOPT_IGNORE_CONTENT_LENGTH.3 index 078aee25..91c6252c 100644 --- a/core/curl/files/CURLOPT_IGNORE_CONTENT_LENGTH.3 +++ b/core/curl/files/CURLOPT_IGNORE_CONTENT_LENGTH.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_IGNORE_CONTENT_LENGTH.md -.TH CURLOPT_IGNORE_CONTENT_LENGTH 3 "2024-06-01" libcurl +.TH CURLOPT_IGNORE_CONTENT_LENGTH 3 "2024-07-29" libcurl .SH NAME CURLOPT_IGNORE_CONTENT_LENGTH \- ignore content length .SH SYNOPSIS @@ -26,7 +26,7 @@ Only use this option if strictly necessary. .SH DEFAULT 0 .SH PROTOCOLS -FTP and HTTP +This functionality affects ftp and http .SH EXAMPLE .nf int main(void) @@ -42,9 +42,13 @@ int main(void) } } .fi +.SH HISTORY +Support for FTP added in 7.46.0. +.SH NOTES +This option is not working for HTTP when libcurl is built to use the hyper +backend. .SH AVAILABILITY -Added in 7.14.1. Support for FTP added in 7.46.0. This option is not working -for HTTP when libcurl is built to use the hyper backend. +Added in curl 7.14.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_INFILESIZE.3 b/core/curl/files/CURLOPT_INFILESIZE.3 index e2012404..61779614 100644 --- a/core/curl/files/CURLOPT_INFILESIZE.3 +++ b/core/curl/files/CURLOPT_INFILESIZE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_INFILESIZE.md -.TH CURLOPT_INFILESIZE 3 "2024-06-01" libcurl +.TH CURLOPT_INFILESIZE 3 "2024-07-29" libcurl .SH NAME CURLOPT_INFILESIZE \- size of the input file to send off .SH SYNOPSIS @@ -31,7 +31,7 @@ and sending a different amount may lead to errors. .SH DEFAULT Unset .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf @@ -54,8 +54,10 @@ int main(void) } } .fi -.SH AVAILABILITY +.SH HISTORY SMTP support added in 7.23.0 +.SH AVAILABILITY +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_INFILESIZE_LARGE.3 b/core/curl/files/CURLOPT_INFILESIZE_LARGE.3 index cff363c8..a2203b59 100644 --- a/core/curl/files/CURLOPT_INFILESIZE_LARGE.3 +++ b/core/curl/files/CURLOPT_INFILESIZE_LARGE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_INFILESIZE_LARGE.md -.TH CURLOPT_INFILESIZE_LARGE 3 "2024-06-01" libcurl +.TH CURLOPT_INFILESIZE_LARGE 3 "2024-07-29" libcurl .SH NAME CURLOPT_INFILESIZE_LARGE \- size of the input file to send off .SH SYNOPSIS @@ -28,7 +28,7 @@ and sending a different amount may lead to errors. .SH DEFAULT Unset .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf #define FILE_SIZE 123456 @@ -50,8 +50,10 @@ int main(void) } } .fi -.SH AVAILABILITY +.SH HISTORY SMTP support added in 7.23.0 +.SH AVAILABILITY +Added in curl 7.11.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_INTERFACE.3 b/core/curl/files/CURLOPT_INTERFACE.3 index d5942e74..4afd0dda 100644 --- a/core/curl/files/CURLOPT_INTERFACE.3 +++ b/core/curl/files/CURLOPT_INTERFACE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_INTERFACE.md -.TH CURLOPT_INTERFACE 3 "2024-06-01" libcurl +.TH CURLOPT_INTERFACE 3 "2024-07-29" libcurl .SH NAME CURLOPT_INTERFACE \- source interface for outgoing traffic .SH SYNOPSIS @@ -11,15 +11,16 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_INTERFACE, char *interface); .SH DESCRIPTION Pass a char pointer as parameter. This sets the \fIinterface\fP name to use as outgoing network interface. The name can be an interface name, an IP address, -or a hostname. +or a hostname. If you prefer one of these, you can use the following special +prefixes: -If the parameter starts with "if!" then it is treated only as an interface -name. If the parameter starts with "host!" it is treated as either an IP -address or a hostname. +* \fIif!\fP \- Interface name +* \fIhost!\fP \- IP address or hostname +* \fIifhost!!\fP \- Interface name and IP address or hostname -If "if!" is specified but the parameter does not match an existing interface, -\fICURLE_INTERFACE_FAILED\fP is returned from the libcurl function used to perform -the transfer. +If \fIif!\fP or \fIifhost!\fP is specified but the parameter does not match an existing +interface, \fICURLE_INTERFACE_FAILED\fP is returned from the libcurl function used +to perform the transfer. libcurl does not support using network interface names for this option on Windows. @@ -34,7 +35,7 @@ option. .SH DEFAULT NULL, use whatever the TCP stack finds suitable .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -52,8 +53,12 @@ int main(void) } } .fi +.SH HISTORY +The \fIif!\fP and \fIhost!\fP syntax was added in 7.24.0. + +The \fIifhost!\fP syntax was added in 8.9.0. .SH AVAILABILITY -The "if!" and "host!" syntax was added in 7.24.0. +Added in curl 7.3 .SH RETURN VALUE Returns CURLE_OK on success or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_INTERLEAVEDATA.3 b/core/curl/files/CURLOPT_INTERLEAVEDATA.3 index c334788c..901266ca 100644 --- a/core/curl/files/CURLOPT_INTERLEAVEDATA.3 +++ b/core/curl/files/CURLOPT_INTERLEAVEDATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_INTERLEAVEDATA.md -.TH CURLOPT_INTERLEAVEDATA 3 "2024-06-01" libcurl +.TH CURLOPT_INTERLEAVEDATA 3 "2024-07-29" libcurl .SH NAME CURLOPT_INTERLEAVEDATA \- pointer passed to RTSP interleave callback .SH SYNOPSIS @@ -16,7 +16,7 @@ anywhere. .SH DEFAULT NULL .SH PROTOCOLS -RTSP +This functionality affects rtsp only .SH EXAMPLE .nf struct local { @@ -43,7 +43,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.20.0 +Added in curl 7.20.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_INTERLEAVEFUNCTION.3 b/core/curl/files/CURLOPT_INTERLEAVEFUNCTION.3 index f91e0de1..2404b39c 100644 --- a/core/curl/files/CURLOPT_INTERLEAVEFUNCTION.3 +++ b/core/curl/files/CURLOPT_INTERLEAVEFUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_INTERLEAVEFUNCTION.md -.TH CURLOPT_INTERLEAVEFUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_INTERLEAVEFUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_INTERLEAVEFUNCTION \- callback for RTSP interleaved data .SH SYNOPSIS @@ -47,7 +47,7 @@ You can also abort the transfer by returning CURL_WRITEFUNC_ERROR. (7.87.0) NULL, the interleave data is then passed to the regular write function: \fICURLOPT_WRITEFUNCTION(3)\fP. .SH PROTOCOLS -RTSP +This functionality affects rtsp only .SH EXAMPLE .nf struct local { @@ -73,7 +73,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.20.0 +Added in curl 7.20.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_IOCTLDATA.3 b/core/curl/files/CURLOPT_IOCTLDATA.3 index bb4fc00d..17960f43 100644 --- a/core/curl/files/CURLOPT_IOCTLDATA.3 +++ b/core/curl/files/CURLOPT_IOCTLDATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_IOCTLDATA.md -.TH CURLOPT_IOCTLDATA 3 "2024-06-01" libcurl +.TH CURLOPT_IOCTLDATA 3 "2024-07-29" libcurl .SH NAME CURLOPT_IOCTLDATA \- pointer passed to I/O callback .SH SYNOPSIS @@ -12,9 +12,9 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_IOCTLDATA, void *pointer); Pass the \fIpointer\fP that is untouched by libcurl and passed as the 3rd argument in the ioctl callback set with \fICURLOPT_IOCTLFUNCTION(3)\fP. .SH DEFAULT -By default, the value of this parameter is NULL. +NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf #include /* for lseek */ @@ -42,8 +42,10 @@ int main(void) } } .fi +.SH DEPRECATED +Deprecated since 7.18.0. .SH AVAILABILITY -Added in 7.12.3. Deprecated since 7.18.0. +Added in curl 7.12.3 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_IOCTLFUNCTION.3 b/core/curl/files/CURLOPT_IOCTLFUNCTION.3 index 62a2d08e..c8d1062d 100644 --- a/core/curl/files/CURLOPT_IOCTLFUNCTION.3 +++ b/core/curl/files/CURLOPT_IOCTLFUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_IOCTLFUNCTION.md -.TH CURLOPT_IOCTLFUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_IOCTLFUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_IOCTLFUNCTION \- callback for I/O operations .SH SYNOPSIS @@ -43,9 +43,9 @@ The \fIclientp\fP argument to the callback is set with the instead to provide seeking! If \fICURLOPT_SEEKFUNCTION(3)\fP is set, this parameter is ignored when seeking. .SH DEFAULT -By default, this parameter is set to NULL. Not used. +NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf #include /* for lseek */ @@ -73,8 +73,10 @@ int main(void) } } .fi +.SH DEPRECATED +Deprecated since 7.18.0. .SH AVAILABILITY -Added in 7.12.3. Deprecated since 7.18.0. +Added in curl 7.12.3 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_IPRESOLVE.3 b/core/curl/files/CURLOPT_IPRESOLVE.3 index 370a0208..628a49ef 100644 --- a/core/curl/files/CURLOPT_IPRESOLVE.3 +++ b/core/curl/files/CURLOPT_IPRESOLVE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_IPRESOLVE.md -.TH CURLOPT_IPRESOLVE 3 "2024-06-01" libcurl +.TH CURLOPT_IPRESOLVE 3 "2024-07-29" libcurl .SH NAME CURLOPT_IPRESOLVE \- IP protocol version to use .SH SYNOPSIS @@ -27,7 +27,7 @@ Uses only IPv6 addresses. .SH DEFAULT CURL_IPRESOLVE_WHATEVER .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -47,7 +47,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.10.8 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_ISSUERCERT.3 b/core/curl/files/CURLOPT_ISSUERCERT.3 index d8a92418..a549687d 100644 --- a/core/curl/files/CURLOPT_ISSUERCERT.3 +++ b/core/curl/files/CURLOPT_ISSUERCERT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_ISSUERCERT.md -.TH CURLOPT_ISSUERCERT 3 "2024-06-01" libcurl +.TH CURLOPT_ISSUERCERT 3 "2024-07-29" libcurl .SH NAME CURLOPT_ISSUERCERT \- issuer SSL certificate filename .SH SYNOPSIS @@ -30,7 +30,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS and OpenSSL @@ -49,7 +49,7 @@ int main(void) } .fi .SH AVAILABILITY -If built TLS enabled +Added in curl 7.19.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_ISSUERCERT_BLOB.3 b/core/curl/files/CURLOPT_ISSUERCERT_BLOB.3 index 4f137783..bb23a30a 100644 --- a/core/curl/files/CURLOPT_ISSUERCERT_BLOB.3 +++ b/core/curl/files/CURLOPT_ISSUERCERT_BLOB.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_ISSUERCERT_BLOB.md -.TH CURLOPT_ISSUERCERT_BLOB 3 "2024-06-01" libcurl +.TH CURLOPT_ISSUERCERT_BLOB 3 "2024-07-29" libcurl .SH NAME CURLOPT_ISSUERCERT_BLOB \- issuer SSL certificate from memory blob .SH SYNOPSIS @@ -36,7 +36,7 @@ expects a filename as input. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: OpenSSL @@ -63,7 +63,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.71.0. This option is supported by the OpenSSL backends. +Added in curl 7.71.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_KEEP_SENDING_ON_ERROR.3 b/core/curl/files/CURLOPT_KEEP_SENDING_ON_ERROR.3 index 76c81808..8c2cf9f5 100644 --- a/core/curl/files/CURLOPT_KEEP_SENDING_ON_ERROR.3 +++ b/core/curl/files/CURLOPT_KEEP_SENDING_ON_ERROR.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_KEEP_SENDING_ON_ERROR.md -.TH CURLOPT_KEEP_SENDING_ON_ERROR 3 "2024-06-01" libcurl +.TH CURLOPT_KEEP_SENDING_ON_ERROR 3 "2024-07-29" libcurl .SH NAME CURLOPT_KEEP_SENDING_ON_ERROR \- keep sending on early HTTP response >= 300 .SH SYNOPSIS @@ -22,7 +22,7 @@ Most applications do not need this option. .SH DEFAULT 0, stop sending on error .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -38,7 +38,7 @@ int main(void) } .fi .SH AVAILABILITY -Along with HTTP. Added in 7.51.0. +Added in curl 7.51.0 .SH RETURN VALUE Returns CURLE_OK if HTTP is enabled, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_KEYPASSWD.3 b/core/curl/files/CURLOPT_KEYPASSWD.3 index 316b01a5..271d3540 100644 --- a/core/curl/files/CURLOPT_KEYPASSWD.3 +++ b/core/curl/files/CURLOPT_KEYPASSWD.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_KEYPASSWD.md -.TH CURLOPT_KEYPASSWD 3 "2024-06-01" libcurl +.TH CURLOPT_KEYPASSWD 3 "2024-07-29" libcurl .SH NAME CURLOPT_KEYPASSWD \- passphrase to private key .SH SYNOPSIS @@ -11,7 +11,7 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_KEYPASSWD, char *pwd); .SH DESCRIPTION Pass a pointer to a null\-terminated string as parameter. It is used as the password required to use the \fICURLOPT_SSLKEY(3)\fP or -\fICURLOPT_SSH_PRIVATE_KEYFILE(3)\fP private key. You never need a pass phrase to +\fICURLOPT_SSH_PRIVATE_KEYFILE(3)\fP private key. You never need a passphrase to load a certificate but you need one to load your private key. The application does not have to keep the string around after setting this @@ -19,7 +19,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: OpenSSL, Schannel, mbedTLS and wolfSSL @@ -39,9 +39,11 @@ int main(void) } } .fi -.SH AVAILABILITY +.SH HISTORY This option was known as CURLOPT_SSLKEYPASSWD up to 7.16.4 and CURLOPT_SSLCERTPASSWD up to 7.9.2. +.SH AVAILABILITY +Added in curl 7.17.0 .SH RETURN VALUE Returns CURLE_OK if TLS enabled, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_KRBLEVEL.3 b/core/curl/files/CURLOPT_KRBLEVEL.3 index 14097a30..e66480d1 100644 --- a/core/curl/files/CURLOPT_KRBLEVEL.3 +++ b/core/curl/files/CURLOPT_KRBLEVEL.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_KRBLEVEL.md -.TH CURLOPT_KRBLEVEL 3 "2024-06-01" libcurl +.TH CURLOPT_KRBLEVEL 3 "2024-07-29" libcurl .SH NAME CURLOPT_KRBLEVEL \- FTP kerberos security level .SH SYNOPSIS @@ -20,7 +20,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -FTP +This functionality affects ftp only .SH EXAMPLE .nf int main(void) @@ -35,8 +35,10 @@ int main(void) } } .fi -.SH AVAILABILITY +.SH HISTORY This option was known as CURLOPT_KRB4LEVEL up to 7.16.3 +.SH AVAILABILITY +Added in curl 7.16.4 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_LOCALPORT.3 b/core/curl/files/CURLOPT_LOCALPORT.3 index 91c1ab71..2ab75763 100644 --- a/core/curl/files/CURLOPT_LOCALPORT.3 +++ b/core/curl/files/CURLOPT_LOCALPORT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_LOCALPORT.md -.TH CURLOPT_LOCALPORT 3 "2024-06-01" libcurl +.TH CURLOPT_LOCALPORT 3 "2024-07-29" libcurl .SH NAME CURLOPT_LOCALPORT \- local port number to use for socket .SH SYNOPSIS @@ -16,7 +16,7 @@ this option is set. Valid port numbers are 1 \- 65535. .SH DEFAULT 0, disabled \- use whatever the system thinks is fine .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -34,7 +34,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.15.2 +Added in curl 7.15.2 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_LOCALPORTRANGE.3 b/core/curl/files/CURLOPT_LOCALPORTRANGE.3 index 95e4f0a8..a26d1079 100644 --- a/core/curl/files/CURLOPT_LOCALPORTRANGE.3 +++ b/core/curl/files/CURLOPT_LOCALPORTRANGE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_LOCALPORTRANGE.md -.TH CURLOPT_LOCALPORTRANGE 3 "2024-06-01" libcurl +.TH CURLOPT_LOCALPORTRANGE 3 "2024-07-29" libcurl .SH NAME CURLOPT_LOCALPORTRANGE \- number of additional local ports to try .SH SYNOPSIS @@ -20,7 +20,7 @@ setup failures. .SH DEFAULT 1 .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -38,7 +38,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.15.2 +Added in curl 7.15.2 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_LOGIN_OPTIONS.3 b/core/curl/files/CURLOPT_LOGIN_OPTIONS.3 index 50ad1933..6ccd8328 100644 --- a/core/curl/files/CURLOPT_LOGIN_OPTIONS.3 +++ b/core/curl/files/CURLOPT_LOGIN_OPTIONS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_LOGIN_OPTIONS.md -.TH CURLOPT_LOGIN_OPTIONS 3 "2024-06-01" libcurl +.TH CURLOPT_LOGIN_OPTIONS 3 "2024-07-29" libcurl .SH NAME CURLOPT_LOGIN_OPTIONS \- login options .SH SYNOPSIS @@ -30,7 +30,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -IMAP, LDAP, POP3 and SMTP +This functionality affects imap, ldap, pop3 and smtp .SH EXAMPLE .nf int main(void) @@ -45,8 +45,10 @@ int main(void) } } .fi +.SH HISTORY +Support for OpenLDAP added in 7.82.0. .SH AVAILABILITY -Added in 7.34.0. Support for OpenLDAP added in 7.82.0. +Added in curl 7.34.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_LOW_SPEED_LIMIT.3 b/core/curl/files/CURLOPT_LOW_SPEED_LIMIT.3 index 6f678020..bfd91ee4 100644 --- a/core/curl/files/CURLOPT_LOW_SPEED_LIMIT.3 +++ b/core/curl/files/CURLOPT_LOW_SPEED_LIMIT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_LOW_SPEED_LIMIT.md -.TH CURLOPT_LOW_SPEED_LIMIT 3 "2024-06-01" libcurl +.TH CURLOPT_LOW_SPEED_LIMIT 3 "2024-07-29" libcurl .SH NAME CURLOPT_LOW_SPEED_LIMIT \- low speed limit in bytes per second .SH SYNOPSIS @@ -17,7 +17,7 @@ slow and abort. .SH DEFAULT 0, disabled .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -39,7 +39,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_LOW_SPEED_TIME.3 b/core/curl/files/CURLOPT_LOW_SPEED_TIME.3 index 9cd10db8..26ccd6fb 100644 --- a/core/curl/files/CURLOPT_LOW_SPEED_TIME.3 +++ b/core/curl/files/CURLOPT_LOW_SPEED_TIME.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_LOW_SPEED_TIME.md -.TH CURLOPT_LOW_SPEED_TIME 3 "2024-06-01" libcurl +.TH CURLOPT_LOW_SPEED_TIME 3 "2024-07-29" libcurl .SH NAME CURLOPT_LOW_SPEED_TIME \- low speed limit time period .SH SYNOPSIS @@ -16,7 +16,7 @@ library to consider it too slow and abort. .SH DEFAULT 0, disabled .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -38,7 +38,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_MAIL_AUTH.3 b/core/curl/files/CURLOPT_MAIL_AUTH.3 index 7b0a8cc1..0606e264 100644 --- a/core/curl/files/CURLOPT_MAIL_AUTH.3 +++ b/core/curl/files/CURLOPT_MAIL_AUTH.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_MAIL_AUTH.md -.TH CURLOPT_MAIL_AUTH 3 "2024-06-01" libcurl +.TH CURLOPT_MAIL_AUTH 3 "2024-07-29" libcurl .SH NAME CURLOPT_MAIL_AUTH \- SMTP authentication address .SH SYNOPSIS @@ -30,7 +30,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -SMTP +This functionality affects smtp only .SH EXAMPLE .nf int main(void) @@ -46,7 +46,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.25.0 +Added in curl 7.25.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_MAIL_FROM.3 b/core/curl/files/CURLOPT_MAIL_FROM.3 index 91baec65..578c9809 100644 --- a/core/curl/files/CURLOPT_MAIL_FROM.3 +++ b/core/curl/files/CURLOPT_MAIL_FROM.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_MAIL_FROM.md -.TH CURLOPT_MAIL_FROM 3 "2024-06-01" libcurl +.TH CURLOPT_MAIL_FROM 3 "2024-07-29" libcurl .SH NAME CURLOPT_MAIL_FROM \- SMTP sender address .SH SYNOPSIS @@ -23,7 +23,7 @@ option. .SH DEFAULT blank .SH PROTOCOLS -SMTP +This functionality affects smtp only .SH EXAMPLE .nf int main(void) @@ -39,7 +39,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.20.0 +Added in curl 7.20.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_MAIL_RCPT.3 b/core/curl/files/CURLOPT_MAIL_RCPT.3 index 0c64e4db..5936c775 100644 --- a/core/curl/files/CURLOPT_MAIL_RCPT.3 +++ b/core/curl/files/CURLOPT_MAIL_RCPT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_MAIL_RCPT.md -.TH CURLOPT_MAIL_RCPT 3 "2024-06-01" libcurl +.TH CURLOPT_MAIL_RCPT 3 "2024-07-29" libcurl .SH NAME CURLOPT_MAIL_RCPT \- list of SMTP mail recipients .SH SYNOPSIS @@ -30,7 +30,7 @@ should be specified using the mailing list name, such as \fIFriends\fP or .SH DEFAULT NULL .SH PROTOCOLS -SMTP +This functionality affects smtp only .SH EXAMPLE .nf int main(void) @@ -50,7 +50,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.20.0. The \fBVRFY\fP and \fBEXPN\fP logic was added in 7.34.0 +Added in curl 7.20.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_MAIL_RCPT_ALLOWFAILS.3 b/core/curl/files/CURLOPT_MAIL_RCPT_ALLOWFAILS.3 index 8cefbaec..2fedb88c 100644 --- a/core/curl/files/CURLOPT_MAIL_RCPT_ALLOWFAILS.3 +++ b/core/curl/files/CURLOPT_MAIL_RCPT_ALLOWFAILS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_MAIL_RCPT_ALLOWFAILS.md -.TH CURLOPT_MAIL_RCPT_ALLOWFAILS 3 "2024-06-01" libcurl +.TH CURLOPT_MAIL_RCPT_ALLOWFAILS 3 "2024-07-29" libcurl .SH NAME CURLOPT_MAIL_RCPT_ALLOWFAILS \- allow RCPT TO command to fail for some recipients .SH SYNOPSIS @@ -26,7 +26,7 @@ RCPT TO command. .SH DEFAULT 0 .SH PROTOCOLS -SMTP +This functionality affects smtp only .SH EXAMPLE .nf int main(void) @@ -49,10 +49,11 @@ int main(void) } } .fi +.SH HISTORY +This option was called CURLOPT_MAIL_RCPT_ALLLOWFAILS (with three instead of +two letter L) before 8.2.0 .SH AVAILABILITY -This option was called CURLOPT_MAIL_RCPT_ALLLOWFAILS before 8.2.0 - -Added in 7.69.0. +Added in curl 8.2.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_MAXAGE_CONN.3 b/core/curl/files/CURLOPT_MAXAGE_CONN.3 index 4a6a049b..16167a5c 100644 --- a/core/curl/files/CURLOPT_MAXAGE_CONN.3 +++ b/core/curl/files/CURLOPT_MAXAGE_CONN.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_MAXAGE_CONN.md -.TH CURLOPT_MAXAGE_CONN 3 "2024-06-01" libcurl +.TH CURLOPT_MAXAGE_CONN 3 "2024-07-29" libcurl .SH NAME CURLOPT_MAXAGE_CONN \- max idle time allowed for reusing a connection .SH SYNOPSIS @@ -21,9 +21,9 @@ and thus trying them is a performance loss and sometimes service loss due to the difficulties to figure out the situation. If a connection is found in the cache that is older than this set \fIage\fP, it is closed instead. .SH DEFAULT -Default maximum age is set to 118 seconds. +118 seconds .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -40,7 +40,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.65.0 +Added in curl 7.65.0 .SH RETURN VALUE Returns CURLE_OK. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_MAXCONNECTS.3 b/core/curl/files/CURLOPT_MAXCONNECTS.3 index a32a4425..3a9f4ff7 100644 --- a/core/curl/files/CURLOPT_MAXCONNECTS.3 +++ b/core/curl/files/CURLOPT_MAXCONNECTS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_MAXCONNECTS.md -.TH CURLOPT_MAXCONNECTS 3 "2024-06-01" libcurl +.TH CURLOPT_MAXCONNECTS 3 "2024-07-29" libcurl .SH NAME CURLOPT_MAXCONNECTS \- maximum connection cache size .SH SYNOPSIS @@ -28,7 +28,7 @@ acknowledged, and you must instead use \fIcurl_multi_setopt(3)\fP and the .SH DEFAULT 5 .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -44,7 +44,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.7 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_MAXFILESIZE.3 b/core/curl/files/CURLOPT_MAXFILESIZE.3 index a9fc4b8e..3a9220af 100644 --- a/core/curl/files/CURLOPT_MAXFILESIZE.3 +++ b/core/curl/files/CURLOPT_MAXFILESIZE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_MAXFILESIZE.md -.TH CURLOPT_MAXFILESIZE 3 "2024-06-01" libcurl +.TH CURLOPT_MAXFILESIZE 3 "2024-07-29" libcurl .SH NAME CURLOPT_MAXFILESIZE \- maximum file size allowed to download .SH SYNOPSIS @@ -26,7 +26,7 @@ threshold. .SH DEFAULT 0, meaning disabled. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.10.8 .SH RETURN VALUE Returns CURLE_OK if the size passed is valid or CURLE_BAD_FUNCTION_ARGUMENT if not. diff --git a/core/curl/files/CURLOPT_MAXFILESIZE_LARGE.3 b/core/curl/files/CURLOPT_MAXFILESIZE_LARGE.3 index 645a9b7e..3e9d1934 100644 --- a/core/curl/files/CURLOPT_MAXFILESIZE_LARGE.3 +++ b/core/curl/files/CURLOPT_MAXFILESIZE_LARGE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_MAXFILESIZE_LARGE.md -.TH CURLOPT_MAXFILESIZE_LARGE 3 "2024-06-01" libcurl +.TH CURLOPT_MAXFILESIZE_LARGE 3 "2024-07-29" libcurl .SH NAME CURLOPT_MAXFILESIZE_LARGE \- maximum file size allowed to download .SH SYNOPSIS @@ -25,7 +25,7 @@ threshold. .SH DEFAULT 0, meaning disabled. .SH PROTOCOLS -FTP, HTTP and MQTT +This functionality affects ftp, http and mqtt .SH EXAMPLE .nf int main(void) @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.11.0 +Added in curl 7.11.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_BAD_FUNCTION_ARGUMENT if the size passed is invalid. diff --git a/core/curl/files/CURLOPT_MAXLIFETIME_CONN.3 b/core/curl/files/CURLOPT_MAXLIFETIME_CONN.3 index 11498967..45f9539f 100644 --- a/core/curl/files/CURLOPT_MAXLIFETIME_CONN.3 +++ b/core/curl/files/CURLOPT_MAXLIFETIME_CONN.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_MAXLIFETIME_CONN.md -.TH CURLOPT_MAXLIFETIME_CONN 3 "2024-06-01" libcurl +.TH CURLOPT_MAXLIFETIME_CONN 3 "2024-07-29" libcurl .SH NAME CURLOPT_MAXLIFETIME_CONN \- max lifetime (since creation) allowed for reusing a connection .SH SYNOPSIS @@ -23,9 +23,9 @@ older than this set \fImaxlifetime\fP, it is instead marked for closure. If set to 0, this behavior is disabled: all connections are eligible for reuse. .SH DEFAULT -Default \fImaxlifetime\fP is 0 seconds (i.e., disabled). +0 seconds (i.e., disabled) .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.80.0 +Added in curl 7.80.0 .SH RETURN VALUE Returns CURLE_OK. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_MAXREDIRS.3 b/core/curl/files/CURLOPT_MAXREDIRS.3 index a6870fa2..6523ed08 100644 --- a/core/curl/files/CURLOPT_MAXREDIRS.3 +++ b/core/curl/files/CURLOPT_MAXREDIRS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_MAXREDIRS.md -.TH CURLOPT_MAXREDIRS 3 "2024-06-01" libcurl +.TH CURLOPT_MAXREDIRS 3 "2024-07-29" libcurl .SH NAME CURLOPT_MAXREDIRS \- maximum number of redirects allowed .SH SYNOPSIS @@ -21,7 +21,7 @@ to get stuck in never\-ending redirect loops. .SH DEFAULT 30 (since 8.3.0), it was previously unlimited. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Along with HTTP +Added in curl 7.5 .SH RETURN VALUE Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_MAX_RECV_SPEED_LARGE.3 b/core/curl/files/CURLOPT_MAX_RECV_SPEED_LARGE.3 index bd0e2613..3fc76ae9 100644 --- a/core/curl/files/CURLOPT_MAX_RECV_SPEED_LARGE.3 +++ b/core/curl/files/CURLOPT_MAX_RECV_SPEED_LARGE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_MAX_RECV_SPEED_LARGE.md -.TH CURLOPT_MAX_RECV_SPEED_LARGE 3 "2024-06-01" libcurl +.TH CURLOPT_MAX_RECV_SPEED_LARGE 3 "2024-07-29" libcurl .SH NAME CURLOPT_MAX_RECV_SPEED_LARGE \- rate limit data download speed .SH SYNOPSIS @@ -24,7 +24,7 @@ This option does not affect transfer speeds done with FILE:// URLs. .SH DEFAULT 0, disabled .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -40,7 +40,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.15.5 +Added in curl 7.15.5 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_MAX_SEND_SPEED_LARGE.3 b/core/curl/files/CURLOPT_MAX_SEND_SPEED_LARGE.3 index d539bbee..105438ad 100644 --- a/core/curl/files/CURLOPT_MAX_SEND_SPEED_LARGE.3 +++ b/core/curl/files/CURLOPT_MAX_SEND_SPEED_LARGE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_MAX_SEND_SPEED_LARGE.md -.TH CURLOPT_MAX_SEND_SPEED_LARGE 3 "2024-06-01" libcurl +.TH CURLOPT_MAX_SEND_SPEED_LARGE 3 "2024-07-29" libcurl .SH NAME CURLOPT_MAX_SEND_SPEED_LARGE \- rate limit data upload speed .SH SYNOPSIS @@ -26,7 +26,7 @@ This option does not affect transfer speeds done with FILE:// URLs. .SH DEFAULT 0, disabled .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -43,7 +43,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.15.5 +Added in curl 7.15.5 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_MIMEPOST.3 b/core/curl/files/CURLOPT_MIMEPOST.3 index b601a6a5..50881b03 100644 --- a/core/curl/files/CURLOPT_MIMEPOST.3 +++ b/core/curl/files/CURLOPT_MIMEPOST.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_MIMEPOST.md -.TH CURLOPT_MIMEPOST 3 "2024-06-01" libcurl +.TH CURLOPT_MIMEPOST 3 "2024-07-29" libcurl .SH NAME CURLOPT_MIMEPOST \- send data from mime structure .SH SYNOPSIS @@ -23,7 +23,7 @@ When setting \fICURLOPT_MIMEPOST(3)\fP to NULL, libcurl resets the request type for HTTP to the default to disable the POST. Typically that would mean it is reset to GET. Instead you should set a desired request method explicitly. .SH PROTOCOLS -HTTP, IMAP and SMTP +This functionality affects http, imap and smtp .SH EXAMPLE .nf int main(void) @@ -52,7 +52,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.56.0 +Added in curl 7.56.0 .SH RETURN VALUE This returns CURLE_OK. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_MIME_OPTIONS.3 b/core/curl/files/CURLOPT_MIME_OPTIONS.3 index 6471ab12..90d43289 100644 --- a/core/curl/files/CURLOPT_MIME_OPTIONS.3 +++ b/core/curl/files/CURLOPT_MIME_OPTIONS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_MIME_OPTIONS.md -.TH CURLOPT_MIME_OPTIONS 3 "2024-06-01" libcurl +.TH CURLOPT_MIME_OPTIONS 3 "2024-07-29" libcurl .SH NAME CURLOPT_MIME_OPTIONS \- set MIME option flags .SH SYNOPSIS @@ -34,7 +34,7 @@ containing multipart form is sent, this is normally transmitted as .SH DEFAULT 0, meaning disabled. .SH PROTOCOLS -HTTP, IMAP and SMTP +This functionality affects http, imap and smtp .SH EXAMPLE .nf int main(void) @@ -66,7 +66,7 @@ int main(void) } .fi .SH AVAILABILITY -Option added in 7.81.0. +Added in curl 7.81.0 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_NETRC.3 b/core/curl/files/CURLOPT_NETRC.3 index 9b5ce9a2..c15bd4a2 100644 --- a/core/curl/files/CURLOPT_NETRC.3 +++ b/core/curl/files/CURLOPT_NETRC.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_NETRC.md -.TH CURLOPT_NETRC 3 "2024-06-01" libcurl +.TH CURLOPT_NETRC 3 "2024-07-29" libcurl .SH NAME CURLOPT_NETRC \- enable use of .netrc .SH SYNOPSIS @@ -13,8 +13,10 @@ This parameter controls the preference \fIlevel\fP of libcurl between using usernames and passwords from your \fI~/.netrc\fP file, relative to usernames and passwords in the URL supplied with \fICURLOPT_URL(3)\fP. -On Windows, libcurl uses the file as \fI%HOME%/_netrc\fP. If \fI%HOME%\fP is -not set on Windows, libcurl falls back to \fI%USERPROFILE%\fP. +On Windows, libcurl primarily checks for \fI.netrc\fP in \fI%HOME%\fP. If \fI%HOME%\fP is +not set on Windows, libcurl falls back to \fI%USERPROFILE%\fP. If the file does +not exist, it falls back to check if there is instead a file named \fI_netrc\fP \- +using an underscore instead of period. You can also tell libcurl a different filename to use with \fICURLOPT_NETRC_FILE(3)\fP. @@ -80,7 +82,7 @@ done with "macdef" that it finds. .SH DEFAULT CURL_NETRC_IGNORED .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -95,7 +97,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_NETRC_FILE.3 b/core/curl/files/CURLOPT_NETRC_FILE.3 index 5bcaa602..bf943fa8 100644 --- a/core/curl/files/CURLOPT_NETRC_FILE.3 +++ b/core/curl/files/CURLOPT_NETRC_FILE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_NETRC_FILE.md -.TH CURLOPT_NETRC_FILE 3 "2024-06-01" libcurl +.TH CURLOPT_NETRC_FILE 3 "2024-07-29" libcurl .SH NAME CURLOPT_NETRC_FILE \- filename to read .netrc info from .SH SYNOPSIS @@ -19,7 +19,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -35,7 +35,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.10.9 +Added in curl 7.11.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_NEW_DIRECTORY_PERMS.3 b/core/curl/files/CURLOPT_NEW_DIRECTORY_PERMS.3 index ea36930a..c14a1438 100644 --- a/core/curl/files/CURLOPT_NEW_DIRECTORY_PERMS.3 +++ b/core/curl/files/CURLOPT_NEW_DIRECTORY_PERMS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_NEW_DIRECTORY_PERMS.md -.TH CURLOPT_NEW_DIRECTORY_PERMS 3 "2024-06-01" libcurl +.TH CURLOPT_NEW_DIRECTORY_PERMS 3 "2024-07-29" libcurl .SH NAME CURLOPT_NEW_DIRECTORY_PERMS \- permissions for remotely created directories .SH SYNOPSIS @@ -17,7 +17,7 @@ this are \fIsftp://\fP, \fIscp://\fP, and \fIfile://\fP. .SH DEFAULT 0755 .SH PROTOCOLS -FILE, SCP and SFTP +This functionality affects file, scp and sftp .SH EXAMPLE .nf int main(void) @@ -34,7 +34,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.16.4 +Added in curl 7.16.4 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_NEW_FILE_PERMS.3 b/core/curl/files/CURLOPT_NEW_FILE_PERMS.3 index b062c0bd..666ac2c2 100644 --- a/core/curl/files/CURLOPT_NEW_FILE_PERMS.3 +++ b/core/curl/files/CURLOPT_NEW_FILE_PERMS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_NEW_FILE_PERMS.md -.TH CURLOPT_NEW_FILE_PERMS 3 "2024-06-01" libcurl +.TH CURLOPT_NEW_FILE_PERMS 3 "2024-07-29" libcurl .SH NAME CURLOPT_NEW_FILE_PERMS \- permissions for remotely created files .SH SYNOPSIS @@ -16,7 +16,7 @@ The only protocols that can use this are \fIsftp://\fP, \fIscp://\fP, and \fIfil .SH DEFAULT 0644 .SH PROTOCOLS -FILE, SCP and SFTP +This functionality affects file, scp and sftp .SH EXAMPLE .nf int main(void) @@ -31,7 +31,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.16.4 +Added in curl 7.16.4 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_NOBODY.3 b/core/curl/files/CURLOPT_NOBODY.3 index 5bf62d67..4f852564 100644 --- a/core/curl/files/CURLOPT_NOBODY.3 +++ b/core/curl/files/CURLOPT_NOBODY.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_NOBODY.md -.TH CURLOPT_NOBODY 3 "2024-06-01" libcurl +.TH CURLOPT_NOBODY 3 "2024-07-29" libcurl .SH NAME CURLOPT_NOBODY \- do the download request without getting the body .SH SYNOPSIS @@ -28,7 +28,7 @@ URL you request). .SH DEFAULT 0, the body is transferred .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -46,7 +46,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_NOPROGRESS.3 b/core/curl/files/CURLOPT_NOPROGRESS.3 index 0f73f1dc..82b4b819 100644 --- a/core/curl/files/CURLOPT_NOPROGRESS.3 +++ b/core/curl/files/CURLOPT_NOPROGRESS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_NOPROGRESS.md -.TH CURLOPT_NOPROGRESS 3 "2024-06-01" libcurl +.TH CURLOPT_NOPROGRESS 3 "2024-07-29" libcurl .SH NAME CURLOPT_NOPROGRESS \- switch off the progress meter .SH SYNOPSIS @@ -16,7 +16,7 @@ getting called. .SH DEFAULT 1, meaning it normally runs without a progress meter. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -34,7 +34,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_NOPROXY.3 b/core/curl/files/CURLOPT_NOPROXY.3 index 649162f7..cc575bea 100644 --- a/core/curl/files/CURLOPT_NOPROXY.3 +++ b/core/curl/files/CURLOPT_NOPROXY.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_NOPROXY.md -.TH CURLOPT_NOPROXY 3 "2024-06-01" libcurl +.TH CURLOPT_NOPROXY 3 "2024-07-29" libcurl .SH NAME CURLOPT_NOPROXY \- disable proxy use for specific hosts .SH SYNOPSIS @@ -39,7 +39,7 @@ the same way. .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -57,7 +57,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.19.4 +Added in curl 7.19.4 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_NOSIGNAL.3 b/core/curl/files/CURLOPT_NOSIGNAL.3 index 32d27d08..cbb0f9e5 100644 --- a/core/curl/files/CURLOPT_NOSIGNAL.3 +++ b/core/curl/files/CURLOPT_NOSIGNAL.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_NOSIGNAL.md -.TH CURLOPT_NOSIGNAL 3 "2024-06-01" libcurl +.TH CURLOPT_NOSIGNAL 3 "2024-07-29" libcurl .SH NAME CURLOPT_NOSIGNAL \- skip all signal handling .SH SYNOPSIS @@ -29,7 +29,7 @@ corner cases when they may still happen, contrary to our desire. .SH DEFAULT 0 .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -48,7 +48,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.10 +Added in curl 7.10 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_OPENSOCKETDATA.3 b/core/curl/files/CURLOPT_OPENSOCKETDATA.3 index 53217fa7..45b2f2c3 100644 --- a/core/curl/files/CURLOPT_OPENSOCKETDATA.3 +++ b/core/curl/files/CURLOPT_OPENSOCKETDATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_OPENSOCKETDATA.md -.TH CURLOPT_OPENSOCKETDATA 3 "2024-06-01" libcurl +.TH CURLOPT_OPENSOCKETDATA 3 "2024-07-29" libcurl .SH NAME CURLOPT_OPENSOCKETDATA \- pointer passed to open socket callback .SH SYNOPSIS @@ -13,9 +13,9 @@ Pass a \fIpointer\fP that is untouched by libcurl and passed as the first argument in the open socket callback set with \fICURLOPT_OPENSOCKETFUNCTION(3)\fP. .SH DEFAULT -The default value of this parameter is NULL. +NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf /* make libcurl use the already established socket 'sockfd' */ @@ -62,7 +62,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.17.1 +Added in curl 7.17.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_OPENSOCKETFUNCTION.3 b/core/curl/files/CURLOPT_OPENSOCKETFUNCTION.3 index da54af96..20cf5fc5 100644 --- a/core/curl/files/CURLOPT_OPENSOCKETFUNCTION.3 +++ b/core/curl/files/CURLOPT_OPENSOCKETFUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_OPENSOCKETFUNCTION.md -.TH CURLOPT_OPENSOCKETFUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_OPENSOCKETFUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_OPENSOCKETFUNCTION \- callback for opening socket .SH SYNOPSIS @@ -51,12 +51,12 @@ If you want to pass in a socket with an already established connection, pass the socket back with this callback and then use \fICURLOPT_SOCKOPTFUNCTION(3)\fP to signal that it already is connected. .SH DEFAULT -The default behavior is the equivalent of this: +The equivalent of this: .nf return socket(addr->family, addr->socktype, addr->protocol); .fi .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf /* make libcurl use the already established socket 'sockfd' */ @@ -102,7 +102,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.17.1. +Added in curl 7.17.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_PASSWORD.3 b/core/curl/files/CURLOPT_PASSWORD.3 index 9ad5e903..23b8ac2d 100644 --- a/core/curl/files/CURLOPT_PASSWORD.3 +++ b/core/curl/files/CURLOPT_PASSWORD.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PASSWORD.md -.TH CURLOPT_PASSWORD 3 "2024-06-01" libcurl +.TH CURLOPT_PASSWORD 3 "2024-07-29" libcurl .SH NAME CURLOPT_PASSWORD \- password to use in authentication .SH SYNOPSIS @@ -20,7 +20,7 @@ option. .SH DEFAULT blank .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -39,7 +39,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.19.1 +Added in curl 7.19.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PATH_AS_IS.3 b/core/curl/files/CURLOPT_PATH_AS_IS.3 index 81dbbb12..c81171a2 100644 --- a/core/curl/files/CURLOPT_PATH_AS_IS.3 +++ b/core/curl/files/CURLOPT_PATH_AS_IS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PATH_AS_IS.md -.TH CURLOPT_PATH_AS_IS 3 "2024-06-01" libcurl +.TH CURLOPT_PATH_AS_IS 3 "2024-07-29" libcurl .SH NAME CURLOPT_PATH_AS_IS \- do not handle dot dot sequences .SH SYNOPSIS @@ -27,7 +27,7 @@ The corresponding flag for the \fIcurl_url_set(3)\fP function is called .SH DEFAULT 0 .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -44,7 +44,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.42.0 +Added in curl 7.42.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_PINNEDPUBLICKEY.3 b/core/curl/files/CURLOPT_PINNEDPUBLICKEY.3 index 534e093d..7ec18862 100644 --- a/core/curl/files/CURLOPT_PINNEDPUBLICKEY.3 +++ b/core/curl/files/CURLOPT_PINNEDPUBLICKEY.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PINNEDPUBLICKEY.md -.TH CURLOPT_PINNEDPUBLICKEY 3 "2024-06-01" libcurl +.TH CURLOPT_PINNEDPUBLICKEY 3 "2024-07-29" libcurl .SH NAME CURLOPT_PINNEDPUBLICKEY \- pinned public key .SH SYNOPSIS @@ -30,7 +30,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS, OpenSSL, Schannel, Secure Transport, mbedTLS and wolfSSL @@ -89,7 +89,7 @@ footer: [BASE 64 DATA] -----END PUBLIC KEY----- .fi -.SH AVAILABILITY +.SH HISTORY .IP "PEM/DER support" 7.39.0: OpenSSL, GnuTLS @@ -110,6 +110,8 @@ footer: 7.58.1: Schannel Other SSL backends not supported. +.SH AVAILABILITY +Added in curl 7.39.0 .SH RETURN VALUE Returns CURLE_OK if TLS enabled, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PIPEWAIT.3 b/core/curl/files/CURLOPT_PIPEWAIT.3 index 370d1234..fae75494 100644 --- a/core/curl/files/CURLOPT_PIPEWAIT.3 +++ b/core/curl/files/CURLOPT_PIPEWAIT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PIPEWAIT.md -.TH CURLOPT_PIPEWAIT 3 "2024-06-01" libcurl +.TH CURLOPT_PIPEWAIT 3 "2024-07-29" libcurl .SH NAME CURLOPT_PIPEWAIT \- wait for multiplexing .SH SYNOPSIS @@ -32,7 +32,7 @@ and support level. .SH DEFAULT 0 (off) .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -47,7 +47,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.43.0 +Added in curl 7.43.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_PORT.3 b/core/curl/files/CURLOPT_PORT.3 index 6910b15c..6fb86cf0 100644 --- a/core/curl/files/CURLOPT_PORT.3 +++ b/core/curl/files/CURLOPT_PORT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PORT.md -.TH CURLOPT_PORT 3 "2024-06-01" libcurl +.TH CURLOPT_PORT 3 "2024-07-29" libcurl .SH NAME CURLOPT_PORT \- remote port number to connect to .SH SYNOPSIS @@ -23,10 +23,10 @@ While this option accepts a \(aqlong\(aq, a port number is an unsigned 16 bit nu and therefore using a port number lower than zero or over 65535 causes a \fBCURLE_BAD_FUNCTION_ARGUMENT\fP error. .SH DEFAULT -By default this is 0 which makes it not used. This also makes port number zero -impossible to set with this API. +0 which makes it not used. This also makes port number zero impossible to set +with this API. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_POST.3 b/core/curl/files/CURLOPT_POST.3 index 3ff25421..f0404558 100644 --- a/core/curl/files/CURLOPT_POST.3 +++ b/core/curl/files/CURLOPT_POST.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_POST.md -.TH CURLOPT_POST 3 "2024-06-01" libcurl +.TH CURLOPT_POST 3 "2024-07-29" libcurl .SH NAME CURLOPT_POST \- make an HTTP POST .SH SYNOPSIS @@ -52,7 +52,7 @@ you should set a new request type explicitly as described above. .SH DEFAULT 0, disabled .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -72,10 +72,10 @@ int main(void) } .fi .SH AVAILABILITY -Along with HTTP +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO .BR CURLOPT_HTTPPOST (3), .BR CURLOPT_POSTFIELDS (3), -.BR CURLOPT_PUT (3) +.BR CURLOPT_UPLOAD (3) diff --git a/core/curl/files/CURLOPT_POSTFIELDS.3 b/core/curl/files/CURLOPT_POSTFIELDS.3 index 6b8bac84..f9301edc 100644 --- a/core/curl/files/CURLOPT_POSTFIELDS.3 +++ b/core/curl/files/CURLOPT_POSTFIELDS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_POSTFIELDS.md -.TH CURLOPT_POSTFIELDS 3 "2024-06-01" libcurl +.TH CURLOPT_POSTFIELDS 3 "2024-07-29" libcurl .SH NAME CURLOPT_POSTFIELDS \- data to POST to server .SH SYNOPSIS @@ -51,7 +51,7 @@ To make \fBmultipart/formdata\fP posts, check out the .SH DEFAULT NULL .SH PROTOCOLS -HTTP and MQTT +This functionality affects http and mqtt .SH EXAMPLE .nf /* send an application/x-www-form-urlencoded POST */ @@ -93,7 +93,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_POSTFIELDSIZE.3 b/core/curl/files/CURLOPT_POSTFIELDSIZE.3 index 0cbc44a3..c0cee63b 100644 --- a/core/curl/files/CURLOPT_POSTFIELDSIZE.3 +++ b/core/curl/files/CURLOPT_POSTFIELDSIZE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_POSTFIELDSIZE.md -.TH CURLOPT_POSTFIELDSIZE 3 "2024-06-01" libcurl +.TH CURLOPT_POSTFIELDSIZE 3 "2024-07-29" libcurl .SH NAME CURLOPT_POSTFIELDSIZE \- size of POST data pointed to .SH SYNOPSIS @@ -19,7 +19,7 @@ If you post more than 2GB, use \fICURLOPT_POSTFIELDSIZE_LARGE(3)\fP. .SH DEFAULT -1 .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf #include /* for strlen */ @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Along with HTTP +Added in curl 7.2 .SH RETURN VALUE Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_POSTFIELDSIZE_LARGE.3 b/core/curl/files/CURLOPT_POSTFIELDSIZE_LARGE.3 index 2f22bec6..d2b3a4fe 100644 --- a/core/curl/files/CURLOPT_POSTFIELDSIZE_LARGE.3 +++ b/core/curl/files/CURLOPT_POSTFIELDSIZE_LARGE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_POSTFIELDSIZE_LARGE.md -.TH CURLOPT_POSTFIELDSIZE_LARGE 3 "2024-06-01" libcurl +.TH CURLOPT_POSTFIELDSIZE_LARGE 3 "2024-07-29" libcurl .SH NAME CURLOPT_POSTFIELDSIZE_LARGE \- size of POST data pointed to .SH SYNOPSIS @@ -18,7 +18,7 @@ this size is set to \-1, libcurl uses strlen() to get the size or relies on the .SH DEFAULT -1 .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf extern char *large_chunk; /* pointer to somewhere */ @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Along with HTTP +Added in curl 7.11.1 .SH RETURN VALUE Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_POSTQUOTE.3 b/core/curl/files/CURLOPT_POSTQUOTE.3 index 52157e4b..00e72676 100644 --- a/core/curl/files/CURLOPT_POSTQUOTE.3 +++ b/core/curl/files/CURLOPT_POSTQUOTE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_POSTQUOTE.md -.TH CURLOPT_POSTQUOTE 3 "2024-06-01" libcurl +.TH CURLOPT_POSTQUOTE 3 "2024-07-29" libcurl .SH NAME CURLOPT_POSTQUOTE \- (S)FTP commands to run after the transfer .SH SYNOPSIS @@ -19,7 +19,7 @@ Disable this operation again by setting a NULL to this option. .SH DEFAULT NULL .SH PROTOCOLS -FTP and SFTP +This functionality affects ftp and sftp .SH EXAMPLE .nf int main(void) @@ -43,7 +43,7 @@ int main(void) } .fi .SH AVAILABILITY -If support for the protocols are built\-in. +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_POSTREDIR.3 b/core/curl/files/CURLOPT_POSTREDIR.3 index e1b44011..698c6a47 100644 --- a/core/curl/files/CURLOPT_POSTREDIR.3 +++ b/core/curl/files/CURLOPT_POSTREDIR.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_POSTREDIR.md -.TH CURLOPT_POSTREDIR 3 "2024-06-01" libcurl +.TH CURLOPT_POSTREDIR 3 "2024-07-29" libcurl .SH NAME CURLOPT_POSTREDIR \- how to act on an HTTP POST redirect .SH SYNOPSIS @@ -27,7 +27,7 @@ when setting \fICURLOPT_FOLLOWLOCATION(3)\fP. .SH DEFAULT 0 .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -47,9 +47,11 @@ int main(void) } } .fi +.SH HISTORY +This option was known as CURLOPT_POST301 up to 7.19.0 as it only supported the +301 then. CURL_REDIR_POST_303 was added in 7.26.0. .SH AVAILABILITY -Added in 7.17.1. This option was known as CURLOPT_POST301 up to 7.19.0 as it -only supported the 301 then. CURL_REDIR_POST_303 was added in 7.26.0. +Added in curl 7.19.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_PREQUOTE.3 b/core/curl/files/CURLOPT_PREQUOTE.3 index db0f42b5..05eaae76 100644 --- a/core/curl/files/CURLOPT_PREQUOTE.3 +++ b/core/curl/files/CURLOPT_PREQUOTE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PREQUOTE.md -.TH CURLOPT_PREQUOTE 3 "2024-06-01" libcurl +.TH CURLOPT_PREQUOTE 3 "2024-07-29" libcurl .SH NAME CURLOPT_PREQUOTE \- commands to run before an FTP transfer .SH SYNOPSIS @@ -24,7 +24,7 @@ this option does not. .SH DEFAULT NULL .SH PROTOCOLS -FTP +This functionality affects ftp only .SH EXAMPLE .nf int main(void) @@ -47,7 +47,7 @@ int main(void) } .fi .SH AVAILABILITY -Along with the protocol support +Added in curl 7.9.5 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_PREREQDATA.3 b/core/curl/files/CURLOPT_PREREQDATA.3 index 025d3d17..d58a7de6 100644 --- a/core/curl/files/CURLOPT_PREREQDATA.3 +++ b/core/curl/files/CURLOPT_PREREQDATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PREREQDATA.md -.TH CURLOPT_PREREQDATA 3 "2024-06-01" libcurl +.TH CURLOPT_PREREQDATA 3 "2024-07-29" libcurl .SH NAME CURLOPT_PREREQDATA \- pointer passed to the pre\-request callback .SH SYNOPSIS @@ -14,7 +14,7 @@ argument in the pre\-request callback set with \fICURLOPT_PREREQFUNCTION(3)\fP. .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf struct priv { @@ -43,7 +43,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.80.0 +Added in curl 7.80.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_PREREQFUNCTION.3 b/core/curl/files/CURLOPT_PREREQFUNCTION.3 index fa67b4bd..a9e18f73 100644 --- a/core/curl/files/CURLOPT_PREREQFUNCTION.3 +++ b/core/curl/files/CURLOPT_PREREQFUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PREREQFUNCTION.md -.TH CURLOPT_PREREQFUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_PREREQFUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_PREREQFUNCTION \- user callback called when a connection has been established, but before a request has been made. @@ -54,9 +54,9 @@ port number depending on the protocol. .IP clientp The pointer you set with \fICURLOPT_PREREQDATA(3)\fP. .SH DEFAULT -By default, this is NULL and unused. +NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf struct priv { @@ -85,7 +85,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.80.0 +Added in curl 7.80.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_PRE_PROXY.3 b/core/curl/files/CURLOPT_PRE_PROXY.3 index 16d11df8..d9adff05 100644 --- a/core/curl/files/CURLOPT_PRE_PROXY.3 +++ b/core/curl/files/CURLOPT_PRE_PROXY.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PRE_PROXY.md -.TH CURLOPT_PRE_PROXY 3 "2024-06-01" libcurl +.TH CURLOPT_PRE_PROXY 3 "2024-07-29" libcurl .SH NAME CURLOPT_PRE_PROXY \- pre\-proxy host to use .SH SYNOPSIS @@ -31,15 +31,15 @@ be used. Otherwise SOCKS4 is used as default. Setting the pre proxy string to "" (an empty string) explicitly disables the use of a pre proxy. +When you set a hostname to use, do not assume that there is any particular +single port number used widely for proxies. Specify it. + The application does not have to keep the string around after setting this option. .SH DEFAULT -Default is NULL, meaning no pre proxy is used. - -When you set a hostname to use, do not assume that there is any particular -single port number used widely for proxies. Specify it! +NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -54,7 +54,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.52.0 +Added in curl 7.52.0 .SH RETURN VALUE Returns CURLE_OK if proxies are supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PRIVATE.3 b/core/curl/files/CURLOPT_PRIVATE.3 index 65acc6bc..a859cb0f 100644 --- a/core/curl/files/CURLOPT_PRIVATE.3 +++ b/core/curl/files/CURLOPT_PRIVATE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PRIVATE.md -.TH CURLOPT_PRIVATE 3 "2024-06-01" libcurl +.TH CURLOPT_PRIVATE 3 "2024-07-29" libcurl .SH NAME CURLOPT_PRIVATE \- store a private pointer .SH SYNOPSIS @@ -16,7 +16,7 @@ never does anything with this data. .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf struct private { @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.10.3 +Added in curl 7.10.3 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_PROGRESSDATA.3 b/core/curl/files/CURLOPT_PROGRESSDATA.3 index 4caea5a1..23dd6b20 100644 --- a/core/curl/files/CURLOPT_PROGRESSDATA.3 +++ b/core/curl/files/CURLOPT_PROGRESSDATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROGRESSDATA.md -.TH CURLOPT_PROGRESSDATA 3 "2024-06-01" libcurl +.TH CURLOPT_PROGRESSDATA 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROGRESSDATA \- pointer passed to the progress callback .SH SYNOPSIS @@ -12,9 +12,9 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROGRESSDATA, void *pointer); Pass a \fIpointer\fP that is untouched by libcurl and passed as the first argument in the progress callback set with \fICURLOPT_PROGRESSFUNCTION(3)\fP. .SH DEFAULT -The default value of this parameter is NULL. +NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf struct progress { @@ -51,7 +51,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_PROGRESSFUNCTION.3 b/core/curl/files/CURLOPT_PROGRESSFUNCTION.3 index 749d9132..5a17182a 100644 --- a/core/curl/files/CURLOPT_PROGRESSFUNCTION.3 +++ b/core/curl/files/CURLOPT_PROGRESSFUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROGRESSFUNCTION.md -.TH CURLOPT_PROGRESSFUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_PROGRESSFUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROGRESSFUNCTION \- progress meter callback .SH SYNOPSIS @@ -55,10 +55,9 @@ that performs transfers. \fICURLOPT_NOPROGRESS(3)\fP must be set to 0 to make this function actually get called. .SH DEFAULT -By default, libcurl has an internal progress meter. That is rarely wanted by -users. +NULL. libcurl has an internal progress meter. That is rarely wanted by users. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf struct progress { @@ -94,8 +93,10 @@ int main(void) } } .fi -.SH AVAILABILITY +.SH DEPRECATED Deprecated since 7.32.0. +.SH AVAILABILITY +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_PROTOCOLS.3 b/core/curl/files/CURLOPT_PROTOCOLS.3 index 11048fb3..c92b7b70 100644 --- a/core/curl/files/CURLOPT_PROTOCOLS.3 +++ b/core/curl/files/CURLOPT_PROTOCOLS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROTOCOLS.md -.TH CURLOPT_PROTOCOLS 3 "2024-06-01" libcurl +.TH CURLOPT_PROTOCOLS 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROTOCOLS \- allowed protocols .SH SYNOPSIS @@ -54,7 +54,7 @@ CURLPROTO_TFTP .SH DEFAULT All protocols built\-in. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(int argc, char **argv) @@ -73,8 +73,10 @@ int main(int argc, char **argv) } } .fi +.SH DEPRECATED +Deprecated since 7.85.0. .SH AVAILABILITY -Added in 7.19.4. Deprecated since 7.85.0. +Added in curl 7.19.4 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_PROTOCOLS_STR.3 b/core/curl/files/CURLOPT_PROTOCOLS_STR.3 index 0bc1fbe1..af84b327 100644 --- a/core/curl/files/CURLOPT_PROTOCOLS_STR.3 +++ b/core/curl/files/CURLOPT_PROTOCOLS_STR.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROTOCOLS_STR.md -.TH CURLOPT_PROTOCOLS_STR 3 "2024-06-01" libcurl +.TH CURLOPT_PROTOCOLS_STR 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROTOCOLS_STR \- allowed protocols .SH SYNOPSIS @@ -35,7 +35,7 @@ way to figure out the protocol used in a previous transfer. .SH DEFAULT All protocols built\-in .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(int argc, char **argv) @@ -54,7 +54,7 @@ int main(int argc, char **argv) } .fi .SH AVAILABILITY -Added in 7.85.0 +Added in curl 7.85.0 .SH RETURN VALUE Returns CURLE_UNKNOWN_OPTION if the option is not implemented, CURLE_UNSUPPORTED_PROTOCOL if a listed protocol is not supported or disabled, diff --git a/core/curl/files/CURLOPT_PROXY.3 b/core/curl/files/CURLOPT_PROXY.3 index a0919bfa..7ef81a67 100644 --- a/core/curl/files/CURLOPT_PROXY.3 +++ b/core/curl/files/CURLOPT_PROXY.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY.md -.TH CURLOPT_PROXY 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY \- proxy to use .SH SYNOPSIS @@ -38,16 +38,15 @@ SOCKS4a Proxy. Proxy resolves URL hostname. SOCKS5 Proxy. .IP socks5h:// SOCKS5 Proxy. Proxy resolves URL hostname. - -Without a scheme prefix, \fICURLOPT_PROXYTYPE(3)\fP can be used to specify -which kind of proxy the string identifies. +.PP +Without a scheme prefix, \fICURLOPT_PROXYTYPE(3)\fP can be used to specify which +kind of proxy the string identifies. When you tell the library to use an HTTP proxy, libcurl transparently converts operations to HTTP even if you specify an FTP URL etc. This may have an impact -on what other features of the library you can use, such as -\fICURLOPT_QUOTE(3)\fP and similar FTP specifics that do not work unless you -tunnel through the HTTP proxy. Such tunneling is activated with -\fICURLOPT_HTTPPROXYTUNNEL(3)\fP. +on what other features of the library you can use, such as \fICURLOPT_QUOTE(3)\fP +and similar FTP specifics that do not work unless you tunnel through the HTTP +proxy. Such tunneling is activated with \fICURLOPT_HTTPPROXYTUNNEL(3)\fP. Setting the proxy string to "" (an empty string) explicitly disables the use of a proxy, even if there is an environment variable set for it. @@ -58,8 +57,8 @@ user + password. Unix domain sockets are supported for socks proxies since 7.84.0. Set localhost for the host part. e.g. socks5h://localhost/path/to/socket.sock -The application does not have to keep the string around after setting this -option. +When you set a hostname to use, do not assume that there is any particular +single port number used widely for proxies. Specify it. When a proxy is used, the active FTP mode as set with \fICUROPT_FTPPORT(3)\fP, cannot be used. @@ -75,12 +74,9 @@ setting the \fICURLOPT_NOPROXY(3)\fP option. The \fICURLOPT_PROXY(3)\fP and \fICURLOPT_NOPROXY(3)\fP options override environment variables. .SH DEFAULT -Default is NULL, meaning no proxy is used. - -When you set a hostname to use, do not assume that there is any particular -single port number used widely for proxies. Specify it! +NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -93,7 +89,7 @@ int main(void) } } .fi -.SH AVAILABILITY +.SH HISTORY Since 7.14.1 the proxy environment variable names can include the protocol scheme. @@ -101,6 +97,8 @@ Since 7.21.7 the proxy string supports the socks protocols as "schemes". Since 7.50.2, unsupported schemes in proxy strings cause libcurl to return error. +.SH AVAILABILITY +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK if proxies are supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PROXYAUTH.3 b/core/curl/files/CURLOPT_PROXYAUTH.3 index 821bb596..f3d59bf5 100644 --- a/core/curl/files/CURLOPT_PROXYAUTH.3 +++ b/core/curl/files/CURLOPT_PROXYAUTH.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXYAUTH.md -.TH CURLOPT_PROXYAUTH 3 "2024-06-01" libcurl +.TH CURLOPT_PROXYAUTH 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXYAUTH \- HTTP proxy authentication methods .SH SYNOPSIS @@ -22,7 +22,7 @@ The bitmask can be constructed by the bits listed and described in the .SH DEFAULT CURLAUTH_BASIC .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -43,7 +43,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.10.7 +Added in curl 7.10.7 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_NOT_BUILT_IN if the bitmask specified no supported authentication diff --git a/core/curl/files/CURLOPT_PROXYHEADER.3 b/core/curl/files/CURLOPT_PROXYHEADER.3 index df6a9871..befa4e1d 100644 --- a/core/curl/files/CURLOPT_PROXYHEADER.3 +++ b/core/curl/files/CURLOPT_PROXYHEADER.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXYHEADER.md -.TH CURLOPT_PROXYHEADER 3 "2024-06-01" libcurl +.TH CURLOPT_PROXYHEADER 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXYHEADER \- set of HTTP headers to pass to proxy .SH SYNOPSIS @@ -26,7 +26,7 @@ Pass a NULL to this to reset back to no custom headers. .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -51,7 +51,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.37.0 +Added in curl 7.37.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_PROXYPASSWORD.3 b/core/curl/files/CURLOPT_PROXYPASSWORD.3 index 8ec3e25e..1a8e3a9a 100644 --- a/core/curl/files/CURLOPT_PROXYPASSWORD.3 +++ b/core/curl/files/CURLOPT_PROXYPASSWORD.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXYPASSWORD.md -.TH CURLOPT_PROXYPASSWORD 3 "2024-06-01" libcurl +.TH CURLOPT_PROXYPASSWORD 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXYPASSWORD \- password to use with proxy authentication .SH SYNOPSIS @@ -20,7 +20,7 @@ option. .SH DEFAULT blank .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -38,7 +38,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.19.1 +Added in curl 7.19.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PROXYPORT.3 b/core/curl/files/CURLOPT_PROXYPORT.3 index 2ec78721..602525ab 100644 --- a/core/curl/files/CURLOPT_PROXYPORT.3 +++ b/core/curl/files/CURLOPT_PROXYPORT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXYPORT.md -.TH CURLOPT_PROXYPORT 3 "2024-06-01" libcurl +.TH CURLOPT_PROXYPORT 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXYPORT \- port number the proxy listens on .SH SYNOPSIS @@ -12,15 +12,19 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXYPORT, long port); We discourage use of this option. Pass a long with this option to set the proxy port to connect to unless it is -specified in the proxy string \fICURLOPT_PROXY(3)\fP or uses 443 for https -proxies and 1080 for all others as default. +specified in the proxy string \fICURLOPT_PROXY(3)\fP or uses 443 for https proxies +and 1080 for all others as default. + +Disabling this option, setting it to zero, makes it not specified which makes +libcurl use the default proxy port number or the port number specified in the +proxy URL string. While this accepts a \(aqlong\(aq, the port number is 16 bit so it cannot be larger than 65535. .SH DEFAULT -0, not specified which makes it use the default port +0 .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -37,7 +41,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_PROXYTYPE.3 b/core/curl/files/CURLOPT_PROXYTYPE.3 index f9bd4900..dad4cda3 100644 --- a/core/curl/files/CURLOPT_PROXYTYPE.3 +++ b/core/curl/files/CURLOPT_PROXYTYPE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXYTYPE.md -.TH CURLOPT_PROXYTYPE 3 "2024-06-01" libcurl +.TH CURLOPT_PROXYTYPE 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXYTYPE \- proxy protocol type .SH SYNOPSIS @@ -30,13 +30,13 @@ SOCKS4a Proxy. Proxy resolves URL hostname. SOCKS5 Proxy. .IP CURLPROXY_SOCKS5_HOSTNAME SOCKS5 Proxy. Proxy resolves URL hostname. - +.PP Often it is more convenient to specify the proxy type with the scheme part of the \fICURLOPT_PROXY(3)\fP string. .SH DEFAULT CURLPROXY_HTTP .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -54,7 +54,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.10 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_PROXYUSERNAME.3 b/core/curl/files/CURLOPT_PROXYUSERNAME.3 index 26fbdb6e..db3fcc44 100644 --- a/core/curl/files/CURLOPT_PROXYUSERNAME.3 +++ b/core/curl/files/CURLOPT_PROXYUSERNAME.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXYUSERNAME.md -.TH CURLOPT_PROXYUSERNAME 3 "2024-06-01" libcurl +.TH CURLOPT_PROXYUSERNAME 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXYUSERNAME \- username to use for proxy authentication .SH SYNOPSIS @@ -23,7 +23,7 @@ option. .SH DEFAULT blank .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -41,7 +41,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.19.1 +Added in curl 7.19.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PROXYUSERPWD.3 b/core/curl/files/CURLOPT_PROXYUSERPWD.3 index 1898f9ca..699217f0 100644 --- a/core/curl/files/CURLOPT_PROXYUSERPWD.3 +++ b/core/curl/files/CURLOPT_PROXYUSERPWD.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXYUSERPWD.md -.TH CURLOPT_PROXYUSERPWD 3 "2024-06-01" libcurl +.TH CURLOPT_PROXYUSERPWD 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXYUSERPWD \- username and password to use for proxy authentication .SH SYNOPSIS @@ -20,9 +20,9 @@ Use \fICURLOPT_PROXYAUTH(3)\fP to specify the authentication method. The application does not have to keep the string around after setting this option. .SH DEFAULT -This is NULL by default. +NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -39,7 +39,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK if proxies are supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PROXY_CAINFO.3 b/core/curl/files/CURLOPT_PROXY_CAINFO.3 index 91653624..28abf454 100644 --- a/core/curl/files/CURLOPT_PROXY_CAINFO.3 +++ b/core/curl/files/CURLOPT_PROXY_CAINFO.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_CAINFO.md -.TH CURLOPT_PROXY_CAINFO 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_CAINFO 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_CAINFO \- path to proxy Certificate Authority (CA) bundle .SH SYNOPSIS @@ -34,7 +34,7 @@ The default value for this can be figured out with \fICURLINFO_CAINFO(3)\fP. .SH DEFAULT Built\-in system specific .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. All TLS backends support this option. .SH EXAMPLE @@ -53,12 +53,12 @@ int main(void) } } .fi -.SH AVAILABILITY -Added in 7.52.0 - +.SH NOTES For TLS backends that do not support certificate files, the \fICURLOPT_PROXY_CAINFO(3)\fP option is ignored. Refer to https://curl.se/docs/ssl\-compared.html +.SH AVAILABILITY +Added in curl 7.52.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PROXY_CAINFO_BLOB.3 b/core/curl/files/CURLOPT_PROXY_CAINFO_BLOB.3 index 9433d555..c8314b89 100644 --- a/core/curl/files/CURLOPT_PROXY_CAINFO_BLOB.3 +++ b/core/curl/files/CURLOPT_PROXY_CAINFO_BLOB.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_CAINFO_BLOB.md -.TH CURLOPT_PROXY_CAINFO_BLOB 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_CAINFO_BLOB 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_CAINFO_BLOB \- proxy Certificate Authority (CA) bundle in PEM format .SH SYNOPSIS @@ -27,7 +27,7 @@ This option overrides \fICURLOPT_PROXY_CAINFO(3)\fP. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: OpenSSL, Schannel, Secure Transport and rustls @@ -55,10 +55,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.77.0. - -This option is supported by the rustls (since 7.82.0), OpenSSL, Secure -Transport and Schannel backends. +Added in curl 7.77.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PROXY_CAPATH.3 b/core/curl/files/CURLOPT_PROXY_CAPATH.3 index c0ae47a1..df79b010 100644 --- a/core/curl/files/CURLOPT_PROXY_CAPATH.3 +++ b/core/curl/files/CURLOPT_PROXY_CAPATH.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_CAPATH.md -.TH CURLOPT_PROXY_CAPATH 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_CAPATH 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_CAPATH \- directory holding HTTPS proxy CA certificates .SH SYNOPSIS @@ -22,7 +22,7 @@ The default value for this can be figured out with \fICURLINFO_CAPATH(3)\fP. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS, OpenSSL and mbedTLS @@ -43,9 +43,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.52.0 - -mbedTLS support added in 7.56.0. +Added in curl 7.52.0 .SH RETURN VALUE CURLE_OK if supported; or an error such as: diff --git a/core/curl/files/CURLOPT_PROXY_CRLFILE.3 b/core/curl/files/CURLOPT_PROXY_CRLFILE.3 index e5377a3d..edc9f8a0 100644 --- a/core/curl/files/CURLOPT_PROXY_CRLFILE.3 +++ b/core/curl/files/CURLOPT_PROXY_CRLFILE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_CRLFILE.md -.TH CURLOPT_PROXY_CRLFILE 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_CRLFILE 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_CRLFILE \- HTTPS proxy Certificate Revocation List file .SH SYNOPSIS @@ -34,7 +34,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS, OpenSSL and mbedTLS @@ -54,7 +54,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.52.0 +Added in curl 7.52.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PROXY_ISSUERCERT.3 b/core/curl/files/CURLOPT_PROXY_ISSUERCERT.3 index 191096e9..71260017 100644 --- a/core/curl/files/CURLOPT_PROXY_ISSUERCERT.3 +++ b/core/curl/files/CURLOPT_PROXY_ISSUERCERT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_ISSUERCERT.md -.TH CURLOPT_PROXY_ISSUERCERT 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_ISSUERCERT 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_ISSUERCERT \- proxy issuer SSL certificate filename .SH SYNOPSIS @@ -31,7 +31,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS and OpenSSL @@ -52,7 +52,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.71.0. This option is supported by the OpenSSL and GnuTLS backends. +Added in curl 7.71.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PROXY_ISSUERCERT_BLOB.3 b/core/curl/files/CURLOPT_PROXY_ISSUERCERT_BLOB.3 index e28d5e43..d8e0eeda 100644 --- a/core/curl/files/CURLOPT_PROXY_ISSUERCERT_BLOB.3 +++ b/core/curl/files/CURLOPT_PROXY_ISSUERCERT_BLOB.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_ISSUERCERT_BLOB.md -.TH CURLOPT_PROXY_ISSUERCERT_BLOB 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_ISSUERCERT_BLOB 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_ISSUERCERT_BLOB \- proxy issuer SSL certificate from memory blob .SH SYNOPSIS @@ -36,7 +36,7 @@ instead expects a filename as input. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: OpenSSL @@ -65,7 +65,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.71.0. This option is supported by the OpenSSL backends. +Added in curl 7.71.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PROXY_KEYPASSWD.3 b/core/curl/files/CURLOPT_PROXY_KEYPASSWD.3 index 58495c5f..118fe76a 100644 --- a/core/curl/files/CURLOPT_PROXY_KEYPASSWD.3 +++ b/core/curl/files/CURLOPT_PROXY_KEYPASSWD.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_KEYPASSWD.md -.TH CURLOPT_PROXY_KEYPASSWD 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_KEYPASSWD 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_KEYPASSWD \- passphrase for the proxy private key .SH SYNOPSIS @@ -12,16 +12,16 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_KEYPASSWD, char *pwd); This option is for connecting to an HTTPS proxy, not an HTTPS server. Pass a pointer to a null\-terminated string as parameter. It is used as the -password required to use the \fICURLOPT_PROXY_SSLKEY(3)\fP private key. You -never need a pass phrase to load a certificate but you need one to load your -private key. +password required to use the \fICURLOPT_PROXY_SSLKEY(3)\fP private key. You never +need a passphrase to load a certificate but you need one to load your private +key. The application does not have to keep the string around after setting this option. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: OpenSSL, Schannel, mbedTLS and wolfSSL @@ -41,7 +41,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.52.0 +Added in curl 7.52.0 .SH RETURN VALUE Returns CURLE_OK if TLS enabled, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PROXY_PINNEDPUBLICKEY.3 b/core/curl/files/CURLOPT_PROXY_PINNEDPUBLICKEY.3 index 4a3933a9..2e77c0e3 100644 --- a/core/curl/files/CURLOPT_PROXY_PINNEDPUBLICKEY.3 +++ b/core/curl/files/CURLOPT_PROXY_PINNEDPUBLICKEY.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_PINNEDPUBLICKEY.md -.TH CURLOPT_PROXY_PINNEDPUBLICKEY 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_PINNEDPUBLICKEY 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_PINNEDPUBLICKEY \- pinned public key for https proxy .SH SYNOPSIS @@ -27,7 +27,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS, OpenSSL, mbedTLS and wolfSSL @@ -83,7 +83,7 @@ footer: [BASE 64 DATA] -----END PUBLIC KEY----- .fi -.SH AVAILABILITY +.SH HISTORY PEM/DER support: 7.52.0: GnuTLS, OpenSSL, mbedTLS, wolfSSL @@ -93,6 +93,8 @@ sha256 support: 7.52.0: GnuTLS, OpenSSL, mbedTLS, wolfSSL Other SSL backends not supported. +.SH AVAILABILITY +Added in curl 7.52.0 .SH RETURN VALUE Returns CURLE_OK if TLS enabled, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PROXY_SERVICE_NAME.3 b/core/curl/files/CURLOPT_PROXY_SERVICE_NAME.3 index d0e0f312..d7b14f2c 100644 --- a/core/curl/files/CURLOPT_PROXY_SERVICE_NAME.3 +++ b/core/curl/files/CURLOPT_PROXY_SERVICE_NAME.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_SERVICE_NAME.md -.TH CURLOPT_PROXY_SERVICE_NAME 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_SERVICE_NAME 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_SERVICE_NAME \- proxy authentication service name .SH SYNOPSIS @@ -19,7 +19,7 @@ option. .SH DEFAULT See above .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -34,7 +34,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.43.0 for HTTP proxies, 7.49.0 for SOCKS5 proxies. +Added in curl 7.43.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PROXY_SSLCERT.3 b/core/curl/files/CURLOPT_PROXY_SSLCERT.3 index 6f9413fa..48cf6362 100644 --- a/core/curl/files/CURLOPT_PROXY_SSLCERT.3 +++ b/core/curl/files/CURLOPT_PROXY_SSLCERT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_SSLCERT.md -.TH CURLOPT_PROXY_SSLCERT 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_SSLCERT 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_SSLCERT \- HTTPS proxy client certificate .SH SYNOPSIS @@ -29,7 +29,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS, OpenSSL, Schannel, Secure Transport, mbedTLS and wolfSSL @@ -51,7 +51,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.52.0 +Added in curl 7.52.0 .SH RETURN VALUE Returns CURLE_OK if TLS enabled, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PROXY_SSLCERTTYPE.3 b/core/curl/files/CURLOPT_PROXY_SSLCERTTYPE.3 index d500146f..ed277624 100644 --- a/core/curl/files/CURLOPT_PROXY_SSLCERTTYPE.3 +++ b/core/curl/files/CURLOPT_PROXY_SSLCERTTYPE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_SSLCERTTYPE.md -.TH CURLOPT_PROXY_SSLCERTTYPE 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_SSLCERTTYPE 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_SSLCERTTYPE \- type of the proxy client SSL certificate .SH SYNOPSIS @@ -22,7 +22,7 @@ option. .SH DEFAULT \&"PEM" .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS, OpenSSL, Schannel, Secure Transport, mbedTLS and wolfSSL @@ -45,9 +45,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.52.0 - -If built TLS enabled. +Added in curl 7.52.0 .SH RETURN VALUE Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PROXY_SSLCERT_BLOB.3 b/core/curl/files/CURLOPT_PROXY_SSLCERT_BLOB.3 index 26f1ce7a..28f310e0 100644 --- a/core/curl/files/CURLOPT_PROXY_SSLCERT_BLOB.3 +++ b/core/curl/files/CURLOPT_PROXY_SSLCERT_BLOB.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_SSLCERT_BLOB.md -.TH CURLOPT_PROXY_SSLCERT_BLOB 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_SSLCERT_BLOB 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_SSLCERT_BLOB \- SSL proxy client certificate from memory blob .SH SYNOPSIS @@ -25,7 +25,7 @@ expects a filename as input. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: OpenSSL, Schannel and Secure Transport @@ -55,7 +55,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.71.0. +Added in curl 7.71.0 .SH RETURN VALUE Returns CURLE_OK if TLS enabled, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PROXY_SSLKEY.3 b/core/curl/files/CURLOPT_PROXY_SSLKEY.3 index 5cc9d3e6..888dfd0b 100644 --- a/core/curl/files/CURLOPT_PROXY_SSLKEY.3 +++ b/core/curl/files/CURLOPT_PROXY_SSLKEY.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_SSLKEY.md -.TH CURLOPT_PROXY_SSLKEY 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_SSLKEY 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_SSLKEY \- private key file for HTTPS proxy client cert .SH SYNOPSIS @@ -23,7 +23,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: OpenSSL, Schannel, mbedTLS and wolfSSL @@ -45,9 +45,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.52.0 - -If built TLS enabled. +Added in curl 7.52.0 .SH RETURN VALUE Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PROXY_SSLKEYTYPE.3 b/core/curl/files/CURLOPT_PROXY_SSLKEYTYPE.3 index 8266742b..215b4c02 100644 --- a/core/curl/files/CURLOPT_PROXY_SSLKEYTYPE.3 +++ b/core/curl/files/CURLOPT_PROXY_SSLKEYTYPE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_SSLKEYTYPE.md -.TH CURLOPT_PROXY_SSLKEYTYPE 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_SSLKEYTYPE 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_SSLKEYTYPE \- type of the proxy private key file .SH SYNOPSIS @@ -17,7 +17,7 @@ the format of your private key. Supported formats are "PEM", "DER" and "ENG". The application does not have to keep the string around after setting this option. .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: BearSSL, OpenSSL and wolfSSL @@ -40,7 +40,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.52.0 +Added in curl 7.52.0 .SH RETURN VALUE Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PROXY_SSLKEY_BLOB.3 b/core/curl/files/CURLOPT_PROXY_SSLKEY_BLOB.3 index 888245e8..eb76c020 100644 --- a/core/curl/files/CURLOPT_PROXY_SSLKEY_BLOB.3 +++ b/core/curl/files/CURLOPT_PROXY_SSLKEY_BLOB.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_SSLKEY_BLOB.md -.TH CURLOPT_PROXY_SSLKEY_BLOB 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_SSLKEY_BLOB 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_SSLKEY_BLOB \- private key for proxy cert from memory blob .SH SYNOPSIS @@ -21,7 +21,7 @@ setting this. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: OpenSSL @@ -58,7 +58,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.71.0. This option is supported by the OpenSSL backends. +Added in curl 7.71.0 .SH RETURN VALUE Returns CURLE_OK if TLS enabled, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PROXY_SSLVERSION.3 b/core/curl/files/CURLOPT_PROXY_SSLVERSION.3 index e6521fb0..53a357d4 100644 --- a/core/curl/files/CURLOPT_PROXY_SSLVERSION.3 +++ b/core/curl/files/CURLOPT_PROXY_SSLVERSION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_SSLVERSION.md -.TH CURLOPT_PROXY_SSLVERSION 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_SSLVERSION 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_SSLVERSION \- preferred HTTPS proxy TLS version .SH SYNOPSIS @@ -27,10 +27,11 @@ TLSv1.1 TLSv1.2 .IP CURL_SSLVERSION_TLSv1_3 TLSv1.3 -The maximum TLS version can be set by using \fIone\fP of the -CURL_SSLVERSION_MAX_ macros below. It is also possible to OR \fIone\fP of the -CURL_SSLVERSION_ macros with \fIone\fP of the CURL_SSLVERSION_MAX_ macros. -The MAX macros are not supported for WolfSSL. +.PP +The maximum TLS version can be set by using \fIone\fP of the CURL_SSLVERSION_MAX_ +macros below. It is also possible to OR \fIone\fP of the CURL_SSLVERSION_ macros +with \fIone\fP of the CURL_SSLVERSION_MAX_ macros. The MAX macros are not +supported for wolfSSL. .IP CURL_SSLVERSION_MAX_DEFAULT The flag defines the maximum supported TLS version as TLSv1.2, or the default value from the SSL library. @@ -47,14 +48,14 @@ The flag defines maximum supported TLS version as TLSv1.2. .IP CURL_SSLVERSION_MAX_TLSv1_3 The flag defines maximum supported TLS version as TLSv1.3. (Added in 7.54.0) - +.PP In versions of curl prior to 7.54 the CURL_SSLVERSION_TLS options were documented to allow \fIonly\fP the specified TLS version, but behavior was inconsistent depending on the TLS library. .SH DEFAULT CURL_SSLVERSION_DEFAULT .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. All TLS backends support this option. .SH EXAMPLE @@ -74,7 +75,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.52.0 +Added in curl 7.52.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_PROXY_SSL_CIPHER_LIST.3 b/core/curl/files/CURLOPT_PROXY_SSL_CIPHER_LIST.3 index 2d82dc50..95c4a5d4 100644 --- a/core/curl/files/CURLOPT_PROXY_SSL_CIPHER_LIST.3 +++ b/core/curl/files/CURLOPT_PROXY_SSL_CIPHER_LIST.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_SSL_CIPHER_LIST.md -.TH CURLOPT_PROXY_SSL_CIPHER_LIST 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_SSL_CIPHER_LIST 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_SSL_CIPHER_LIST \- ciphers to use for HTTPS proxy .SH SYNOPSIS @@ -20,7 +20,7 @@ For OpenSSL and GnuTLS valid examples of cipher lists include \fBRC4\-SHA\fP, \fBSHA1+DES\fP, \fBTLSv1\fP and \fBDEFAULT\fP. The default list is normally set when you compile OpenSSL. -For WolfSSL, valid examples of cipher lists include \fBECDHE\-RSA\-RC4\-SHA\fP, +For wolfSSL, valid examples of cipher lists include \fBECDHE\-RSA\-RC4\-SHA\fP, \fBAES256\-SHA:AES256\-SHA256\fP, etc. For mbedTLS and BearSSL, valid examples of cipher lists include @@ -38,9 +38,9 @@ Find more details about cipher lists on this URL: The application does not have to keep the string around after setting this option. .SH DEFAULT -NULL, use internal default +NULL, use internal built\-in list. .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: BearSSL, GnuTLS, OpenSSL, Schannel, Secure Transport, mbedTLS and wolfSSL @@ -60,9 +60,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.52.0, in 7.83.0 for BearSSL, in 8.8.0 for mbedTLS - -If built TLS enabled. +Added in curl 7.52.0 .SH RETURN VALUE Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PROXY_SSL_OPTIONS.3 b/core/curl/files/CURLOPT_PROXY_SSL_OPTIONS.3 index c5389f92..edb1b6e7 100644 --- a/core/curl/files/CURLOPT_PROXY_SSL_OPTIONS.3 +++ b/core/curl/files/CURLOPT_PROXY_SSL_OPTIONS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_SSL_OPTIONS.md -.TH CURLOPT_PROXY_SSL_OPTIONS 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_SSL_OPTIONS 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_SSL_OPTIONS \- HTTPS proxy SSL behavior options .SH SYNOPSIS @@ -57,7 +57,7 @@ could be a privacy violation and unexpected. .SH DEFAULT 0 .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. All TLS backends support this option. .SH EXAMPLE @@ -78,7 +78,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.52.0 +Added in curl 7.52.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_PROXY_SSL_VERIFYHOST.3 b/core/curl/files/CURLOPT_PROXY_SSL_VERIFYHOST.3 index cda0daca..fbe02cd7 100644 --- a/core/curl/files/CURLOPT_PROXY_SSL_VERIFYHOST.3 +++ b/core/curl/files/CURLOPT_PROXY_SSL_VERIFYHOST.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_SSL_VERIFYHOST.md -.TH CURLOPT_PROXY_SSL_VERIFYHOST 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_SSL_VERIFYHOST 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_SSL_VERIFYHOST \- verify the proxy certificate\(aqs name against host .SH SYNOPSIS @@ -42,7 +42,7 @@ of the proxy certificate. .SH DEFAULT 2 .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. All TLS backends support this option. .SH EXAMPLE @@ -61,9 +61,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.52.0. - -If built TLS enabled. +Added in curl 7.52.0 .SH RETURN VALUE Returns CURLE_OK if TLS is supported, and CURLE_UNKNOWN_OPTION if not. diff --git a/core/curl/files/CURLOPT_PROXY_SSL_VERIFYPEER.3 b/core/curl/files/CURLOPT_PROXY_SSL_VERIFYPEER.3 index 43b70cb3..c3f2b159 100644 --- a/core/curl/files/CURLOPT_PROXY_SSL_VERIFYPEER.3 +++ b/core/curl/files/CURLOPT_PROXY_SSL_VERIFYPEER.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_SSL_VERIFYPEER.md -.TH CURLOPT_PROXY_SSL_VERIFYPEER 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_SSL_VERIFYPEER 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_SSL_VERIFYPEER \- verify the proxy\(aqs SSL certificate .SH SYNOPSIS @@ -45,7 +45,7 @@ the correct end\-point. .SH DEFAULT 1 .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. All TLS backends support this option. .SH EXAMPLE @@ -64,9 +64,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.52.0 - -If built TLS enabled. +Added in curl 7.52.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_PROXY_TLS13_CIPHERS.3 b/core/curl/files/CURLOPT_PROXY_TLS13_CIPHERS.3 index 381050fb..9cfab40f 100644 --- a/core/curl/files/CURLOPT_PROXY_TLS13_CIPHERS.3 +++ b/core/curl/files/CURLOPT_PROXY_TLS13_CIPHERS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_TLS13_CIPHERS.md -.TH CURLOPT_PROXY_TLS13_CIPHERS 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_TLS13_CIPHERS 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_TLS13_CIPHERS \- ciphers suites for proxy TLS 1.3 .SH SYNOPSIS @@ -26,9 +26,9 @@ cipher suites by using the \fICURLOPT_PROXY_SSL_CIPHER_LIST(3)\fP option. The application does not have to keep the string around after setting this option. .SH DEFAULT -NULL, use internal default +NULL, use internal built\-in list .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: OpenSSL and Schannel @@ -48,8 +48,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.61.0. -Available when built with OpenSSL >= 1.1.1. +Added in curl 7.61.0 .SH RETURN VALUE Returns CURLE_OK if supported, CURLE_NOT_BUILT_IN otherwise. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_PROXY_TLSAUTH_PASSWORD.3 b/core/curl/files/CURLOPT_PROXY_TLSAUTH_PASSWORD.3 index c5937a3e..eff1f4c5 100644 --- a/core/curl/files/CURLOPT_PROXY_TLSAUTH_PASSWORD.3 +++ b/core/curl/files/CURLOPT_PROXY_TLSAUTH_PASSWORD.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_TLSAUTH_PASSWORD.md -.TH CURLOPT_PROXY_TLSAUTH_PASSWORD 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_TLSAUTH_PASSWORD 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_TLSAUTH_PASSWORD \- password to use for proxy TLS authentication .SH SYNOPSIS @@ -20,7 +20,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS and OpenSSL @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.52.0. +Added in curl 7.52.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PROXY_TLSAUTH_TYPE.3 b/core/curl/files/CURLOPT_PROXY_TLSAUTH_TYPE.3 index 9cf90e50..a2322d9e 100644 --- a/core/curl/files/CURLOPT_PROXY_TLSAUTH_TYPE.3 +++ b/core/curl/files/CURLOPT_PROXY_TLSAUTH_TYPE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_TLSAUTH_TYPE.md -.TH CURLOPT_PROXY_TLSAUTH_TYPE 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_TLSAUTH_TYPE 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_TLSAUTH_TYPE \- HTTPS proxy TLS authentication methods .SH SYNOPSIS @@ -17,15 +17,12 @@ method is "SRP". TLS\-SRP authentication. Secure Remote Password authentication for TLS is defined in RFC 5054 and provides mutual authentication if both sides have a shared secret. To use TLS\-SRP, you must also set the -\fICURLOPT_PROXY_TLSAUTH_USERNAME(3)\fP and -\fICURLOPT_PROXY_TLSAUTH_PASSWORD(3)\fP options. - -The application does not have to keep the string around after setting this -option. +\fICURLOPT_PROXY_TLSAUTH_USERNAME(3)\fP and \fICURLOPT_PROXY_TLSAUTH_PASSWORD(3)\fP +options. .SH DEFAULT blank .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS and OpenSSL @@ -47,10 +44,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.52.0 - -You need to build libcurl with GnuTLS or OpenSSL with TLS\-SRP support for this -to work. +Added in curl 7.52.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_PROXY_TLSAUTH_USERNAME.3 b/core/curl/files/CURLOPT_PROXY_TLSAUTH_USERNAME.3 index f8c4eb8d..e189460c 100644 --- a/core/curl/files/CURLOPT_PROXY_TLSAUTH_USERNAME.3 +++ b/core/curl/files/CURLOPT_PROXY_TLSAUTH_USERNAME.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_TLSAUTH_USERNAME.md -.TH CURLOPT_PROXY_TLSAUTH_USERNAME 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_TLSAUTH_USERNAME 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_TLSAUTH_USERNAME \- username to use for proxy TLS authentication .SH SYNOPSIS @@ -20,7 +20,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS and OpenSSL @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.52.0. +Added in curl 7.52.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_PROXY_TRANSFER_MODE.3 b/core/curl/files/CURLOPT_PROXY_TRANSFER_MODE.3 index 4a1b6308..31ae2af9 100644 --- a/core/curl/files/CURLOPT_PROXY_TRANSFER_MODE.3 +++ b/core/curl/files/CURLOPT_PROXY_TRANSFER_MODE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PROXY_TRANSFER_MODE.md -.TH CURLOPT_PROXY_TRANSFER_MODE 3 "2024-06-01" libcurl +.TH CURLOPT_PROXY_TRANSFER_MODE 3 "2024-07-29" libcurl .SH NAME CURLOPT_PROXY_TRANSFER_MODE \- append FTP transfer mode to URL for proxy .SH SYNOPSIS @@ -18,7 +18,7 @@ doing FTP via a proxy. Beware that not all proxies support this feature. .SH DEFAULT 0, disabled .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -37,7 +37,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.18.0 +Added in curl 7.18.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if the enabled value is not supported. diff --git a/core/curl/files/CURLOPT_PUT.3 b/core/curl/files/CURLOPT_PUT.3 index 4302c568..2311ddb0 100644 --- a/core/curl/files/CURLOPT_PUT.3 +++ b/core/curl/files/CURLOPT_PUT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_PUT.md -.TH CURLOPT_PUT 3 "2024-06-01" libcurl +.TH CURLOPT_PUT 3 "2024-07-29" libcurl .SH NAME CURLOPT_PUT \- make an HTTP PUT request .SH SYNOPSIS @@ -17,7 +17,7 @@ This option is \fBdeprecated\fP since version 7.12.1. Use \fICURLOPT_UPLOAD(3)\f .SH DEFAULT 0, disabled .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf static size_t read_cb(char *ptr, size_t size, size_t nmemb, void *userdata) @@ -57,8 +57,10 @@ int main(void) } } .fi +.SH DEPRECATED +Deprecated since 7.12.1. .SH AVAILABILITY -Deprecated since 7.12.1. Do not use. +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_QUICK_EXIT.3 b/core/curl/files/CURLOPT_QUICK_EXIT.3 index 6f2b1aa8..142b6139 100644 --- a/core/curl/files/CURLOPT_QUICK_EXIT.3 +++ b/core/curl/files/CURLOPT_QUICK_EXIT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_QUICK_EXIT.md -.TH CURLOPT_QUICK_EXIT 3 "2024-06-01" libcurl +.TH CURLOPT_QUICK_EXIT 3 "2024-07-29" libcurl .SH NAME CURLOPT_QUICK_EXIT \- allow to exit quickly .SH SYNOPSIS @@ -19,7 +19,7 @@ possible (though short\-lived) leak of associated resources. .SH DEFAULT 0 .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -33,7 +33,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.87.0 +Added in curl 7.87.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_QUOTE.3 b/core/curl/files/CURLOPT_QUOTE.3 index 27fc864a..28c13501 100644 --- a/core/curl/files/CURLOPT_QUOTE.3 +++ b/core/curl/files/CURLOPT_QUOTE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_QUOTE.md -.TH CURLOPT_QUOTE 3 "2024-06-01" libcurl +.TH CURLOPT_QUOTE 3 "2024-07-29" libcurl .SH NAME CURLOPT_QUOTE \- (S)FTP commands to run before transfer .SH SYNOPSIS @@ -81,7 +81,7 @@ See ln. .SH DEFAULT NULL .SH PROTOCOLS -FTP and SFTP +This functionality affects ftp and sftp .SH EXAMPLE .nf int main(void) @@ -104,8 +104,10 @@ int main(void) } } .fi -.SH AVAILABILITY +.SH HISTORY SFTP support added in 7.16.3. *\-prefix for SFTP added in 7.24.0 +.SH AVAILABILITY +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_RANDOM_FILE.3 b/core/curl/files/CURLOPT_RANDOM_FILE.3 index 57aa1a9e..56e40d20 100644 --- a/core/curl/files/CURLOPT_RANDOM_FILE.3 +++ b/core/curl/files/CURLOPT_RANDOM_FILE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_RANDOM_FILE.md -.TH CURLOPT_RANDOM_FILE 3 "2024-06-01" libcurl +.TH CURLOPT_RANDOM_FILE 3 "2024-07-29" libcurl .SH NAME CURLOPT_RANDOM_FILE \- file to read random data from .SH SYNOPSIS @@ -12,8 +12,10 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_RANDOM_FILE, char *path); Deprecated option. It serves no purpose anymore. .SH DEFAULT NULL, not used +.SH DEPRECATED +Deprecated since 7.84.0. .SH AVAILABILITY -This option was deprecated in 7.84.0. +Added in curl 7.7 .SH RETURN VALUE Returns CURLE_OK. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_RANGE.3 b/core/curl/files/CURLOPT_RANGE.3 index c36adbc8..345ca3ef 100644 --- a/core/curl/files/CURLOPT_RANGE.3 +++ b/core/curl/files/CURLOPT_RANGE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_RANGE.md -.TH CURLOPT_RANGE 3 "2024-06-01" libcurl +.TH CURLOPT_RANGE 3 "2024-07-29" libcurl .SH NAME CURLOPT_RANGE \- byte range to request .SH SYNOPSIS @@ -34,7 +34,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -FILE, FTP, HTTP, RTSP and SFTP +This functionality affects file, ftp, http, rtsp and sftp .SH EXAMPLE .nf int main(void) @@ -51,8 +51,10 @@ int main(void) } } .fi -.SH AVAILABILITY +.SH HISTORY FILE since 7.18.0, RTSP since 7.20.0 +.SH AVAILABILITY +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK on success or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_READDATA.3 b/core/curl/files/CURLOPT_READDATA.3 index 51e9dd18..34b6ab76 100644 --- a/core/curl/files/CURLOPT_READDATA.3 +++ b/core/curl/files/CURLOPT_READDATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_READDATA.md -.TH CURLOPT_READDATA 3 "2024-06-01" libcurl +.TH CURLOPT_READDATA 3 "2024-07-29" libcurl .SH NAME CURLOPT_READDATA \- pointer passed to the read callback .SH SYNOPSIS @@ -20,9 +20,9 @@ If you are using libcurl as a DLL on Windows, you must use the \fICURLOPT_READFUNCTION(3)\fP callback if you set this option, otherwise you might experience crashes. .SH DEFAULT -By default, this is a FILE * to stdin. +stdin .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf struct MyData { @@ -44,9 +44,11 @@ int main(void) } } .fi -.SH AVAILABILITY +.SH HISTORY This option was once known by the older name CURLOPT_INFILE, the name \fICURLOPT_READDATA(3)\fP was introduced in 7.9.7. +.SH AVAILABILITY +Added in curl 7.9.7 .SH RETURN VALUE This returns CURLE_OK. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_READFUNCTION.3 b/core/curl/files/CURLOPT_READFUNCTION.3 index 9bbc4dd4..2aec588f 100644 --- a/core/curl/files/CURLOPT_READFUNCTION.3 +++ b/core/curl/files/CURLOPT_READFUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_READFUNCTION.md -.TH CURLOPT_READFUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_READFUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_READFUNCTION \- read callback for data uploads .SH SYNOPSIS @@ -50,9 +50,9 @@ You can set the total size of the data you are sending by using depending on the type of transfer. For some transfer types it may be required and it allows for better error checking. .SH DEFAULT -The default internal read callback is fread(). +fread(3) .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf size_t read_callback(char *ptr, size_t size, size_t nmemb, void *userdata) @@ -88,9 +88,11 @@ int main(int argc, char **argv) } } .fi -.SH AVAILABILITY +.SH HISTORY CURL_READFUNC_PAUSE return code was added in 7.18.0 and CURL_READFUNC_ABORT was added in 7.12.1. +.SH AVAILABILITY +Added in curl 7.1 .SH RETURN VALUE This returns CURLE_OK. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_REDIR_PROTOCOLS.3 b/core/curl/files/CURLOPT_REDIR_PROTOCOLS.3 index 0a3494e2..4b4ec7f1 100644 --- a/core/curl/files/CURLOPT_REDIR_PROTOCOLS.3 +++ b/core/curl/files/CURLOPT_REDIR_PROTOCOLS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_REDIR_PROTOCOLS.md -.TH CURLOPT_REDIR_PROTOCOLS 3 "2024-06-01" libcurl +.TH CURLOPT_REDIR_PROTOCOLS 3 "2024-07-29" libcurl .SH NAME CURLOPT_REDIR_PROTOCOLS \- protocols allowed to redirect to .SH SYNOPSIS @@ -63,7 +63,7 @@ HTTP, HTTPS, FTP and FTPS (Added in 7.65.2). Older versions defaulted to all protocols except FILE, SCP and since 7.40.0 SMB and SMBS. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(int argc, char **argv) @@ -82,9 +82,10 @@ int main(int argc, char **argv) } } .fi +.SH DEPRECATED +Deprecated since 7.85.0. .SH AVAILABILITY -Added in 7.19.4, before then it would follow all protocols. Deprecated -since 7.85.0. +Added in curl 7.19.4 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_REDIR_PROTOCOLS_STR.3 b/core/curl/files/CURLOPT_REDIR_PROTOCOLS_STR.3 index 39ab90ab..68694241 100644 --- a/core/curl/files/CURLOPT_REDIR_PROTOCOLS_STR.3 +++ b/core/curl/files/CURLOPT_REDIR_PROTOCOLS_STR.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_REDIR_PROTOCOLS_STR.md -.TH CURLOPT_REDIR_PROTOCOLS_STR 3 "2024-06-01" libcurl +.TH CURLOPT_REDIR_PROTOCOLS_STR 3 "2024-07-29" libcurl .SH NAME CURLOPT_REDIR_PROTOCOLS_STR \- protocols allowed to redirect to .SH SYNOPSIS @@ -41,7 +41,7 @@ HTTP, HTTPS, FTP and FTPS (Added in 7.65.2). Older versions defaulted to all protocols except FILE, SCP and since 7.40.0 SMB and SMBS. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(int argc, char **argv) @@ -60,7 +60,7 @@ int main(int argc, char **argv) } .fi .SH AVAILABILITY -Added in 7.85.0. +Added in curl 7.85.0 .SH RETURN VALUE Returns CURLE_UNKNOWN_OPTION if the option is not implemented, CURLE_UNSUPPORTED_PROTOCOL if a listed protocol is not supported or disabled, diff --git a/core/curl/files/CURLOPT_REFERER.3 b/core/curl/files/CURLOPT_REFERER.3 index a0085185..9a2102c7 100644 --- a/core/curl/files/CURLOPT_REFERER.3 +++ b/core/curl/files/CURLOPT_REFERER.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_REFERER.md -.TH CURLOPT_REFERER 3 "2024-06-01" libcurl +.TH CURLOPT_REFERER 3 "2024-07-29" libcurl .SH NAME CURLOPT_REFERER \- the HTTP referer header .SH SYNOPSIS @@ -18,7 +18,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -35,7 +35,7 @@ int main(void) } .fi .SH AVAILABILITY -If built with HTTP support +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK if HTTP support is enabled, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_REQUEST_TARGET.3 b/core/curl/files/CURLOPT_REQUEST_TARGET.3 index 00541a73..918bfeca 100644 --- a/core/curl/files/CURLOPT_REQUEST_TARGET.3 +++ b/core/curl/files/CURLOPT_REQUEST_TARGET.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_REQUEST_TARGET.md -.TH CURLOPT_REQUEST_TARGET 3 "2024-06-01" libcurl +.TH CURLOPT_REQUEST_TARGET 3 "2024-07-29" libcurl .SH NAME CURLOPT_REQUEST_TARGET \- alternative target for this request .SH SYNOPSIS @@ -17,7 +17,7 @@ other safe guards. That includes white space and control characters. .SH DEFAULT NULL .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -36,7 +36,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.55.0 +Added in curl 7.55.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_RESOLVE.3 b/core/curl/files/CURLOPT_RESOLVE.3 index 77279d42..b3d3bed7 100644 --- a/core/curl/files/CURLOPT_RESOLVE.3 +++ b/core/curl/files/CURLOPT_RESOLVE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_RESOLVE.md -.TH CURLOPT_RESOLVE 3 "2024-06-01" libcurl +.TH CURLOPT_RESOLVE 3 "2024-07-29" libcurl .SH NAME CURLOPT_RESOLVE \- provide custom hostname to IP address resolves .SH SYNOPSIS @@ -28,13 +28,17 @@ numerical IP addresses. If you specify multiple IP addresses they need to be separated by comma. If libcurl is built to support IPv6, each of the ADDRESS entries can of course be either IPv4 or IPv6 style addressing. +Specify the host as a single ampersand (\fI*\fP) to match all names. This wildcard +is resolved last so any resolve with a specific host and port number is given +priority. + This option effectively populates the DNS cache with entries for the host+port pair so redirects and everything that operations against the HOST+PORT instead use your provided ADDRESS. -The optional leading "+" specifies that the new entry should time\-out. Entries -added without the leading plus character never times out whereas entries added -with "+HOST:..." times out just like ordinary DNS cache entries. +The optional leading plus (\fI+\fP) specifies that the new entry should timeout. +Entries added without the leading plus character never times out whereas +entries added with \fI+HOST:...\fP times out just like ordinary DNS cache entries. If the DNS cache already has an entry for the given host+port pair, the new entry overrides the former one. @@ -54,7 +58,7 @@ number must exactly match what was added previously. .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -77,7 +81,7 @@ int main(void) curl_slist_free_all(host); } .fi -.SH AVAILABILITY +.SH HISTORY Added in 7.21.3. Removal support added in 7.42.0. Support for providing the ADDRESS within [brackets] was added in 7.57.0. @@ -86,6 +90,8 @@ Support for providing multiple IP addresses per entry was added in 7.59.0. Support for adding non\-permanent entries by using the "+" prefix was added in 7.75.0. +.SH AVAILABILITY +Added in curl 7.21.3 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_RESOLVER_START_DATA.3 b/core/curl/files/CURLOPT_RESOLVER_START_DATA.3 index 54c58901..4a71248a 100644 --- a/core/curl/files/CURLOPT_RESOLVER_START_DATA.3 +++ b/core/curl/files/CURLOPT_RESOLVER_START_DATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_RESOLVER_START_DATA.md -.TH CURLOPT_RESOLVER_START_DATA 3 "2024-06-01" libcurl +.TH CURLOPT_RESOLVER_START_DATA 3 "2024-07-29" libcurl .SH NAME CURLOPT_RESOLVER_START_DATA \- pointer passed to the resolver start callback .SH SYNOPSIS @@ -16,7 +16,7 @@ argument in the resolver start callback set with .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf static int resolver_start_cb(void *resolver_state, void *reserved, @@ -41,7 +41,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.59.0 +Added in curl 7.59.0 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_RESOLVER_START_FUNCTION.3 b/core/curl/files/CURLOPT_RESOLVER_START_FUNCTION.3 index b457af7c..3016f625 100644 --- a/core/curl/files/CURLOPT_RESOLVER_START_FUNCTION.3 +++ b/core/curl/files/CURLOPT_RESOLVER_START_FUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_RESOLVER_START_FUNCTION.md -.TH CURLOPT_RESOLVER_START_FUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_RESOLVER_START_FUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_RESOLVER_START_FUNCTION \- callback called before a new name resolve is started .SH SYNOPSIS @@ -34,7 +34,7 @@ resolve to fail. .SH DEFAULT NULL (No callback) .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf static int start_cb(void *resolver_state, void *reserved, @@ -59,7 +59,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.59.0 +Added in curl 7.59.0 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_RESUME_FROM.3 b/core/curl/files/CURLOPT_RESUME_FROM.3 index 705997a1..e0f884c0 100644 --- a/core/curl/files/CURLOPT_RESUME_FROM.3 +++ b/core/curl/files/CURLOPT_RESUME_FROM.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_RESUME_FROM.md -.TH CURLOPT_RESUME_FROM 3 "2024-06-01" libcurl +.TH CURLOPT_RESUME_FROM 3 "2024-07-29" libcurl .SH NAME CURLOPT_RESUME_FROM \- offset to resume transfer from .SH SYNOPSIS @@ -24,7 +24,7 @@ If you need to resume a transfer beyond the 2GB limit, use .SH DEFAULT 0, not used .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -50,7 +50,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_RESUME_FROM_LARGE.3 b/core/curl/files/CURLOPT_RESUME_FROM_LARGE.3 index 73e320b6..e93994b3 100644 --- a/core/curl/files/CURLOPT_RESUME_FROM_LARGE.3 +++ b/core/curl/files/CURLOPT_RESUME_FROM_LARGE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_RESUME_FROM_LARGE.md -.TH CURLOPT_RESUME_FROM_LARGE 3 "2024-06-01" libcurl +.TH CURLOPT_RESUME_FROM_LARGE 3 "2024-07-29" libcurl .SH NAME CURLOPT_RESUME_FROM_LARGE \- offset to resume transfer from .SH SYNOPSIS @@ -22,7 +22,7 @@ file to the remote target file. .SH DEFAULT 0, not used .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -49,7 +49,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.11.0 +Added in curl 7.11.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_RTSP_CLIENT_CSEQ.3 b/core/curl/files/CURLOPT_RTSP_CLIENT_CSEQ.3 index e9e6a7f5..df180590 100644 --- a/core/curl/files/CURLOPT_RTSP_CLIENT_CSEQ.3 +++ b/core/curl/files/CURLOPT_RTSP_CLIENT_CSEQ.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_RTSP_CLIENT_CSEQ.md -.TH CURLOPT_RTSP_CLIENT_CSEQ 3 "2024-06-01" libcurl +.TH CURLOPT_RTSP_CLIENT_CSEQ 3 "2024-07-29" libcurl .SH NAME CURLOPT_RTSP_CLIENT_CSEQ \- RTSP client CSEQ number .SH SYNOPSIS @@ -15,7 +15,7 @@ increments from this new number henceforth. .SH DEFAULT 0 .SH PROTOCOLS -RTSP +This functionality affects rtsp only .SH EXAMPLE .nf int main(void) @@ -31,7 +31,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.20.0 +Added in curl 7.20.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_RTSP_REQUEST.3 b/core/curl/files/CURLOPT_RTSP_REQUEST.3 index a22c1b63..b79efd3b 100644 --- a/core/curl/files/CURLOPT_RTSP_REQUEST.3 +++ b/core/curl/files/CURLOPT_RTSP_REQUEST.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_RTSP_REQUEST.md -.TH CURLOPT_RTSP_REQUEST 3 "2024-06-01" libcurl +.TH CURLOPT_RTSP_REQUEST 3 "2024-07-29" libcurl .SH NAME CURLOPT_RTSP_REQUEST \- RTSP request .SH SYNOPSIS @@ -72,7 +72,7 @@ data. It returns after processing one read buffer of data in order to give the application a chance to run. .SH DEFAULT .SH PROTOCOLS -RTSP +This functionality affects rtsp only .SH EXAMPLE .nf int main(void) @@ -89,7 +89,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.20.0 +Added in curl 7.20.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_RTSP_SERVER_CSEQ.3 b/core/curl/files/CURLOPT_RTSP_SERVER_CSEQ.3 index a6b2a91c..a274a667 100644 --- a/core/curl/files/CURLOPT_RTSP_SERVER_CSEQ.3 +++ b/core/curl/files/CURLOPT_RTSP_SERVER_CSEQ.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_RTSP_SERVER_CSEQ.md -.TH CURLOPT_RTSP_SERVER_CSEQ 3 "2024-06-01" libcurl +.TH CURLOPT_RTSP_SERVER_CSEQ 3 "2024-07-29" libcurl .SH NAME CURLOPT_RTSP_SERVER_CSEQ \- RTSP server CSEQ number .SH SYNOPSIS @@ -15,7 +15,7 @@ unimplemented. .SH DEFAULT 0 .SH PROTOCOLS -RTSP +This functionality affects rtsp only .SH EXAMPLE .nf int main(void) @@ -31,7 +31,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.20.0 +Added in curl 7.20.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_RTSP_SESSION_ID.3 b/core/curl/files/CURLOPT_RTSP_SESSION_ID.3 index 64aad69a..40e581e7 100644 --- a/core/curl/files/CURLOPT_RTSP_SESSION_ID.3 +++ b/core/curl/files/CURLOPT_RTSP_SESSION_ID.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_RTSP_SESSION_ID.md -.TH CURLOPT_RTSP_SESSION_ID 3 "2024-06-01" libcurl +.TH CURLOPT_RTSP_SESSION_ID 3 "2024-07-29" libcurl .SH NAME CURLOPT_RTSP_SESSION_ID \- RTSP session ID .SH SYNOPSIS @@ -21,7 +21,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -RTSP +This functionality affects rtsp only .SH EXAMPLE .nf int main(void) @@ -38,7 +38,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.20.0 +Added in curl 7.20.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_RTSP_STREAM_URI.3 b/core/curl/files/CURLOPT_RTSP_STREAM_URI.3 index e7fa6401..478bb4fd 100644 --- a/core/curl/files/CURLOPT_RTSP_STREAM_URI.3 +++ b/core/curl/files/CURLOPT_RTSP_STREAM_URI.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_RTSP_STREAM_URI.md -.TH CURLOPT_RTSP_STREAM_URI 3 "2024-06-01" libcurl +.TH CURLOPT_RTSP_STREAM_URI 3 "2024-07-29" libcurl .SH NAME CURLOPT_RTSP_STREAM_URI \- RTSP stream URI .SH SYNOPSIS @@ -25,7 +25,7 @@ option. .SH DEFAULT \&"*" .SH PROTOCOLS -RTSP +This functionality affects rtsp only .SH EXAMPLE .nf int main(void) @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.20.0 +Added in curl 7.20.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_RTSP_TRANSPORT.3 b/core/curl/files/CURLOPT_RTSP_TRANSPORT.3 index 38a29975..4aa4b450 100644 --- a/core/curl/files/CURLOPT_RTSP_TRANSPORT.3 +++ b/core/curl/files/CURLOPT_RTSP_TRANSPORT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_RTSP_TRANSPORT.md -.TH CURLOPT_RTSP_TRANSPORT 3 "2024-06-01" libcurl +.TH CURLOPT_RTSP_TRANSPORT 3 "2024-07-29" libcurl .SH NAME CURLOPT_RTSP_TRANSPORT \- RTSP Transport: header .SH SYNOPSIS @@ -20,7 +20,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -RTSP +This functionality affects rtsp only .SH EXAMPLE .nf int main(void) @@ -38,7 +38,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.20.0 +Added in curl 7.20.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_SASL_AUTHZID.3 b/core/curl/files/CURLOPT_SASL_AUTHZID.3 index a3d7ce4a..756f2e4f 100644 --- a/core/curl/files/CURLOPT_SASL_AUTHZID.3 +++ b/core/curl/files/CURLOPT_SASL_AUTHZID.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SASL_AUTHZID.md -.TH CURLOPT_SASL_AUTHZID 3 "2024-06-01" libcurl +.TH CURLOPT_SASL_AUTHZID 3 "2024-07-29" libcurl .SH NAME CURLOPT_SASL_AUTHZID \- authorization identity (identity to act as) .SH SYNOPSIS @@ -24,7 +24,7 @@ access to, or a shared mailbox for example. .SH DEFAULT blank .SH PROTOCOLS -IMAP +This functionality affects imap only .SH EXAMPLE .nf int main(void) @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.66.0. Support for OpenLDAP added in 7.82.0. +Added in curl 7.66.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_SASL_IR.3 b/core/curl/files/CURLOPT_SASL_IR.3 index 27a2ab84..7ac881f8 100644 --- a/core/curl/files/CURLOPT_SASL_IR.3 +++ b/core/curl/files/CURLOPT_SASL_IR.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SASL_IR.md -.TH CURLOPT_SASL_IR 3 "2024-06-01" libcurl +.TH CURLOPT_SASL_IR 3 "2024-07-29" libcurl .SH NAME CURLOPT_SASL_IR \- send initial response in first packet .SH SYNOPSIS @@ -26,7 +26,7 @@ SASL\-IR CAPABILITY. .SH DEFAULT 0 .SH PROTOCOLS -IMAP and SMTP +This functionality affects imap and smtp .SH EXAMPLE .nf int main(void) @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.31.0 +Added in curl 7.31.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_SEEKDATA.3 b/core/curl/files/CURLOPT_SEEKDATA.3 index 19e75622..2992716d 100644 --- a/core/curl/files/CURLOPT_SEEKDATA.3 +++ b/core/curl/files/CURLOPT_SEEKDATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SEEKDATA.md -.TH CURLOPT_SEEKDATA 3 "2024-06-01" libcurl +.TH CURLOPT_SEEKDATA 3 "2024-07-29" libcurl .SH NAME CURLOPT_SEEKDATA \- pointer passed to the seek callback .SH SYNOPSIS @@ -14,7 +14,7 @@ Data \fIpointer\fP to pass to the seek callback function. If you use the .SH DEFAULT If you do not set this, NULL is passed to the callback. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf #include /* for lseek() */ @@ -41,7 +41,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.18.0 +Added in curl 7.18.0 .SH RETURN VALUE .SH SEE ALSO .BR CURLOPT_DEBUGFUNCTION (3), diff --git a/core/curl/files/CURLOPT_SEEKFUNCTION.3 b/core/curl/files/CURLOPT_SEEKFUNCTION.3 index 42e7f832..d0acbdbf 100644 --- a/core/curl/files/CURLOPT_SEEKFUNCTION.3 +++ b/core/curl/files/CURLOPT_SEEKFUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SEEKFUNCTION.md -.TH CURLOPT_SEEKFUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_SEEKFUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_SEEKFUNCTION \- user callback for seeking in input stream .SH SYNOPSIS @@ -43,9 +43,9 @@ If you forward the input arguments directly to fseek(3) or lseek(3), note that the data type for \fIoffset\fP is not the same as defined for curl_off_t on many systems! .SH DEFAULT -By default, this is NULL and unused. +NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf #include /* for lseek */ @@ -71,7 +71,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.18.0 +Added in curl 7.18.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_SERVER_RESPONSE_TIMEOUT.3 b/core/curl/files/CURLOPT_SERVER_RESPONSE_TIMEOUT.3 index 7efe322c..3d4b3631 100644 --- a/core/curl/files/CURLOPT_SERVER_RESPONSE_TIMEOUT.3 +++ b/core/curl/files/CURLOPT_SERVER_RESPONSE_TIMEOUT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SERVER_RESPONSE_TIMEOUT.md -.TH CURLOPT_SERVER_RESPONSE_TIMEOUT 3 "2024-06-01" libcurl +.TH CURLOPT_SERVER_RESPONSE_TIMEOUT 3 "2024-07-29" libcurl .SH NAME CURLOPT_SERVER_RESPONSE_TIMEOUT \- time allowed to wait for server response .SH SYNOPSIS @@ -22,7 +22,7 @@ This option was formerly known as CURLOPT_FTP_RESPONSE_TIMEOUT. .SH DEFAULT None .SH PROTOCOLS -FTP, IMAP, POP3, SCP, SFTP and SMTP +This functionality affects ftp, imap, pop3, scp, sftp and smtp .SH EXAMPLE .nf int main(void) @@ -40,10 +40,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.10.8. Used under this name since 7.20.0 - -Support for SSH is predicated on a new enough (1.11.0) version of libssh2 -being available when compiling libcurl. +Added in curl 7.20.0 .SH RETURN VALUE Returns CURLE_OK if supported, and CURLE_UNKNOWN_OPTION if not. Returns CURLE_BAD_FUNCTION_ARGUMENT if set to a negative value or a value that when diff --git a/core/curl/files/CURLOPT_SERVER_RESPONSE_TIMEOUT_MS.3 b/core/curl/files/CURLOPT_SERVER_RESPONSE_TIMEOUT_MS.3 index c41406cb..b1db10b1 100644 --- a/core/curl/files/CURLOPT_SERVER_RESPONSE_TIMEOUT_MS.3 +++ b/core/curl/files/CURLOPT_SERVER_RESPONSE_TIMEOUT_MS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SERVER_RESPONSE_TIMEOUT_MS.md -.TH CURLOPT_SERVER_RESPONSE_TIMEOUT_MS 3 "2024-06-01" libcurl +.TH CURLOPT_SERVER_RESPONSE_TIMEOUT_MS 3 "2024-07-29" libcurl .SH NAME CURLOPT_SERVER_RESPONSE_TIMEOUT_MS \- time allowed to wait for server response .SH SYNOPSIS @@ -24,7 +24,7 @@ This is the millisecond version of \fICURLOPT_SERVER_RESPONSE_TIMEOUT(3)\fP. .SH DEFAULT None .SH PROTOCOLS -FTP, IMAP, POP3, SCP, SFTP and SMTP +This functionality affects ftp, imap, pop3, scp, sftp and smtp .SH EXAMPLE .nf int main(void) @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 8.6.0. +Added in curl 8.6.0 .SH RETURN VALUE Returns CURLE_OK if supported, and CURLE_UNKNOWN_OPTION if not. Returns CURLE_BAD_FUNCTION_ARGUMENT if set to a negative value or a value that when diff --git a/core/curl/files/CURLOPT_SERVICE_NAME.3 b/core/curl/files/CURLOPT_SERVICE_NAME.3 index bef11335..47f4d297 100644 --- a/core/curl/files/CURLOPT_SERVICE_NAME.3 +++ b/core/curl/files/CURLOPT_SERVICE_NAME.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SERVICE_NAME.md -.TH CURLOPT_SERVICE_NAME 3 "2024-06-01" libcurl +.TH CURLOPT_SERVICE_NAME 3 "2024-07-29" libcurl .SH NAME CURLOPT_SERVICE_NAME \- authentication service name .SH SYNOPSIS @@ -19,7 +19,7 @@ option. .SH DEFAULT See above .SH PROTOCOLS -FTP, HTTP, IMAP, LDAP, POP3 and SMTP +This functionality affects ftp, http, imap, ldap, pop3 and smtp .SH EXAMPLE .nf int main(void) @@ -34,8 +34,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.43.0 for HTTP, 7.49.0 for FTP, IMAP, POP3 and SMTP, -7.82.0 for OpenLDAP. +Added in curl 7.43.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_SHARE.3 b/core/curl/files/CURLOPT_SHARE.3 index a12028ec..a9c900b6 100644 --- a/core/curl/files/CURLOPT_SHARE.3 +++ b/core/curl/files/CURLOPT_SHARE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SHARE.md -.TH CURLOPT_SHARE 3 "2024-06-01" libcurl +.TH CURLOPT_SHARE 3 "2024-07-29" libcurl .SH NAME CURLOPT_SHARE \- share handle to use .SH SYNOPSIS @@ -29,7 +29,7 @@ Set this option to NULL again to stop using that share object. .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -59,7 +59,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.10 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_SOCKOPTDATA.3 b/core/curl/files/CURLOPT_SOCKOPTDATA.3 index 278693aa..be775ab5 100644 --- a/core/curl/files/CURLOPT_SOCKOPTDATA.3 +++ b/core/curl/files/CURLOPT_SOCKOPTDATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SOCKOPTDATA.md -.TH CURLOPT_SOCKOPTDATA 3 "2024-06-01" libcurl +.TH CURLOPT_SOCKOPTDATA 3 "2024-07-29" libcurl .SH NAME CURLOPT_SOCKOPTDATA \- pointer to pass to sockopt callback .SH SYNOPSIS @@ -12,9 +12,9 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SOCKOPTDATA, void *pointer); Pass a \fIpointer\fP that is untouched by libcurl and passed as the first argument in the sockopt callback set with \fICURLOPT_SOCKOPTFUNCTION(3)\fP. .SH DEFAULT -The default value of this parameter is NULL. +NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf static int sockopt_callback(void *clientp, curl_socket_t curlfd, @@ -46,7 +46,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.16.0 +Added in curl 7.16.0 .SH RETURN VALUE Returns \fICURLE_OK\fP if the option is supported, and \fICURLE_UNKNOWN_OPTION\fP if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_SOCKOPTFUNCTION.3 b/core/curl/files/CURLOPT_SOCKOPTFUNCTION.3 index 6e1d96b3..d3311c93 100644 --- a/core/curl/files/CURLOPT_SOCKOPTFUNCTION.3 +++ b/core/curl/files/CURLOPT_SOCKOPTFUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SOCKOPTFUNCTION.md -.TH CURLOPT_SOCKOPTFUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_SOCKOPTFUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_SOCKOPTFUNCTION \- callback for setting socket options .SH SYNOPSIS @@ -53,9 +53,9 @@ application to pass in an already connected socket with \fICURLOPT_OPENSOCKETFUNCTION(3)\fP and then have this function make libcurl not attempt to connect (again). .SH DEFAULT -By default, this callback is NULL and unused. +NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf /* make libcurl use the already established socket 'sockfd' */ @@ -101,8 +101,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.16.0. The \fICURL_SOCKOPT_ALREADY_CONNECTED\fP return code was -added in 7.21.5. +Added in curl 7.16.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_SOCKS5_AUTH.3 b/core/curl/files/CURLOPT_SOCKS5_AUTH.3 index 05a8882a..4d75b9da 100644 --- a/core/curl/files/CURLOPT_SOCKS5_AUTH.3 +++ b/core/curl/files/CURLOPT_SOCKS5_AUTH.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SOCKS5_AUTH.md -.TH CURLOPT_SOCKS5_AUTH 3 "2024-06-01" libcurl +.TH CURLOPT_SOCKS5_AUTH 3 "2024-07-29" libcurl .SH NAME CURLOPT_SOCKS5_AUTH \- methods for SOCKS5 proxy authentication .SH SYNOPSIS @@ -18,7 +18,7 @@ password with the \fICURLOPT_PROXYUSERPWD(3)\fP option. .SH DEFAULT CURLAUTH_BASIC|CURLAUTH_GSSAPI .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -39,7 +39,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.55.0 +Added in curl 7.55.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_NOT_BUILT_IN if the bitmask contains unsupported flags. diff --git a/core/curl/files/CURLOPT_SOCKS5_GSSAPI_NEC.3 b/core/curl/files/CURLOPT_SOCKS5_GSSAPI_NEC.3 index 36bc69a3..d24b3cb3 100644 --- a/core/curl/files/CURLOPT_SOCKS5_GSSAPI_NEC.3 +++ b/core/curl/files/CURLOPT_SOCKS5_GSSAPI_NEC.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SOCKS5_GSSAPI_NEC.md -.TH CURLOPT_SOCKS5_GSSAPI_NEC 3 "2024-06-01" libcurl +.TH CURLOPT_SOCKS5_GSSAPI_NEC 3 "2024-07-29" libcurl .SH NAME CURLOPT_SOCKS5_GSSAPI_NEC \- SOCKS proxy GSSAPI negotiation protection .SH SYNOPSIS @@ -17,7 +17,7 @@ negotiation. .SH DEFAULT ? .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -34,9 +34,9 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.19.4 +Added in curl 7.19.4 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO .BR CURLOPT_PROXY (3), -.BR CURLOPT_SOCKS5_GSSAPI_SERVICE (3) +.BR CURLOPT_PROXY_SERVICE_NAME (3) diff --git a/core/curl/files/CURLOPT_SOCKS5_GSSAPI_SERVICE.3 b/core/curl/files/CURLOPT_SOCKS5_GSSAPI_SERVICE.3 index 8016d69d..9c8b8841 100644 --- a/core/curl/files/CURLOPT_SOCKS5_GSSAPI_SERVICE.3 +++ b/core/curl/files/CURLOPT_SOCKS5_GSSAPI_SERVICE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SOCKS5_GSSAPI_SERVICE.md -.TH CURLOPT_SOCKS5_GSSAPI_SERVICE 3 "2024-06-01" libcurl +.TH CURLOPT_SOCKS5_GSSAPI_SERVICE 3 "2024-07-29" libcurl .SH NAME CURLOPT_SOCKS5_GSSAPI_SERVICE \- SOCKS5 proxy authentication service name .SH SYNOPSIS @@ -21,7 +21,7 @@ option. .SH DEFAULT See above .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -37,8 +37,10 @@ int main(void) } } .fi +.SH DEPRECATED +Deprecated since 7.49.0 .SH AVAILABILITY -Added in 7.19.4, deprecated in 7.49.0 +Added in curl 7.19.4 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_SSH_AUTH_TYPES.3 b/core/curl/files/CURLOPT_SSH_AUTH_TYPES.3 index b76506f5..7b0dfd09 100644 --- a/core/curl/files/CURLOPT_SSH_AUTH_TYPES.3 +++ b/core/curl/files/CURLOPT_SSH_AUTH_TYPES.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSH_AUTH_TYPES.md -.TH CURLOPT_SSH_AUTH_TYPES 3 "2024-06-01" libcurl +.TH CURLOPT_SSH_AUTH_TYPES 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSH_AUTH_TYPES \- auth types for SFTP and SCP .SH SYNOPSIS @@ -20,7 +20,7 @@ authentication. .SH DEFAULT CURLSSH_AUTH_ANY (all available) .SH PROTOCOLS -SCP and SFTP +This functionality affects scp and sftp .SH EXAMPLE .nf int main(void) @@ -37,7 +37,7 @@ int main(void) } .fi .SH AVAILABILITY -CURLSSH_AUTH_HOST was added in 7.16.1, CURLSSH_AUTH_AGENT was added in 7.28.0 +Added in curl 7.16.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_SSH_COMPRESSION.3 b/core/curl/files/CURLOPT_SSH_COMPRESSION.3 index b536092a..3a83960d 100644 --- a/core/curl/files/CURLOPT_SSH_COMPRESSION.3 +++ b/core/curl/files/CURLOPT_SSH_COMPRESSION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSH_COMPRESSION.md -.TH CURLOPT_SSH_COMPRESSION 3 "2024-06-01" libcurl +.TH CURLOPT_SSH_COMPRESSION 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSH_COMPRESSION \- enable SSH compression .SH SYNOPSIS @@ -16,7 +16,7 @@ may or may not do it. .SH DEFAULT 0, disabled .SH PROTOCOLS -SCP and SFTP +This functionality affects scp and sftp .SH EXAMPLE .nf int main(void) @@ -34,7 +34,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.56.0 +Added in curl 7.56.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_SSH_HOSTKEYDATA.3 b/core/curl/files/CURLOPT_SSH_HOSTKEYDATA.3 index fca2e5b9..a8988e96 100644 --- a/core/curl/files/CURLOPT_SSH_HOSTKEYDATA.3 +++ b/core/curl/files/CURLOPT_SSH_HOSTKEYDATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSH_HOSTKEYDATA.md -.TH CURLOPT_SSH_KEYDATA 3 "2024-06-01" libcurl +.TH CURLOPT_SSH_HOSTKEYDATA 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSH_HOSTKEYDATA \- pointer to pass to the SSH host key callback .SH SYNOPSIS @@ -14,7 +14,7 @@ the callback set with \fICURLOPT_SSH_HOSTKEYFUNCTION(3)\fP. .SH DEFAULT NULL .SH PROTOCOLS -SCP and SFTP +This functionality affects scp and sftp .SH EXAMPLE .nf struct mine { @@ -44,8 +44,10 @@ int main(void) } } .fi +.SH NOTES +Works only with the libssh2 backend. .SH AVAILABILITY -Added in 7.84.0, works only with libssh2 backend. +Added in curl 7.84.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_SSH_HOSTKEYFUNCTION.3 b/core/curl/files/CURLOPT_SSH_HOSTKEYFUNCTION.3 index 77dfd361..cdd4bb47 100644 --- a/core/curl/files/CURLOPT_SSH_HOSTKEYFUNCTION.3 +++ b/core/curl/files/CURLOPT_SSH_HOSTKEYFUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSH_HOSTKEYFUNCTION.md -.TH CURLOPT_SSH_HOSTKEYFUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_SSH_HOSTKEYFUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSH_HOSTKEYFUNCTION \- callback to check host key .SH SYNOPSIS @@ -35,7 +35,7 @@ the host key is rejected, the connection is canceled. .SH DEFAULT NULL .SH PROTOCOLS -SCP and SFTP +This functionality affects scp and sftp .SH EXAMPLE .nf struct mine { @@ -64,8 +64,10 @@ int main(void) } } .fi +.SH NOTES +Work only with the libssh2 backend. .SH AVAILABILITY -Added in 7.84.0 , work only with libssh2 backend. +Added in curl 7.84.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_SSH_HOST_PUBLIC_KEY_MD5.3 b/core/curl/files/CURLOPT_SSH_HOST_PUBLIC_KEY_MD5.3 index 7f2b9769..ddb7774e 100644 --- a/core/curl/files/CURLOPT_SSH_HOST_PUBLIC_KEY_MD5.3 +++ b/core/curl/files/CURLOPT_SSH_HOST_PUBLIC_KEY_MD5.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSH_HOST_PUBLIC_KEY_MD5.md -.TH CURLOPT_SSH_HOST_PUBLIC_KEY_MD5 3 "2024-06-01" libcurl +.TH CURLOPT_SSH_HOST_PUBLIC_KEY_MD5 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSH_HOST_PUBLIC_KEY_MD5 \- MD5 checksum of SSH server public key .SH SYNOPSIS @@ -22,7 +22,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -SCP and SFTP +This functionality affects scp and sftp .SH EXAMPLE .nf int main(void) @@ -39,7 +39,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.17.1 +Added in curl 7.17.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256.3 b/core/curl/files/CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256.3 index 904bb186..9756f705 100644 --- a/core/curl/files/CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256.3 +++ b/core/curl/files/CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256.md -.TH CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256 3 "2024-06-01" libcurl +.TH CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256 \- SHA256 hash of SSH server public key .SH SYNOPSIS @@ -16,7 +16,7 @@ does not match the hash the remote host provides. .SH DEFAULT NULL .SH PROTOCOLS -SCP and SFTP +This functionality affects scp and sftp .SH EXAMPLE .nf int main(void) @@ -32,9 +32,10 @@ int main(void) } } .fi -.SH AVAILABILITY -Added in 7.80.0 +.SH NOTES Requires the libssh2 backend. +.SH AVAILABILITY +Added in curl 7.80.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_SSH_KEYDATA.3 b/core/curl/files/CURLOPT_SSH_KEYDATA.3 index 326d374b..4f5d7546 100644 --- a/core/curl/files/CURLOPT_SSH_KEYDATA.3 +++ b/core/curl/files/CURLOPT_SSH_KEYDATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSH_KEYDATA.md -.TH CURLOPT_SSH_KEYDATA 3 "2024-06-01" libcurl +.TH CURLOPT_SSH_KEYDATA 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSH_KEYDATA \- pointer passed to the SSH key callback .SH SYNOPSIS @@ -14,7 +14,7 @@ callback set with \fICURLOPT_SSH_KEYFUNCTION(3)\fP. .SH DEFAULT NULL .SH PROTOCOLS -SCP and SFTP +This functionality affects scp and sftp .SH EXAMPLE .nf struct mine { @@ -46,7 +46,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.19.6 +Added in curl 7.19.6 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_SSH_KEYFUNCTION.3 b/core/curl/files/CURLOPT_SSH_KEYFUNCTION.3 index c39c9ae0..afec46c8 100644 --- a/core/curl/files/CURLOPT_SSH_KEYFUNCTION.3 +++ b/core/curl/files/CURLOPT_SSH_KEYFUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSH_KEYFUNCTION.md -.TH CURLOPT_SSH_KEYFUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_SSH_KEYFUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSH_KEYFUNCTION \- callback for known host matching logic .SH SYNOPSIS @@ -80,7 +80,7 @@ up from scratch again. .SH DEFAULT NULL .SH PROTOCOLS -SCP and SFTP +This functionality affects scp and sftp .SH EXAMPLE .nf struct mine { @@ -113,7 +113,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.19.6 +Added in curl 7.19.6 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_SSH_KNOWNHOSTS.3 b/core/curl/files/CURLOPT_SSH_KNOWNHOSTS.3 index d4ad45aa..2e882823 100644 --- a/core/curl/files/CURLOPT_SSH_KNOWNHOSTS.3 +++ b/core/curl/files/CURLOPT_SSH_KNOWNHOSTS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSH_KNOWNHOSTS.md -.TH CURLOPT_SSH_KNOWNHOSTS 3 "2024-06-01" libcurl +.TH CURLOPT_SSH_KNOWNHOSTS 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSH_KNOWNHOSTS \- filename holding the SSH known hosts .SH SYNOPSIS @@ -21,7 +21,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -SCP and SFTP +This functionality affects scp and sftp .SH EXAMPLE .nf int main(void) @@ -38,7 +38,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.19.6 +Added in curl 7.19.6 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_SSH_PRIVATE_KEYFILE.3 b/core/curl/files/CURLOPT_SSH_PRIVATE_KEYFILE.3 index 432e8445..144d8689 100644 --- a/core/curl/files/CURLOPT_SSH_PRIVATE_KEYFILE.3 +++ b/core/curl/files/CURLOPT_SSH_PRIVATE_KEYFILE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSH_PRIVATE_KEYFILE.md -.TH CURLOPT_SSH_PRIVATE_KEYFILE 3 "2024-06-01" libcurl +.TH CURLOPT_SSH_PRIVATE_KEYFILE 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSH_PRIVATE_KEYFILE \- private key file for SSH auth .SH SYNOPSIS @@ -28,7 +28,7 @@ option. .SH DEFAULT As explained above .SH PROTOCOLS -SCP and SFTP +This functionality affects scp and sftp .SH EXAMPLE .nf int main(void) @@ -46,7 +46,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.16.1 +Added in curl 7.16.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_SSH_PUBLIC_KEYFILE.3 b/core/curl/files/CURLOPT_SSH_PUBLIC_KEYFILE.3 index 81f62253..0e00103c 100644 --- a/core/curl/files/CURLOPT_SSH_PUBLIC_KEYFILE.3 +++ b/core/curl/files/CURLOPT_SSH_PUBLIC_KEYFILE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSH_PUBLIC_KEYFILE.md -.TH CURLOPT_SSH_PUBLIC_KEYFILE 3 "2024-06-01" libcurl +.TH CURLOPT_SSH_PUBLIC_KEYFILE 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSH_PUBLIC_KEYFILE \- public key file for SSH auth .SH SYNOPSIS @@ -24,7 +24,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -SCP and SFTP +This functionality affects scp and sftp .SH EXAMPLE .nf int main(void) @@ -40,8 +40,10 @@ int main(void) } } .fi -.SH AVAILABILITY +.SH HISTORY The "" trick was added in 7.26.0 +.SH AVAILABILITY +Added in curl 7.16.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_SSLCERT.3 b/core/curl/files/CURLOPT_SSLCERT.3 index e658097c..49c231fb 100644 --- a/core/curl/files/CURLOPT_SSLCERT.3 +++ b/core/curl/files/CURLOPT_SSLCERT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSLCERT.md -.TH CURLOPT_SSLCERT 3 "2024-06-01" libcurl +.TH CURLOPT_SSLCERT 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSLCERT \- SSL client certificate .SH SYNOPSIS @@ -39,7 +39,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS, OpenSSL, Schannel, Secure Transport, mbedTLS and wolfSSL @@ -60,7 +60,7 @@ int main(void) } .fi .SH AVAILABILITY -If built TLS enabled. +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK if TLS enabled, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_SSLCERTTYPE.3 b/core/curl/files/CURLOPT_SSLCERTTYPE.3 index a3c595b0..b16ebb00 100644 --- a/core/curl/files/CURLOPT_SSLCERTTYPE.3 +++ b/core/curl/files/CURLOPT_SSLCERTTYPE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSLCERTTYPE.md -.TH CURLOPT_SSLCERTTYPE 3 "2024-06-01" libcurl +.TH CURLOPT_SSLCERTTYPE 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSLCERTTYPE \- type of client SSL certificate .SH SYNOPSIS @@ -22,7 +22,7 @@ option. .SH DEFAULT \&"PEM" .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS, OpenSSL, Schannel, Secure Transport, mbedTLS and wolfSSL @@ -44,7 +44,7 @@ int main(void) } .fi .SH AVAILABILITY -If built TLS enabled. Added in 7.9.3 +Added in curl 7.9.3 .SH RETURN VALUE Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_SSLCERT_BLOB.3 b/core/curl/files/CURLOPT_SSLCERT_BLOB.3 index 20d6e6dd..896fbef9 100644 --- a/core/curl/files/CURLOPT_SSLCERT_BLOB.3 +++ b/core/curl/files/CURLOPT_SSLCERT_BLOB.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSLCERT_BLOB.md -.TH CURLOPT_SSLCERT_BLOB 3 "2024-06-01" libcurl +.TH CURLOPT_SSLCERT_BLOB 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSLCERT_BLOB \- SSL client certificate from memory blob .SH SYNOPSIS @@ -25,7 +25,7 @@ expects a filename as input. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: OpenSSL, Schannel, Secure Transport and mbedTLS @@ -54,8 +54,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.71.0. This option is supported by the OpenSSL, Secure Transport, -Schannel and mbedTLS (since 7.78.0) backends. +Added in curl 7.71.0 .SH RETURN VALUE Returns CURLE_OK if TLS enabled, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_SSLENGINE.3 b/core/curl/files/CURLOPT_SSLENGINE.3 index b3250f80..7259f950 100644 --- a/core/curl/files/CURLOPT_SSLENGINE.3 +++ b/core/curl/files/CURLOPT_SSLENGINE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSLENGINE.md -.TH CURLOPT_SSLENGINE 3 "2024-06-01" libcurl +.TH CURLOPT_SSLENGINE 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSLENGINE \- SSL engine identifier .SH SYNOPSIS @@ -17,7 +17,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: OpenSSL @@ -36,7 +36,7 @@ int main(void) } .fi .SH AVAILABILITY -Only if OpenSSL is built with engine support. +Added in curl 7.9.3 .SH RETURN VALUE CURLE_OK \- Engine found. diff --git a/core/curl/files/CURLOPT_SSLENGINE_DEFAULT.3 b/core/curl/files/CURLOPT_SSLENGINE_DEFAULT.3 index dfa838ce..0fe80137 100644 --- a/core/curl/files/CURLOPT_SSLENGINE_DEFAULT.3 +++ b/core/curl/files/CURLOPT_SSLENGINE_DEFAULT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSLENGINE_DEFAULT.md -.TH CURLOPT_SSLENGINE_DEFAULT 3 "2024-06-01" libcurl +.TH CURLOPT_SSLENGINE_DEFAULT 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSLENGINE_DEFAULT \- make SSL engine default .SH SYNOPSIS @@ -16,7 +16,7 @@ This option has no effect unless set after \fICURLOPT_SSLENGINE(3)\fP. .SH DEFAULT None .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: OpenSSL @@ -36,7 +36,7 @@ int main(void) } .fi .SH AVAILABILITY -Only if the SSL backend is OpenSSL built with engine support. +Added in curl 7.9.3 .SH RETURN VALUE CURLE_OK \- Engine set as default. diff --git a/core/curl/files/CURLOPT_SSLKEY.3 b/core/curl/files/CURLOPT_SSLKEY.3 index fd1efd8c..587e4e03 100644 --- a/core/curl/files/CURLOPT_SSLKEY.3 +++ b/core/curl/files/CURLOPT_SSLKEY.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSLKEY.md -.TH CURLOPT_SSLKEY 3 "2024-06-01" libcurl +.TH CURLOPT_SSLKEY 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSLKEY \- private key file for TLS and SSL client cert .SH SYNOPSIS @@ -22,7 +22,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: OpenSSL, Schannel, mbedTLS and wolfSSL @@ -43,7 +43,7 @@ int main(void) } .fi .SH AVAILABILITY -If built TLS enabled. +Added in curl 7.9.3 .SH RETURN VALUE Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_SSLKEYTYPE.3 b/core/curl/files/CURLOPT_SSLKEYTYPE.3 index 77eb57a6..0a95f5ee 100644 --- a/core/curl/files/CURLOPT_SSLKEYTYPE.3 +++ b/core/curl/files/CURLOPT_SSLKEYTYPE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSLKEYTYPE.md -.TH CURLOPT_SSLKEYTYPE 3 "2024-06-01" libcurl +.TH CURLOPT_SSLKEYTYPE 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSLKEYTYPE \- type of the private key file .SH SYNOPSIS @@ -22,7 +22,7 @@ option. .SH DEFAULT \&"PEM" .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: BearSSL, OpenSSL and wolfSSL @@ -44,7 +44,7 @@ int main(void) } .fi .SH AVAILABILITY -If built TLS enabled. +Added in curl 7.9.3 .SH RETURN VALUE Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_SSLKEY_BLOB.3 b/core/curl/files/CURLOPT_SSLKEY_BLOB.3 index 58a30b78..b306c2ca 100644 --- a/core/curl/files/CURLOPT_SSLKEY_BLOB.3 +++ b/core/curl/files/CURLOPT_SSLKEY_BLOB.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSLKEY_BLOB.md -.TH CURLOPT_SSLKEY_BLOB 3 "2024-06-01" libcurl +.TH CURLOPT_SSLKEY_BLOB 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSLKEY_BLOB \- private key for client cert from memory blob .SH SYNOPSIS @@ -23,7 +23,7 @@ filename as input. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: OpenSSL @@ -60,7 +60,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.71.0. This option is supported by the OpenSSL backends. +Added in curl 7.71.0 .SH RETURN VALUE Returns CURLE_OK if TLS enabled, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_SSLVERSION.3 b/core/curl/files/CURLOPT_SSLVERSION.3 index dfd1f4f9..534d5fee 100644 --- a/core/curl/files/CURLOPT_SSLVERSION.3 +++ b/core/curl/files/CURLOPT_SSLVERSION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSLVERSION.md -.TH CURLOPT_SSLVERSION 3 "2024-06-01" libcurl +.TH CURLOPT_SSLVERSION 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSLVERSION \- preferred TLS/SSL version .SH SYNOPSIS @@ -34,11 +34,11 @@ TLS v1.1 or later (Added in 7.34.0) TLS v1.2 or later (Added in 7.34.0) .IP CURL_SSLVERSION_TLSv1_3 TLS v1.3 or later (Added in 7.52.0) - +.PP The maximum TLS version can be set by using \fIone\fP of the CURL_SSLVERSION_MAX_ macros below. It is also possible to OR \fIone\fP of the CURL_SSLVERSION_ macros with \fIone\fP of the CURL_SSLVERSION_MAX_ macros. -The MAX macros are not supported for WolfSSL. +The MAX macros are not supported for wolfSSL. .IP CURL_SSLVERSION_MAX_DEFAULT The flag defines the maximum supported TLS version by libcurl, or the default value from the SSL library is used. libcurl uses a sensible default maximum, @@ -56,14 +56,14 @@ The flag defines maximum supported TLS version as TLS v1.2. .IP CURL_SSLVERSION_MAX_TLSv1_3 The flag defines maximum supported TLS version as TLS v1.3. (Added in 7.54.0) - +.PP In versions of curl prior to 7.54 the CURL_SSLVERSION_TLS options were documented to allow \fIonly\fP the specified TLS version, but behavior was inconsistent depending on the TLS library. .SH DEFAULT CURL_SSLVERSION_DEFAULT .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. All TLS backends support this option. .SH EXAMPLE @@ -82,13 +82,15 @@ int main(void) } } .fi -.SH AVAILABILITY +.SH HISTORY SSLv2 and SSLv3 are refused completely since curl 7.77.0 SSLv2 is disabled by default since 7.18.1. Other SSL versions availability may vary depending on which backend libcurl has been built to use. SSLv3 is disabled by default since 7.39.0. +.SH AVAILABILITY +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_SSL_CIPHER_LIST.3 b/core/curl/files/CURLOPT_SSL_CIPHER_LIST.3 index 6485e363..0798d4c4 100644 --- a/core/curl/files/CURLOPT_SSL_CIPHER_LIST.3 +++ b/core/curl/files/CURLOPT_SSL_CIPHER_LIST.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSL_CIPHER_LIST.md -.TH CURLOPT_SSL_CIPHER_LIST 3 "2024-06-01" libcurl +.TH CURLOPT_SSL_CIPHER_LIST 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSL_CIPHER_LIST \- ciphers to use for TLS .SH SYNOPSIS @@ -19,7 +19,7 @@ For OpenSSL and GnuTLS valid examples of cipher lists include \fBRC4\-SHA\fP, \fBSHA1+DES\fP, \fBTLSv1\fP and \fBDEFAULT\fP. The default list is normally set when you compile OpenSSL. -For WolfSSL, valid examples of cipher lists include \fBECDHE\-RSA\-RC4\-SHA\fP, +For wolfSSL, valid examples of cipher lists include \fBECDHE\-RSA\-RC4\-SHA\fP, \fBAES256\-SHA:AES256\-SHA256\fP, etc. For mbedTLS and BearSSL, valid examples of cipher lists include @@ -40,9 +40,9 @@ Find more details about cipher lists on this URL: The application does not have to keep the string around after setting this option. .SH DEFAULT -NULL, use internal default +NULL, use built\-in list .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: BearSSL, GnuTLS, OpenSSL, Schannel, Secure Transport, mbedTLS and wolfSSL @@ -60,10 +60,10 @@ int main(void) } } .fi -.SH AVAILABILITY +.SH HISTORY Added in 7.9, in 7.83.0 for BearSSL, in 8.8.0 for mbedTLS - -If built TLS enabled. +.SH AVAILABILITY +Added in curl 7.9 .SH RETURN VALUE Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_SSL_CTX_DATA.3 b/core/curl/files/CURLOPT_SSL_CTX_DATA.3 index cef4b548..53cb1e8f 100644 --- a/core/curl/files/CURLOPT_SSL_CTX_DATA.3 +++ b/core/curl/files/CURLOPT_SSL_CTX_DATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSL_CTX_DATA.md -.TH CURLOPT_SSL_CTX_DATA 3 "2024-06-01" libcurl +.TH CURLOPT_SSL_CTX_DATA 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSL_CTX_DATA \- pointer passed to SSL context callback .SH SYNOPSIS @@ -15,7 +15,7 @@ parameter. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: BearSSL, OpenSSL, mbedTLS and wolfSSL @@ -92,9 +92,11 @@ int main(void) return rv; } .fi -.SH AVAILABILITY +.SH HISTORY Added in 7.11.0 for OpenSSL, in 7.42.0 for wolfSSL, in 7.54.0 for mbedTLS, in 7.83.0 in BearSSL. +.SH AVAILABILITY +Added in curl 7.10.6 .SH RETURN VALUE CURLE_OK if supported; or an error such as: diff --git a/core/curl/files/CURLOPT_SSL_CTX_FUNCTION.3 b/core/curl/files/CURLOPT_SSL_CTX_FUNCTION.3 index 3e2bd6cb..fc53ecb7 100644 --- a/core/curl/files/CURLOPT_SSL_CTX_FUNCTION.3 +++ b/core/curl/files/CURLOPT_SSL_CTX_FUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSL_CTX_FUNCTION.md -.TH CURLOPT_SSL_CTX_FUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_SSL_CTX_FUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSL_CTX_FUNCTION \- SSL context callback .SH SYNOPSIS @@ -58,7 +58,7 @@ completed. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: BearSSL, OpenSSL, mbedTLS and wolfSSL @@ -136,8 +136,7 @@ int main(void) } .fi .SH AVAILABILITY -OpenSSL (added in 7.11.0), wolfSSL (added in 7.42.0), mbedTLS (added in -7.54.0) or BearSSL (added in 7.83.0) +Added in curl 7.10.6 .SH RETURN VALUE CURLE_OK if supported; or an error such as: diff --git a/core/curl/files/CURLOPT_SSL_EC_CURVES.3 b/core/curl/files/CURLOPT_SSL_EC_CURVES.3 index 0ba57bab..3eeb6bbe 100644 --- a/core/curl/files/CURLOPT_SSL_EC_CURVES.3 +++ b/core/curl/files/CURLOPT_SSL_EC_CURVES.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSL_EC_CURVES.md -.TH CURLOPT_SSL_EC_CURVES 3 "2024-06-01" libcurl +.TH CURLOPT_SSL_EC_CURVES 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSL_EC_CURVES \- key exchange curves .SH SYNOPSIS @@ -15,7 +15,7 @@ the SSL backend libcurl is built to use supports it). .SH DEFAULT \&"", embedded in SSL backend .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: OpenSSL and wolfSSL @@ -34,7 +34,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.73.0. Supported by the OpenSSL backend. +Added in curl 7.73.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_SSL_ENABLE_ALPN.3 b/core/curl/files/CURLOPT_SSL_ENABLE_ALPN.3 index 5f218999..f1dbff96 100644 --- a/core/curl/files/CURLOPT_SSL_ENABLE_ALPN.3 +++ b/core/curl/files/CURLOPT_SSL_ENABLE_ALPN.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSL_ENABLE_ALPN.md -.TH CURLOPT_SSL_ENABLE_ALPN 3 "2024-06-01" libcurl +.TH CURLOPT_SSL_ENABLE_ALPN 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSL_ENABLE_ALPN \- Application Layer Protocol Negotiation .SH SYNOPSIS @@ -15,7 +15,7 @@ is built to use supports it), which can be used to negotiate http2. .SH DEFAULT 1, enabled .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. All TLS backends support this option. .SH EXAMPLE @@ -33,7 +33,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.36.0 +Added in curl 7.36.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_SSL_ENABLE_NPN.3 b/core/curl/files/CURLOPT_SSL_ENABLE_NPN.3 index 74bb3e4e..cfbaa126 100644 --- a/core/curl/files/CURLOPT_SSL_ENABLE_NPN.3 +++ b/core/curl/files/CURLOPT_SSL_ENABLE_NPN.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSL_ENABLE_NPN.md -.TH CURLOPT_SSL_ENABLE_NPN 3 "2024-06-01" libcurl +.TH CURLOPT_SSL_ENABLE_NPN 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSL_ENABLE_NPN \- use NPN .SH SYNOPSIS @@ -9,7 +9,7 @@ CURLOPT_SSL_ENABLE_NPN \- use NPN CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_ENABLE_NPN, long npn); .fi .SH DESCRIPTION -Deprecated in 7.86.0. Setting this option has no function. +Deprecated since 7.86.0. Setting this option has no function. Pass a long as parameter, 0 or 1 where 1 is for enable and 0 for disable. This option enables/disables NPN in the SSL handshake (if the SSL backend libcurl @@ -17,7 +17,7 @@ is built to use supports it), which can be used to negotiate http2. .SH DEFAULT 1, enabled .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. All TLS backends support this option. .SH EXAMPLE @@ -34,8 +34,10 @@ int main(void) } } .fi +.SH DEPRECATED +Deprecated since 7.86.0. .SH AVAILABILITY -Added in 7.36.0. Deprecated in 7.86.0. +Added in curl 7.36.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_SSL_FALSESTART.3 b/core/curl/files/CURLOPT_SSL_FALSESTART.3 index f554dda6..00eca957 100644 --- a/core/curl/files/CURLOPT_SSL_FALSESTART.3 +++ b/core/curl/files/CURLOPT_SSL_FALSESTART.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSL_FALSESTART.md -.TH CURLOPT_SSL_FALSESTART 3 "2024-06-01" libcurl +.TH CURLOPT_SSL_FALSESTART 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSL_FALSESTART \- TLS false start .SH SYNOPSIS @@ -18,7 +18,7 @@ when performing a full handshake. .SH DEFAULT 0 .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: Secure Transport @@ -35,8 +35,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.42.0. This option is currently only supported by the Secure -Transport (on iOS 7.0 or later, or OS X 10.9 or later) TLS backend. +Added in curl 7.42.0 .SH RETURN VALUE Returns CURLE_OK if false start is supported by the SSL backend, otherwise returns CURLE_NOT_BUILT_IN. diff --git a/core/curl/files/CURLOPT_SSL_OPTIONS.3 b/core/curl/files/CURLOPT_SSL_OPTIONS.3 index cb1178a4..36a9ec8f 100644 --- a/core/curl/files/CURLOPT_SSL_OPTIONS.3 +++ b/core/curl/files/CURLOPT_SSL_OPTIONS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSL_OPTIONS.md -.TH CURLOPT_SSL_OPTIONS 3 "2024-06-01" libcurl +.TH CURLOPT_SSL_OPTIONS 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSL_OPTIONS \- SSL behavior options .SH SYNOPSIS @@ -56,7 +56,7 @@ could be a privacy violation and unexpected. .SH DEFAULT 0 .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. All TLS backends support this option. .SH EXAMPLE @@ -76,7 +76,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.25.0 +Added in curl 7.25.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_SSL_SESSIONID_CACHE.3 b/core/curl/files/CURLOPT_SSL_SESSIONID_CACHE.3 index f3bfc4c2..2f06fbd0 100644 --- a/core/curl/files/CURLOPT_SSL_SESSIONID_CACHE.3 +++ b/core/curl/files/CURLOPT_SSL_SESSIONID_CACHE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSL_SESSIONID_CACHE.md -.TH CURLOPT_SSL_SESSIONID_CACHE 3 "2024-06-01" libcurl +.TH CURLOPT_SSL_SESSIONID_CACHE 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSL_SESSIONID_CACHE \- use the SSL session\-ID cache .SH SYNOPSIS @@ -18,7 +18,7 @@ wild that may require you to disable this in order for you to succeed. .SH DEFAULT 1 .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. All TLS backends support this option. .SH EXAMPLE @@ -37,7 +37,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.16.0 +Added in curl 7.16.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_SSL_VERIFYHOST.3 b/core/curl/files/CURLOPT_SSL_VERIFYHOST.3 index ab7d0875..8a95fa21 100644 --- a/core/curl/files/CURLOPT_SSL_VERIFYHOST.3 +++ b/core/curl/files/CURLOPT_SSL_VERIFYHOST.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSL_VERIFYHOST.md -.TH CURLOPT_SSL_VERIFYHOST 3 "2024-06-01" libcurl +.TH CURLOPT_SSL_VERIFYHOST 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSL_VERIFYHOST \- verify the certificate\(aqs name against host .SH SYNOPSIS @@ -9,40 +9,27 @@ CURLOPT_SSL_VERIFYHOST \- verify the certificate\(aqs name against host CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_VERIFYHOST, long verify); .fi .SH DESCRIPTION -Pass a long as parameter specifying what to \fIverify\fP. +Pass a long set to 2L to make libcurl verify the host in the server\(aqs TLS +certificate. -This option determines whether libcurl verifies that the server cert is for -the server it is known as. +When negotiating a TLS connection, the server sends a certificate indicating +its identity. -When negotiating TLS and SSL connections, the server sends a certificate -indicating its identity. +When \fICURLOPT_SSL_VERIFYHOST(3)\fP is set to 1 or 2, the server certificate must +indicate that it was made for the hostname or address curl connects to, or the +connection fails. Simply put, it means it has to have the same name in the +certificate as is used in the URL you operate against. -When \fICURLOPT_SSL_VERIFYHOST(3)\fP is 2, that certificate must indicate that -the server is the server to which you meant to connect, or the connection -fails. Simply put, it means it has to have the same name in the certificate as -is in the URL you operate against. - -Curl considers the server the intended one when the Common Name field or a +curl considers the server the intended one when the Common Name field or a Subject Alternate Name field in the certificate matches the hostname in the -URL to which you told Curl to connect. +URL to which you told curl to connect. -If \fIverify\fP value is set to 1: +When the \fIverify\fP value is 0, the connection succeeds regardless of the names +in the certificate. Use that ability with caution, -In 7.28.0 and earlier: treated as a debug option of some sorts, not supported -anymore due to frequently leading to programmer mistakes. - -From 7.28.1 to 7.65.3: setting it to 1 made \fIcurl_easy_setopt(3)\fP return -an error and leaving the flag untouched. - -From 7.66.0: treats 1 and 2 the same. - -When the \fIverify\fP value is 0, the connection succeeds regardless of the -names in the certificate. Use that ability with caution! - -The default value for this option is 2. - -This option controls checking the server\(aqs certificate\(aqs claimed identity. -The server could be lying. To control lying, see \fICURLOPT_SSL_VERIFYPEER(3)\fP. +This option controls checking the server\(aqs certificate\(aqs claimed identity. The +separate \fICURLOPT_SSL_VERIFYPEER(3)\fP options enables/disables verification that +the certificate is signed by a trusted Certificate Authority. WARNING: disabling verification of the certificate allows bad guys to man\-in\-the\-middle the communication without you knowing it. Disabling @@ -54,16 +41,25 @@ When libcurl uses secure protocols it trusts responses and allows for example HSTS and Alt\-Svc information to be stored and used subsequently. Disabling certificate verification can make libcurl trust and use such information from malicious servers. +.SH MATCHING +A certificate can have the name as a wildcard. The only asterisk (\fI*\fP) must +then be the left\-most character and it must be followed by a period. The +wildcard must further contain more than one period as it cannot be set for a +top\-level domain. + +A certificate can be set for a numerical IP address (IPv4 or IPv6), but then +it should be a Subject Alternate Name kind and its type should correctly +identify the field as an IP address. .SH LIMITATIONS -Secure Transport: If \fIverify\fP value is 0, then SNI is also disabled. SNI is -a TLS extension that sends the hostname to the server. The server may use that +Secure Transport: If \fIverify\fP value is 0, then SNI is also disabled. SNI is a +TLS extension that sends the hostname to the server. The server may use that information to do such things as sending back a specific certificate for the -hostname, or forwarding the request to a specific origin server. Some hostnames -may be inaccessible if SNI is not sent. +hostname, or forwarding the request to a specific origin server. Some +hostnames may be inaccessible if SNI is not sent. .SH DEFAULT 2 .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. All TLS backends support this option. .SH EXAMPLE @@ -82,11 +78,17 @@ int main(void) } .fi .SH AVAILABILITY -If built TLS enabled. +Added in curl 7.8.1 +.SH HISTORY +In 7.28.0 and earlier: the value 1 was treated as a debug option of some +sorts, not supported anymore due to frequently leading to programmer mistakes. + +From 7.28.1 to 7.65.3: setting it to 1 made \fIcurl_easy_setopt(3)\fP return +an error and leaving the flag untouched. + +From 7.66.0: libcurl treats 1 and 2 to this option the same. .SH RETURN VALUE Returns CURLE_OK if TLS is supported, and CURLE_UNKNOWN_OPTION if not. - -If 1 is set as argument, \fICURLE_BAD_FUNCTION_ARGUMENT\fP is returned. .SH SEE ALSO .BR CURLOPT_CAINFO (3), .BR CURLOPT_PINNEDPUBLICKEY (3), diff --git a/core/curl/files/CURLOPT_SSL_VERIFYPEER.3 b/core/curl/files/CURLOPT_SSL_VERIFYPEER.3 index f97b4704..19fd7dd8 100644 --- a/core/curl/files/CURLOPT_SSL_VERIFYPEER.3 +++ b/core/curl/files/CURLOPT_SSL_VERIFYPEER.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSL_VERIFYPEER.md -.TH CURLOPT_SSL_VERIFYPEER 3 "2024-06-01" libcurl +.TH CURLOPT_SSL_VERIFYPEER 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSL_VERIFYPEER \- verify the peer\(aqs SSL certificate .SH SYNOPSIS @@ -48,7 +48,7 @@ malicious servers. .SH DEFAULT 1 \- enabled .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. All TLS backends support this option. .SH EXAMPLE @@ -67,7 +67,7 @@ int main(void) } .fi .SH AVAILABILITY -If built TLS enabled. +Added in curl 7.4.2 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_SSL_VERIFYSTATUS.3 b/core/curl/files/CURLOPT_SSL_VERIFYSTATUS.3 index d892353d..b144b18e 100644 --- a/core/curl/files/CURLOPT_SSL_VERIFYSTATUS.3 +++ b/core/curl/files/CURLOPT_SSL_VERIFYSTATUS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SSL_VERIFYSTATUS.md -.TH CURLOPT_SSL_VERIFYSTATUS 3 "2024-06-01" libcurl +.TH CURLOPT_SSL_VERIFYSTATUS 3 "2024-07-29" libcurl .SH NAME CURLOPT_SSL_VERIFYSTATUS \- verify the certificate\(aqs status .SH SYNOPSIS @@ -19,7 +19,7 @@ extension, the verification fails. .SH DEFAULT 0 .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS and OpenSSL @@ -39,8 +39,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.41.0. This option is currently only supported by the OpenSSL and -GnuTLS TLS backends. +Added in curl 7.41.0 .SH RETURN VALUE Returns CURLE_OK if OCSP stapling is supported by the SSL backend, otherwise returns CURLE_NOT_BUILT_IN. diff --git a/core/curl/files/CURLOPT_STDERR.3 b/core/curl/files/CURLOPT_STDERR.3 index 5615cbd3..f32da438 100644 --- a/core/curl/files/CURLOPT_STDERR.3 +++ b/core/curl/files/CURLOPT_STDERR.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_STDERR.md -.TH CURLOPT_STDERR 3 "2024-06-01" libcurl +.TH CURLOPT_STDERR 3 "2024-07-29" libcurl .SH NAME CURLOPT_STDERR \- redirect stderr to another stream .SH SYNOPSIS @@ -19,7 +19,7 @@ application. A work\-around is to instead use \fICURLOPT_DEBUGFUNCTION(3)\fP. .SH DEFAULT stderr .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -35,7 +35,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_STREAM_DEPENDS.3 b/core/curl/files/CURLOPT_STREAM_DEPENDS.3 index 36df5c2c..abc32313 100644 --- a/core/curl/files/CURLOPT_STREAM_DEPENDS.3 +++ b/core/curl/files/CURLOPT_STREAM_DEPENDS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_STREAM_DEPENDS.md -.TH CURLOPT_STREAM_DEPENDS 3 "2024-06-01" libcurl +.TH CURLOPT_STREAM_DEPENDS 3 "2024-07-29" libcurl .SH NAME CURLOPT_STREAM_DEPENDS \- stream this transfer depends on .SH SYNOPSIS @@ -27,7 +27,7 @@ option to have an actual effect. .SH DEFAULT NULL .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -46,7 +46,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.46.0 +Added in curl 7.46.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_STREAM_DEPENDS_E.3 b/core/curl/files/CURLOPT_STREAM_DEPENDS_E.3 index 863500eb..33ac3c9a 100644 --- a/core/curl/files/CURLOPT_STREAM_DEPENDS_E.3 +++ b/core/curl/files/CURLOPT_STREAM_DEPENDS_E.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_STREAM_DEPENDS_E.md -.TH CURLOPT_STREAM_DEPENDS_E 3 "2024-06-01" libcurl +.TH CURLOPT_STREAM_DEPENDS_E 3 "2024-07-29" libcurl .SH NAME CURLOPT_STREAM_DEPENDS_E \- stream this transfer depends on exclusively .SH SYNOPSIS @@ -30,7 +30,7 @@ option to have an actual effect. .SH DEFAULT NULL .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -49,7 +49,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.46.0 +Added in curl 7.46.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_STREAM_WEIGHT.3 b/core/curl/files/CURLOPT_STREAM_WEIGHT.3 index 6691a5a2..a2c3640d 100644 --- a/core/curl/files/CURLOPT_STREAM_WEIGHT.3 +++ b/core/curl/files/CURLOPT_STREAM_WEIGHT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_STREAM_WEIGHT.md -.TH CURLOPT_STREAM_WEIGHT 3 "2024-06-01" libcurl +.TH CURLOPT_STREAM_WEIGHT 3 "2024-07-29" libcurl .SH NAME CURLOPT_STREAM_WEIGHT \- numerical stream weight .SH SYNOPSIS @@ -27,10 +27,9 @@ and stream B with weight 32, stream B gets two thirds (32/48) of the available bandwidth (assuming the server can send off the data equally for both streams). .SH DEFAULT -If nothing is set, the HTTP/2 protocol itself uses its own default which is -16. +16 .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -50,7 +49,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.46.0 +Added in curl 7.46.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_SUPPRESS_CONNECT_HEADERS.3 b/core/curl/files/CURLOPT_SUPPRESS_CONNECT_HEADERS.3 index eeb3f193..050a521b 100644 --- a/core/curl/files/CURLOPT_SUPPRESS_CONNECT_HEADERS.3 +++ b/core/curl/files/CURLOPT_SUPPRESS_CONNECT_HEADERS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_SUPPRESS_CONNECT_HEADERS.md -.TH CURLOPT_SUPPRESS_CONNECT_HEADERS 3 "2024-06-01" libcurl +.TH CURLOPT_SUPPRESS_CONNECT_HEADERS 3 "2024-07-29" libcurl .SH NAME CURLOPT_SUPPRESS_CONNECT_HEADERS \- suppress proxy CONNECT response headers .SH SYNOPSIS @@ -51,7 +51,7 @@ Content-Type: application/json .SH DEFAULT 0 .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -73,7 +73,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.54.0 +Added in curl 7.54.0 .SH RETURN VALUE CURLE_OK or an error such as CURLE_UNKNOWN_OPTION. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_TCP_FASTOPEN.3 b/core/curl/files/CURLOPT_TCP_FASTOPEN.3 index 50ce53cb..bf30286c 100644 --- a/core/curl/files/CURLOPT_TCP_FASTOPEN.3 +++ b/core/curl/files/CURLOPT_TCP_FASTOPEN.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_TCP_FASTOPEN.md -.TH CURLOPT_TCP_FASTOPEN 3 "2024-06-01" libcurl +.TH CURLOPT_TCP_FASTOPEN 3 "2024-07-29" libcurl .SH NAME CURLOPT_TCP_FASTOPEN \- TCP Fast Open .SH SYNOPSIS @@ -20,7 +20,7 @@ Fast Open is also known to be problematic on or across certain networks. .SH DEFAULT 0 .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -33,9 +33,10 @@ int main(void) } } .fi +.SH NOTES +This option is only supported on Linux and macOS 10.11 or later. .SH AVAILABILITY -Added in 7.49.0. This option is currently only supported on Linux and macOS -10.11 or later. +Added in curl 7.49.0 .SH RETURN VALUE Returns CURLE_OK if fast open is supported by the operating system, otherwise returns CURLE_NOT_BUILT_IN. diff --git a/core/curl/files/CURLOPT_TCP_KEEPALIVE.3 b/core/curl/files/CURLOPT_TCP_KEEPALIVE.3 index 6007cc76..1ca2f94a 100644 --- a/core/curl/files/CURLOPT_TCP_KEEPALIVE.3 +++ b/core/curl/files/CURLOPT_TCP_KEEPALIVE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_TCP_KEEPALIVE.md -.TH CURLOPT_TCP_KEEPALIVE 3 "2024-06-01" libcurl +.TH CURLOPT_TCP_KEEPALIVE 3 "2024-07-29" libcurl .SH NAME CURLOPT_TCP_KEEPALIVE \- TCP keep\-alive probing .SH SYNOPSIS @@ -11,13 +11,13 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TCP_KEEPALIVE, long probe); .SH DESCRIPTION Pass a long. If set to 1, TCP keepalive probes are used. The delay and frequency of these probes can be controlled by the -\fICURLOPT_TCP_KEEPIDLE(3)\fP and \fICURLOPT_TCP_KEEPINTVL(3)\fP options, -provided the operating system supports them. Set to 0 (default behavior) to -disable keepalive probes +\fICURLOPT_TCP_KEEPIDLE(3)\fP, \fICURLOPT_TCP_KEEPINTVL(3)\fP, and \fICURLOPT_TCP_KEEPCNT(3)\fP +options, provided the operating system supports them. Set to 0 (default behavior) +to disable keepalive probes. .SH DEFAULT 0 .SH PROTOCOLS -All +This functionality affects tcp only .SH EXAMPLE .nf int main(void) @@ -35,16 +35,20 @@ int main(void) /* interval time between keep-alive probes: 60 seconds */ curl_easy_setopt(curl, CURLOPT_TCP_KEEPINTVL, 60L); + /* maximum number of keep-alive probes: 3 */ + curl_easy_setopt(curl, CURLOPT_TCP_KEEPCNT, 3L); + curl_easy_perform(curl); } } .fi .SH AVAILABILITY -Added in 7.25.0 +Added in curl 7.25.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO .BR CURLOPT_LOW_SPEED_LIMIT (3), .BR CURLOPT_MAX_RECV_SPEED_LARGE (3), +.BR CURLOPT_TCP_KEEPCNT (3), .BR CURLOPT_TCP_KEEPIDLE (3), .BR CURLOPT_TCP_KEEPINTVL (3) diff --git a/core/curl/files/CURLOPT_TCP_KEEPCNT.3 b/core/curl/files/CURLOPT_TCP_KEEPCNT.3 new file mode 100644 index 00000000..7d425a75 --- /dev/null +++ b/core/curl/files/CURLOPT_TCP_KEEPCNT.3 @@ -0,0 +1,54 @@ +.\" generated by cd2nroff 0.1 from CURLOPT_TCP_KEEPCNT.md +.TH CURLOPT_TCP_KEEPCNT 3 "2024-07-29" libcurl +.SH NAME +CURLOPT_TCP_KEEPCNT \- Maximum number of TCP keep\-alive probes +.SH SYNOPSIS +.nf +#include + +CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TCP_KEEPCNT, long cnt); +.fi +.SH DESCRIPTION +Pass a long. Sets the number of probes to send before dropping +the connection. Not all operating systems support this option. +(Added in 8.9.0) + +The maximum value this option accepts is INT_MAX or whatever your +system allows. +Any larger value is capped to this amount. +.SH DEFAULT +9 +.SH PROTOCOLS +This functionality affects tcp only +.SH EXAMPLE +.nf +int main(void) +{ + CURL *curl = curl_easy_init(); + if(curl) { + curl_easy_setopt(curl, CURLOPT_URL, "https://example.com"); + + /* enable TCP keep-alive for this transfer */ + curl_easy_setopt(curl, CURLOPT_TCP_KEEPALIVE, 1L); + + /* set keep-alive idle time to 120 seconds */ + curl_easy_setopt(curl, CURLOPT_TCP_KEEPIDLE, 120L); + + /* interval time between keep-alive probes: 60 seconds */ + curl_easy_setopt(curl, CURLOPT_TCP_KEEPINTVL, 60L); + + /* maximum number of keep-alive probes: 3 */ + curl_easy_setopt(curl, CURLOPT_TCP_KEEPCNT, 3L); + + curl_easy_perform(curl); + } +} +.fi +.SH AVAILABILITY +Added in curl 8.9.0 +.SH RETURN VALUE +Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. +.SH SEE ALSO +.BR CURLOPT_TCP_KEEPALIVE (3), +.BR CURLOPT_TCP_KEEPIDLE (3), +.BR CURLOPT_TCP_KEEPINTVL (3) diff --git a/core/curl/files/CURLOPT_TCP_KEEPIDLE.3 b/core/curl/files/CURLOPT_TCP_KEEPIDLE.3 index f964b5a1..ef7f49e7 100644 --- a/core/curl/files/CURLOPT_TCP_KEEPIDLE.3 +++ b/core/curl/files/CURLOPT_TCP_KEEPIDLE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_TCP_KEEPIDLE.md -.TH CURLOPT_TCP_KEEPIDLE 3 "2024-06-01" libcurl +.TH CURLOPT_TCP_KEEPIDLE 3 "2024-07-29" libcurl .SH NAME CURLOPT_TCP_KEEPIDLE \- TCP keep\-alive idle time wait .SH SYNOPSIS @@ -18,7 +18,7 @@ this amount. .SH DEFAULT 60 .SH PROTOCOLS -All +This functionality affects tcp only .SH EXAMPLE .nf int main(void) @@ -36,14 +36,18 @@ int main(void) /* interval time between keep-alive probes: 60 seconds */ curl_easy_setopt(curl, CURLOPT_TCP_KEEPINTVL, 60L); + /* maximum number of keep-alive probes: 3 */ + curl_easy_setopt(curl, CURLOPT_TCP_KEEPCNT, 3L); + curl_easy_perform(curl); } } .fi .SH AVAILABILITY -Added in 7.25.0 +Added in curl 7.25.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO .BR CURLOPT_TCP_KEEPALIVE (3), +.BR CURLOPT_TCP_KEEPCNT (3), .BR CURLOPT_TCP_KEEPINTVL (3) diff --git a/core/curl/files/CURLOPT_TCP_KEEPINTVL.3 b/core/curl/files/CURLOPT_TCP_KEEPINTVL.3 index 9e3a2e85..37b43bcb 100644 --- a/core/curl/files/CURLOPT_TCP_KEEPINTVL.3 +++ b/core/curl/files/CURLOPT_TCP_KEEPINTVL.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_TCP_KEEPINTVL.md -.TH CURLOPT_TCP_KEEPINTVL 3 "2024-06-01" libcurl +.TH CURLOPT_TCP_KEEPINTVL 3 "2024-07-29" libcurl .SH NAME CURLOPT_TCP_KEEPINTVL \- TCP keep\-alive interval .SH SYNOPSIS @@ -17,7 +17,7 @@ this amount. .SH DEFAULT 60 .SH PROTOCOLS -All +This functionality affects tcp only .SH EXAMPLE .nf int main(void) @@ -35,14 +35,18 @@ int main(void) /* interval time between keep-alive probes: 60 seconds */ curl_easy_setopt(curl, CURLOPT_TCP_KEEPINTVL, 60L); + /* maximum number of keep-alive probes: 3 */ + curl_easy_setopt(curl, CURLOPT_TCP_KEEPCNT, 3L); + curl_easy_perform(curl); } } .fi .SH AVAILABILITY -Always +Added in curl 7.25.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO .BR CURLOPT_TCP_KEEPALIVE (3), +.BR CURLOPT_TCP_KEEPCNT (3), .BR CURLOPT_TCP_KEEPIDLE (3) diff --git a/core/curl/files/CURLOPT_TCP_NODELAY.3 b/core/curl/files/CURLOPT_TCP_NODELAY.3 index 09d2388e..1bd046a1 100644 --- a/core/curl/files/CURLOPT_TCP_NODELAY.3 +++ b/core/curl/files/CURLOPT_TCP_NODELAY.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_TCP_NODELAY.md -.TH CURLOPT_TCP_NODELAY 3 "2024-06-01" libcurl +.TH CURLOPT_TCP_NODELAY 3 "2024-07-29" libcurl .SH NAME CURLOPT_TCP_NODELAY \- the TCP_NODELAY option .SH SYNOPSIS @@ -26,7 +26,7 @@ overdone. .SH DEFAULT 1 .SH PROTOCOLS -All +This functionality affects tcp only .SH EXAMPLE .nf int main(void) @@ -40,8 +40,10 @@ int main(void) } } .fi +.SH HISTORY +The default was changed to 1 from 0 in 7.50.2. .SH AVAILABILITY -Always. The default was changed to 1 from 0 in 7.50.2. +Added in curl 7.11.2 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_TELNETOPTIONS.3 b/core/curl/files/CURLOPT_TELNETOPTIONS.3 index 7a8fdd6b..608891bb 100644 --- a/core/curl/files/CURLOPT_TELNETOPTIONS.3 +++ b/core/curl/files/CURLOPT_TELNETOPTIONS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_TELNETOPTIONS.md -.TH CURLOPT_TELNETOPTIONS 3 "2024-06-01" libcurl +.TH CURLOPT_TELNETOPTIONS 3 "2024-07-29" libcurl .SH NAME CURLOPT_TELNETOPTIONS \- set of telnet options .SH SYNOPSIS @@ -17,7 +17,7 @@ standard for details. .SH DEFAULT NULL .SH PROTOCOLS -TELNET +This functionality affects telnet only .SH EXAMPLE .nf int main(void) @@ -37,7 +37,7 @@ int main(void) } .fi .SH AVAILABILITY -Along with TELNET +Added in curl 7.7 .SH RETURN VALUE Returns CURLE_OK if TELNET is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_TFTP_BLKSIZE.3 b/core/curl/files/CURLOPT_TFTP_BLKSIZE.3 index 66461e69..c73c64f6 100644 --- a/core/curl/files/CURLOPT_TFTP_BLKSIZE.3 +++ b/core/curl/files/CURLOPT_TFTP_BLKSIZE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_TFTP_BLKSIZE.md -.TH CURLOPT_TFTP_BLKSIZE 3 "2024-06-01" libcurl +.TH CURLOPT_TFTP_BLKSIZE 3 "2024-07-29" libcurl .SH NAME CURLOPT_TFTP_BLKSIZE \- TFTP block size .SH SYNOPSIS @@ -18,7 +18,7 @@ is used. .SH DEFAULT 512 .SH PROTOCOLS -TFTP +This functionality affects tftp only .SH EXAMPLE .nf int main(void) @@ -35,7 +35,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.19.4 +Added in curl 7.19.4 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_TFTP_NO_OPTIONS.3 b/core/curl/files/CURLOPT_TFTP_NO_OPTIONS.3 index a8d8667b..21ec6e95 100644 --- a/core/curl/files/CURLOPT_TFTP_NO_OPTIONS.3 +++ b/core/curl/files/CURLOPT_TFTP_NO_OPTIONS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_TFTP_NO_OPTIONS.md -.TH CURLOPT_TFTP_NO_OPTIONS 3 "2024-06-01" libcurl +.TH CURLOPT_TFTP_NO_OPTIONS 3 "2024-07-29" libcurl .SH NAME CURLOPT_TFTP_NO_OPTIONS \- send no TFTP options requests .SH SYNOPSIS @@ -18,7 +18,7 @@ acknowledge or properly implement TFTP options. When this option is used .SH DEFAULT 0 .SH PROTOCOLS -TFTP +This functionality affects tftp only .SH EXAMPLE .nf size_t write_callback(char *ptr, size_t size, size_t nmemb, void *fp) @@ -50,7 +50,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.48.0 +Added in curl 7.48.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_TIMECONDITION.3 b/core/curl/files/CURLOPT_TIMECONDITION.3 index 74f65bd9..b6c91087 100644 --- a/core/curl/files/CURLOPT_TIMECONDITION.3 +++ b/core/curl/files/CURLOPT_TIMECONDITION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_TIMECONDITION.md -.TH CURLOPT_TIMECONDITION 3 "2024-06-01" libcurl +.TH CURLOPT_TIMECONDITION 3 "2024-07-29" libcurl .SH NAME CURLOPT_TIMECONDITION \- select condition for a time request .SH SYNOPSIS @@ -21,7 +21,7 @@ option can be used after a transfer to learn if a zero\-byte successful .SH DEFAULT CURL_TIMECOND_NONE (0) .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -43,7 +43,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_TIMEOUT.3 b/core/curl/files/CURLOPT_TIMEOUT.3 index 0cc14462..dc857b50 100644 --- a/core/curl/files/CURLOPT_TIMEOUT.3 +++ b/core/curl/files/CURLOPT_TIMEOUT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_TIMEOUT.md -.TH CURLOPT_TIMEOUT 3 "2024-06-01" libcurl +.TH CURLOPT_TIMEOUT 3 "2024-07-29" libcurl .SH NAME CURLOPT_TIMEOUT \- maximum time the transfer is allowed to complete .SH SYNOPSIS @@ -39,9 +39,9 @@ This option may cause libcurl to use the SIGALRM signal to timeout system calls on builds not using asynch DNS. In unix\-like systems, this might cause signals to be used unless \fICURLOPT_NOSIGNAL(3)\fP is set. .SH DEFAULT -Default timeout is 0 (zero) which means it never times out during transfer. +0 (zero) which means it never times out during transfer. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -58,7 +58,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK. Returns CURLE_BAD_FUNCTION_ARGUMENT if set to a negative value or a value that when converted to milliseconds is too large. diff --git a/core/curl/files/CURLOPT_TIMEOUT_MS.3 b/core/curl/files/CURLOPT_TIMEOUT_MS.3 index ac9bed11..1604fb51 100644 --- a/core/curl/files/CURLOPT_TIMEOUT_MS.3 +++ b/core/curl/files/CURLOPT_TIMEOUT_MS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_TIMEOUT_MS.md -.TH CURLOPT_TIMEOUT_MS 3 "2024-06-01" libcurl +.TH CURLOPT_TIMEOUT_MS 3 "2024-07-29" libcurl .SH NAME CURLOPT_TIMEOUT_MS \- maximum time the transfer is allowed to complete .SH SYNOPSIS @@ -14,9 +14,9 @@ milliseconds that you allow the libcurl transfer operation to take. See \fICURLOPT_TIMEOUT(3)\fP for details. .SH DEFAULT -Default timeout is 0 (zero) which means it never times out during transfer. +0 (zero) which means it never times out during transfer. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -33,7 +33,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.16.2 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_TIMEVALUE.3 b/core/curl/files/CURLOPT_TIMEVALUE.3 index 420af6cc..794af677 100644 --- a/core/curl/files/CURLOPT_TIMEVALUE.3 +++ b/core/curl/files/CURLOPT_TIMEVALUE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_TIMEVALUE.md -.TH CURLOPT_TIMEVALUE 3 "2024-06-01" libcurl +.TH CURLOPT_TIMEVALUE 3 "2024-07-29" libcurl .SH NAME CURLOPT_TIMEVALUE \- time value for conditional .SH SYNOPSIS @@ -13,13 +13,13 @@ Pass a long \fIval\fP as parameter. This should be the time counted as seconds since 1 Jan 1970, and the time is used in a condition as specified with \fICURLOPT_TIMECONDITION(3)\fP. -On systems with 32 bit \(aqlong\(aq variables (such as Windows), this option cannot +On systems with 32\-bit \(aqlong\(aq variables (such as Windows), this option cannot set dates beyond the year 2038. Consider \fICURLOPT_TIMEVALUE_LARGE(3)\fP instead. .SH DEFAULT 0 .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -40,7 +40,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_TIMEVALUE_LARGE.3 b/core/curl/files/CURLOPT_TIMEVALUE_LARGE.3 index 8e407316..5a3eb5ee 100644 --- a/core/curl/files/CURLOPT_TIMEVALUE_LARGE.3 +++ b/core/curl/files/CURLOPT_TIMEVALUE_LARGE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_TIMEVALUE_LARGE.md -.TH CURLOPT_TIMEVALUE_LARGE 3 "2024-06-01" libcurl +.TH CURLOPT_TIMEVALUE_LARGE 3 "2024-07-29" libcurl .SH NAME CURLOPT_TIMEVALUE_LARGE \- time value for conditional .SH SYNOPSIS @@ -14,13 +14,13 @@ Pass a curl_off_t \fIval\fP as parameter. This should be the time counted as seconds since 1 Jan 1970, and the time is used in a condition as specified with \fICURLOPT_TIMECONDITION(3)\fP. -The difference between this option and \fICURLOPT_TIMEVALUE(3)\fP is the type -of the argument. On systems where \(aqlong\(aq is only 32 bit wide, this option has -to be used to set dates beyond the year 2038. +The difference between this option and \fICURLOPT_TIMEVALUE(3)\fP is the type of the +argument. On systems where \(aqlong\(aq is only 32 bits wide, this option has to be +used to set dates beyond the year 2038. .SH DEFAULT 0 .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -41,7 +41,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.59.0. +Added in curl 7.59.0 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_TLS13_CIPHERS.3 b/core/curl/files/CURLOPT_TLS13_CIPHERS.3 index 4700fefd..2d672e42 100644 --- a/core/curl/files/CURLOPT_TLS13_CIPHERS.3 +++ b/core/curl/files/CURLOPT_TLS13_CIPHERS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_TLS13_CIPHERS.md -.TH CURLOPT_TLS13_CIPHERS 3 "2024-06-01" libcurl +.TH CURLOPT_TLS13_CIPHERS 3 "2024-07-29" libcurl .SH NAME CURLOPT_TLS13_CIPHERS \- ciphers suites to use for TLS 1.3 .SH SYNOPSIS @@ -26,9 +26,9 @@ option. The application does not have to keep the string around after setting this option. .SH DEFAULT -NULL, use internal default +NULL, use internal built\-in .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: OpenSSL and Schannel @@ -47,10 +47,12 @@ int main(void) } } .fi -.SH AVAILABILITY +.SH HISTORY Added in 7.61.0 for OpenSSL. Available when built with OpenSSL >= 1.1.1. Added in 7.85.0 for Schannel. +.SH AVAILABILITY +Added in curl 7.61.0 .SH RETURN VALUE Returns CURLE_OK if supported, CURLE_NOT_BUILT_IN otherwise. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_TLSAUTH_PASSWORD.3 b/core/curl/files/CURLOPT_TLSAUTH_PASSWORD.3 index 7ade4f1d..ad307304 100644 --- a/core/curl/files/CURLOPT_TLSAUTH_PASSWORD.3 +++ b/core/curl/files/CURLOPT_TLSAUTH_PASSWORD.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_TLSAUTH_PASSWORD.md -.TH CURLOPT_TLSAUTH_PASSWORD 3 "2024-06-01" libcurl +.TH CURLOPT_TLSAUTH_PASSWORD 3 "2024-07-29" libcurl .SH NAME CURLOPT_TLSAUTH_PASSWORD \- password to use for TLS authentication .SH SYNOPSIS @@ -11,17 +11,17 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TLSAUTH_PASSWORD, char *pwd); .SH DESCRIPTION Pass a char pointer as parameter, which should point to the null\-terminated password to use for the TLS authentication method specified with the -\fICURLOPT_TLSAUTH_TYPE(3)\fP option. Requires that the -\fICURLOPT_TLSAUTH_USERNAME(3)\fP option also be set. +\fICURLOPT_TLSAUTH_TYPE(3)\fP option. Requires that the \fICURLOPT_TLSAUTH_USERNAME(3)\fP +option also be set. The application does not have to keep the string around after setting this option. -This feature relies in TLS SRP which does not work with TLS 1.3. +This feature relies on TLS SRP which does not work with TLS 1.3. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS and OpenSSL @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.21.4, with the OpenSSL and GnuTLS backends only +Added in curl 7.21.4 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_TLSAUTH_TYPE.3 b/core/curl/files/CURLOPT_TLSAUTH_TYPE.3 index c9b97282..e0a86e52 100644 --- a/core/curl/files/CURLOPT_TLSAUTH_TYPE.3 +++ b/core/curl/files/CURLOPT_TLSAUTH_TYPE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_TLSAUTH_TYPE.md -.TH CURLOPT_TLSAUTH_TYPE 3 "2024-06-01" libcurl +.TH CURLOPT_TLSAUTH_TYPE 3 "2024-07-29" libcurl .SH NAME CURLOPT_TLSAUTH_TYPE \- TLS authentication methods .SH SYNOPSIS @@ -15,17 +15,13 @@ the method of the TLS authentication. Supported method is "SRP". TLS\-SRP authentication. Secure Remote Password authentication for TLS is defined in RFC 5054 and provides mutual authentication if both sides have a shared secret. To use TLS\-SRP, you must also set the -\fICURLOPT_TLSAUTH_USERNAME(3)\fP and \fICURLOPT_TLSAUTH_PASSWORD(3)\fP -options. - -The application does not have to keep the string around after setting this -option. +\fICURLOPT_TLSAUTH_USERNAME(3)\fP and \fICURLOPT_TLSAUTH_PASSWORD(3)\fP options. TLS SRP does not work with TLS 1.3. .SH DEFAULT blank .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS and OpenSSL @@ -46,8 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -You need to build libcurl with GnuTLS or OpenSSL with TLS\-SRP support for this -to work. Added in 7.21.4 +Added in curl 7.21.4 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_TLSAUTH_USERNAME.3 b/core/curl/files/CURLOPT_TLSAUTH_USERNAME.3 index a5ed8951..7a7d0e3b 100644 --- a/core/curl/files/CURLOPT_TLSAUTH_USERNAME.3 +++ b/core/curl/files/CURLOPT_TLSAUTH_USERNAME.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_TLSAUTH_USERNAME.md -.TH CURLOPT_TLSAUTH_USERNAME 3 "2024-06-01" libcurl +.TH CURLOPT_TLSAUTH_USERNAME 3 "2024-07-29" libcurl .SH NAME CURLOPT_TLSAUTH_USERNAME \- username to use for TLS authentication .SH SYNOPSIS @@ -11,17 +11,17 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TLSAUTH_USERNAME, char *user); .SH DESCRIPTION Pass a char pointer as parameter, which should point to the null\-terminated username to use for the TLS authentication method specified with the -\fICURLOPT_TLSAUTH_TYPE(3)\fP option. Requires that the -\fICURLOPT_TLSAUTH_PASSWORD(3)\fP option also be set. +\fICURLOPT_TLSAUTH_TYPE(3)\fP option. Requires that the \fICURLOPT_TLSAUTH_PASSWORD(3)\fP +option also be set. The application does not have to keep the string around after setting this option. -This feature relies in TLS SRP which does not work with TLS 1.3. +This feature relies on TLS SRP which does not work with TLS 1.3. .SH DEFAULT NULL .SH PROTOCOLS -All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. +This functionality affects all TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc. This option works only with the following TLS backends: GnuTLS and OpenSSL @@ -42,7 +42,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.21.4, with the OpenSSL and GnuTLS backends only +Added in curl 7.21.4 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_TRAILERDATA.3 b/core/curl/files/CURLOPT_TRAILERDATA.3 index d26711cb..697d382e 100644 --- a/core/curl/files/CURLOPT_TRAILERDATA.3 +++ b/core/curl/files/CURLOPT_TRAILERDATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_TRAILERDATA.md -.TH CURLOPT_TRAILERDATA 3 "2024-06-01" libcurl +.TH CURLOPT_TRAILERDATA 3 "2024-07-29" libcurl .SH NAME CURLOPT_TRAILERDATA \- pointer passed to trailing headers callback .SH SYNOPSIS @@ -13,7 +13,7 @@ Data pointer to be passed to the HTTP trailer callback function. .SH DEFAULT NULL .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf struct MyData { @@ -30,7 +30,7 @@ int main(void) } .fi .SH AVAILABILITY -This option was added in curl 7.64.0 and is present if HTTP support is enabled +Added in curl 7.64.0 .SH RETURN VALUE Returns CURLE_OK. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_TRAILERFUNCTION.3 b/core/curl/files/CURLOPT_TRAILERFUNCTION.3 index a79ab9da..61b775c7 100644 --- a/core/curl/files/CURLOPT_TRAILERFUNCTION.3 +++ b/core/curl/files/CURLOPT_TRAILERFUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_TRAILERFUNCTION.md -.TH CURLOPT_TRAILERFUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_TRAILERFUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_TRAILERFUNCTION \- callback for sending trailing headers .SH SYNOPSIS @@ -41,7 +41,7 @@ without any interruptions. .SH DEFAULT NULL .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf static int trailer_cb(struct curl_slist **tr, void *data) @@ -60,7 +60,7 @@ int main(void) /* Set the URL of the request */ curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/"); /* Now set it as a put */ - curl_easy_setopt(curl, CURLOPT_PUT, 1L); + curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L); /* Assuming we have a function that returns the data to be pushed Let that function be read_cb */ @@ -83,7 +83,7 @@ int main(void) } .fi .SH AVAILABILITY -This option was added in curl 7.64.0 and is present if HTTP support is enabled. +Added in curl 7.64.0 .SH RETURN VALUE Returns CURLE_OK. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_TRANSFERTEXT.3 b/core/curl/files/CURLOPT_TRANSFERTEXT.3 index 872b9c7a..5a289e51 100644 --- a/core/curl/files/CURLOPT_TRANSFERTEXT.3 +++ b/core/curl/files/CURLOPT_TRANSFERTEXT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_TRANSFERTEXT.md -.TH CURLOPT_TRANSFERTEXT 3 "2024-06-01" libcurl +.TH CURLOPT_TRANSFERTEXT 3 "2024-07-29" libcurl .SH NAME CURLOPT_TRANSFERTEXT \- request a text based transfer for FTP .SH SYNOPSIS @@ -21,7 +21,7 @@ simply sets the mode to ASCII and performs a standard transfer. .SH DEFAULT 0, disabled .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -37,7 +37,7 @@ int main(void) } .fi .SH AVAILABILITY -Along with FTP +Added in curl 7.1.1 .SH RETURN VALUE Returns CURLE_OK if FTP is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_TRANSFER_ENCODING.3 b/core/curl/files/CURLOPT_TRANSFER_ENCODING.3 index 9c18b477..cef2ac26 100644 --- a/core/curl/files/CURLOPT_TRANSFER_ENCODING.3 +++ b/core/curl/files/CURLOPT_TRANSFER_ENCODING.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_TRANSFER_ENCODING.md -.TH CURLOPT_TRANSFER_ENCODING 3 "2024-06-01" libcurl +.TH CURLOPT_TRANSFER_ENCODING 3 "2024-07-29" libcurl .SH NAME CURLOPT_TRANSFER_ENCODING \- ask for HTTP Transfer Encoding .SH SYNOPSIS @@ -25,7 +25,7 @@ by both HTTP clients and HTTP servers. .SH DEFAULT 0 .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -39,7 +39,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.21.6 +Added in curl 7.21.6 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_UNIX_SOCKET_PATH.3 b/core/curl/files/CURLOPT_UNIX_SOCKET_PATH.3 index 7373a6e3..a3e651ba 100644 --- a/core/curl/files/CURLOPT_UNIX_SOCKET_PATH.3 +++ b/core/curl/files/CURLOPT_UNIX_SOCKET_PATH.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_UNIX_SOCKET_PATH.md -.TH CURLOPT_UNIX_SOCKET_PATH 3 "2024-06-01" libcurl +.TH CURLOPT_UNIX_SOCKET_PATH 3 "2024-07-29" libcurl .SH NAME CURLOPT_UNIX_SOCKET_PATH \- Unix domain socket .SH SYNOPSIS @@ -28,9 +28,9 @@ Unix domain socket is not possible. The application does not have to keep the string around after setting this option. .SH DEFAULT -Default is NULL, meaning that no Unix domain sockets are used. +NULL \- no Unix domain sockets are used. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -56,7 +56,7 @@ you can use the proc filesystem to bypass the limitation: /* Be sure to keep dirfd valid until you discard the handle */ .fi .SH AVAILABILITY -Added in 7.40.0. +Added in curl 7.40.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_UNRESTRICTED_AUTH.3 b/core/curl/files/CURLOPT_UNRESTRICTED_AUTH.3 index b4f3ab05..06146f02 100644 --- a/core/curl/files/CURLOPT_UNRESTRICTED_AUTH.3 +++ b/core/curl/files/CURLOPT_UNRESTRICTED_AUTH.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_UNRESTRICTED_AUTH.md -.TH CURLOPT_UNRESTRICTED_AUTH 3 "2024-06-01" libcurl +.TH CURLOPT_UNRESTRICTED_AUTH 3 "2024-07-29" libcurl .SH NAME CURLOPT_UNRESTRICTED_AUTH \- send credentials to other hosts too .SH SYNOPSIS @@ -31,7 +31,7 @@ again and again as the following hosts can keep redirecting to new hosts. .SH DEFAULT 0 .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -46,7 +46,7 @@ int main(void) } .fi .SH AVAILABILITY -Along with HTTP +Added in curl 7.10.4 .SH RETURN VALUE Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_UPKEEP_INTERVAL_MS.3 b/core/curl/files/CURLOPT_UPKEEP_INTERVAL_MS.3 index 80940770..8811aec8 100644 --- a/core/curl/files/CURLOPT_UPKEEP_INTERVAL_MS.3 +++ b/core/curl/files/CURLOPT_UPKEEP_INTERVAL_MS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_UPKEEP_INTERVAL_MS.md -.TH CURLOPT_UPKEEP_INTERVAL_MS 3 "2024-06-01" libcurl +.TH CURLOPT_UPKEEP_INTERVAL_MS 3 "2024-07-29" libcurl .SH NAME CURLOPT_UPKEEP_INTERVAL_MS \- connection upkeep interval .SH SYNOPSIS @@ -24,7 +24,7 @@ is called, an HTTP/2 PING frame is sent on the connection. .SH DEFAULT CURL_UPKEEP_INTERVAL_DEFAULT (currently defined as 60000L, which is 60 seconds) .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -54,7 +54,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.62.0 +Added in curl 7.62.0 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_UPLOAD.3 b/core/curl/files/CURLOPT_UPLOAD.3 index 3b1b5dd6..ca6cc6e8 100644 --- a/core/curl/files/CURLOPT_UPLOAD.3 +++ b/core/curl/files/CURLOPT_UPLOAD.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_UPLOAD.md -.TH CURLOPT_UPLOAD 3 "2024-06-01" libcurl +.TH CURLOPT_UPLOAD 3 "2024-07-29" libcurl .SH NAME CURLOPT_UPLOAD \- data upload .SH SYNOPSIS @@ -10,23 +10,23 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_UPLOAD, long upload); .fi .SH DESCRIPTION The long parameter \fIupload\fP set to 1 tells the library to prepare for and -perform an upload. The \fICURLOPT_READDATA(3)\fP and -\fICURLOPT_INFILESIZE(3)\fP or \fICURLOPT_INFILESIZE_LARGE(3)\fP options are -also interesting for uploads. If the protocol is HTTP, uploading means using -the PUT request unless you tell libcurl otherwise. +perform an upload. The \fICURLOPT_READDATA(3)\fP and \fICURLOPT_INFILESIZE(3)\fP or +\fICURLOPT_INFILESIZE_LARGE(3)\fP options are also interesting for uploads. If the +protocol is HTTP, uploading means using the PUT request unless you tell +libcurl otherwise. Using PUT with HTTP 1.1 implies the use of a "Expect: 100\-continue" header. You can disable this header with \fICURLOPT_HTTPHEADER(3)\fP as usual. If you use PUT to an HTTP 1.1 server, you can upload data without knowing the size before starting the transfer. The library enables this by adding a header -\&"Transfer\-Encoding: chunked". With HTTP 1.0 or if you prefer not to use chunked -transfer, you must specify the size of the data with +\&"Transfer\-Encoding: chunked". With HTTP 1.0 or if you prefer not to use +chunked transfer, you must specify the size of the data with \fICURLOPT_INFILESIZE(3)\fP or \fICURLOPT_INFILESIZE_LARGE(3)\fP. .SH DEFAULT -0, default is download +0 .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf static size_t read_cb(char *ptr, size_t size, size_t nmemb, void *userdata) @@ -67,7 +67,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_UPLOAD_BUFFERSIZE.3 b/core/curl/files/CURLOPT_UPLOAD_BUFFERSIZE.3 index 0d2f8756..ab730e72 100644 --- a/core/curl/files/CURLOPT_UPLOAD_BUFFERSIZE.3 +++ b/core/curl/files/CURLOPT_UPLOAD_BUFFERSIZE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_UPLOAD_BUFFERSIZE.md -.TH CURLOPT_UPLOAD_BUFFERSIZE 3 "2024-06-01" libcurl +.TH CURLOPT_UPLOAD_BUFFERSIZE 3 "2024-07-29" libcurl .SH NAME CURLOPT_UPLOAD_BUFFERSIZE \- upload buffer size .SH SYNOPSIS @@ -30,7 +30,7 @@ transfer as that may lead to unintended consequences. .SH DEFAULT 65536 bytes .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -50,7 +50,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.62.0. +Added in curl 7.62.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_URL.3 b/core/curl/files/CURLOPT_URL.3 index bc18efee..cb3d49bd 100644 --- a/core/curl/files/CURLOPT_URL.3 +++ b/core/curl/files/CURLOPT_URL.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_URL.md -.TH CURLOPT_URL 3 "2024-06-01" libcurl +.TH CURLOPT_URL 3 "2024-07-29" libcurl .SH NAME CURLOPT_URL \- URL for this transfer .SH SYNOPSIS @@ -60,8 +60,7 @@ UTF\-8 (when winidn is used; or a Windows Unicode build using libidn2). If libcurl is built without IDN support, the server name is used exactly as specified when passed to the name resolver functions. .SH DEFAULT -There is no default URL. If this option is not set, no transfer can be -performed. +NULL. If this option is not set, no transfer can be performed. .SH SECURITY CONCERNS Applications may at times find it convenient to allow users to specify URLs for various purposes and that string would then end up fed to this option. @@ -80,13 +79,13 @@ custom port number can allow external users to play tricks with your local services. Accepting external URLs may also use other protocols than http:// or other -common ones. Restrict what accept with \fICURLOPT_PROTOCOLS(3)\fP. +common ones. Restrict what accept with \fICURLOPT_PROTOCOLS_STR(3)\fP. User provided URLs can also be made to point to sites that redirect further on (possibly to other protocols too). Consider your -\fICURLOPT_FOLLOWLOCATION(3)\fP and \fICURLOPT_REDIR_PROTOCOLS(3)\fP settings. +\fICURLOPT_FOLLOWLOCATION(3)\fP and \fICURLOPT_REDIR_PROTOCOLS_STR(3)\fP settings. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -100,7 +99,7 @@ int main(void) } .fi .SH AVAILABILITY -POP3 and SMTP were added in 7.31.0 +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK on success or CURLE_OUT_OF_MEMORY if there was insufficient heap space. @@ -114,7 +113,7 @@ called. .BR CURLOPT_FORBID_REUSE (3), .BR CURLOPT_FRESH_CONNECT (3), .BR CURLOPT_PATH_AS_IS (3), -.BR CURLOPT_PROTOCOLS (3), +.BR CURLOPT_PROTOCOLS_STR (3), .BR curl_easy_perform (3), .BR curl_url_get (3), .BR curl_url_set (3) diff --git a/core/curl/files/CURLOPT_USERAGENT.3 b/core/curl/files/CURLOPT_USERAGENT.3 index 8e86e163..4e64f45c 100644 --- a/core/curl/files/CURLOPT_USERAGENT.3 +++ b/core/curl/files/CURLOPT_USERAGENT.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_USERAGENT.md -.TH CURLOPT_USERAGENT 3 "2024-06-01" libcurl +.TH CURLOPT_USERAGENT 3 "2024-07-29" libcurl .SH NAME CURLOPT_USERAGENT \- HTTP user\-agent header .SH SYNOPSIS @@ -16,9 +16,9 @@ can also set any custom header with \fICURLOPT_HTTPHEADER(3)\fP. The application does not have to keep the string around after setting this option. .SH DEFAULT -NULL, no User\-Agent: header is used by default. +NULL, no User\-Agent: header is used. .SH PROTOCOLS -HTTP +This functionality affects http only .SH EXAMPLE .nf int main(void) @@ -34,7 +34,7 @@ int main(void) } .fi .SH AVAILABILITY -As long as HTTP is supported +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK if HTTP is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_USERNAME.3 b/core/curl/files/CURLOPT_USERNAME.3 index 87450de4..5ca03e08 100644 --- a/core/curl/files/CURLOPT_USERNAME.3 +++ b/core/curl/files/CURLOPT_USERNAME.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_USERNAME.md -.TH CURLOPT_USERNAME 3 "2024-06-01" libcurl +.TH CURLOPT_USERNAME 3 "2024-07-29" libcurl .SH NAME CURLOPT_USERNAME \- username to use in authentication .SH SYNOPSIS @@ -40,7 +40,7 @@ option. .SH DEFAULT blank .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -59,7 +59,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.19.1 +Added in curl 7.19.1 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_USERPWD.3 b/core/curl/files/CURLOPT_USERPWD.3 index 3fa29a0a..c215dc67 100644 --- a/core/curl/files/CURLOPT_USERPWD.3 +++ b/core/curl/files/CURLOPT_USERPWD.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_USERPWD.md -.TH CURLOPT_USERPWD 3 "2024-06-01" libcurl +.TH CURLOPT_USERPWD 3 "2024-07-29" libcurl .SH NAME CURLOPT_USERPWD \- username and password to use in authentication .SH SYNOPSIS @@ -47,7 +47,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -66,7 +66,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK on success or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLOPT_USE_SSL.3 b/core/curl/files/CURLOPT_USE_SSL.3 index abdfeb9a..f8db1674 100644 --- a/core/curl/files/CURLOPT_USE_SSL.3 +++ b/core/curl/files/CURLOPT_USE_SSL.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_USE_SSL.md -.TH CURLOPT_USE_SSL 3 "2024-06-01" libcurl +.TH CURLOPT_USE_SSL 3 "2024-07-29" libcurl .SH NAME CURLOPT_USE_SSL \- request using SSL / TLS for the transfer .SH SYNOPSIS @@ -28,7 +28,7 @@ Require SSL for all communication or fail with \fICURLE_USE_SSL_FAILED\fP. .SH DEFAULT CURLUSESSL_NONE .SH PROTOCOLS -FTP, IMAP, POP3 and SMTP +This functionality affects ftp, imap, pop3 and smtp .SH EXAMPLE .nf int main(void) @@ -45,10 +45,12 @@ int main(void) } } .fi +.SH HISTORY +This option was known as CURLOPT_FTP_SSL up to 7.16.4, and the constants were +known as CURLFTPSSL_* Handled by LDAP since 7.81.0. Fully supported by the +OpenLDAP backend only. .SH AVAILABILITY -Added in 7.11.0. This option was known as CURLOPT_FTP_SSL up to 7.16.4, and -the constants were known as CURLFTPSSL_* -Handled by LDAP since 7.81.0. Fully supported by the OpenLDAP backend only. +Added in curl 7.17.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_VERBOSE.3 b/core/curl/files/CURLOPT_VERBOSE.3 index 6e3bb85a..c8375f80 100644 --- a/core/curl/files/CURLOPT_VERBOSE.3 +++ b/core/curl/files/CURLOPT_VERBOSE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_VERBOSE.md -.TH CURLOPT_VERBOSE 3 "2024-06-01" libcurl +.TH CURLOPT_VERBOSE 3 "2024-07-29" libcurl .SH NAME CURLOPT_VERBOSE \- verbose mode .SH SYNOPSIS @@ -22,7 +22,7 @@ To also get all the protocol data sent and received, consider using the .SH DEFAULT 0, meaning disabled. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -40,7 +40,7 @@ int main(void) } .fi .SH AVAILABILITY -Always +Added in curl 7.1 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_WILDCARDMATCH.3 b/core/curl/files/CURLOPT_WILDCARDMATCH.3 index 718fe15f..118291a6 100644 --- a/core/curl/files/CURLOPT_WILDCARDMATCH.3 +++ b/core/curl/files/CURLOPT_WILDCARDMATCH.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_WILDCARDMATCH.md -.TH CURLOPT_WILDCARDMATCH 3 "2024-06-01" libcurl +.TH CURLOPT_WILDCARDMATCH 3 "2024-07-29" libcurl .SH NAME CURLOPT_WILDCARDMATCH \- directory wildcard transfers .SH SYNOPSIS @@ -58,7 +58,7 @@ Using the rules above, a filename pattern can be constructed: ftp://example.com/some/path/[a-z[:upper:]\\].jpg .fi .SH PROTOCOLS -FTP +This functionality affects ftp only .SH EXAMPLE .nf extern long begin_cb(struct curl_fileinfo *, void *, int); @@ -82,7 +82,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.21.0 +Added in curl 7.21.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_WRITEDATA.3 b/core/curl/files/CURLOPT_WRITEDATA.3 index b70f17a5..301449f0 100644 --- a/core/curl/files/CURLOPT_WRITEDATA.3 +++ b/core/curl/files/CURLOPT_WRITEDATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_WRITEDATA.md -.TH CURLOPT_WRITEDATA 3 "2024-06-01" libcurl +.TH CURLOPT_WRITEDATA 3 "2024-07-29" libcurl .SH NAME CURLOPT_WRITEDATA \- pointer passed to the write callback .SH SYNOPSIS @@ -22,18 +22,20 @@ If you are using libcurl as a Windows DLL, you \fBMUST\fP use a \fICURLOPT_WRITEFUNCTION(3)\fP if you set this option or you might experience crashes. .SH DEFAULT -By default, this is a FILE * to stdout. +stdout .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE A common technique is to use the write callback to store the incoming data into a dynamically growing allocated buffer, and then this -\fICURLOPT_WRITEDATA(3)\fP is used to point to a struct or the buffer to store -data in. Like in the getinmemory example: +\fICURLOPT_WRITEDATA(3)\fP is used to point to a struct or the buffer to store data +in. Like in the getinmemory example: https://curl.se/libcurl/c/getinmemory.html +.SH HISTORY +This option was formerly known as CURLOPT_FILE, the name \fICURLOPT_WRITEDATA(3)\fP +was added in 7.9.7. .SH AVAILABILITY -Available in all libcurl versions. This option was formerly known as -CURLOPT_FILE, the name \fICURLOPT_WRITEDATA(3)\fP was added in 7.9.7. +Added in curl 7.9.7 .SH RETURN VALUE This returns CURLE_OK. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_WRITEFUNCTION.3 b/core/curl/files/CURLOPT_WRITEFUNCTION.3 index d6be25d8..dda996c7 100644 --- a/core/curl/files/CURLOPT_WRITEFUNCTION.3 +++ b/core/curl/files/CURLOPT_WRITEFUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_WRITEFUNCTION.md -.TH CURLOPT_WRITEFUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_WRITEFUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_WRITEFUNCTION \- callback for writing received data .SH SYNOPSIS @@ -53,9 +53,9 @@ given with \fICURLOPT_WRITEDATA(3)\fP. This option does not enable HSTS, you need to use \fICURLOPT_HSTS_CTRL(3)\fP to do that. .SH DEFAULT -libcurl uses \(aqfwrite\(aq as a callback by default. +fwrite(3) .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf #include /* for realloc */ @@ -105,8 +105,10 @@ int main(void) } } .fi -.SH AVAILABILITY +.SH HISTORY Support for the CURL_WRITEFUNC_PAUSE return code was added in version 7.18.0. +.SH AVAILABILITY +Added in curl 7.1 .SH RETURN VALUE This returns CURLE_OK. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_WS_OPTIONS.3 b/core/curl/files/CURLOPT_WS_OPTIONS.3 index 3e79b488..f36b7f1e 100644 --- a/core/curl/files/CURLOPT_WS_OPTIONS.3 +++ b/core/curl/files/CURLOPT_WS_OPTIONS.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_WS_OPTIONS.md -.TH CURLOPT_WS_OPTIONS 3 "2024-06-01" libcurl +.TH CURLOPT_WS_OPTIONS 3 "2024-07-29" libcurl .SH NAME CURLOPT_WS_OPTIONS \- WebSocket behavior options .SH SYNOPSIS @@ -26,7 +26,7 @@ application. .SH DEFAULT 0 .SH PROTOCOLS -WS +This functionality affects ws only .SH EXAMPLE .nf int main(void) @@ -43,7 +43,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.86.0 +Added in curl 7.86.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_XFERINFODATA.3 b/core/curl/files/CURLOPT_XFERINFODATA.3 index feb9f685..97426bf6 100644 --- a/core/curl/files/CURLOPT_XFERINFODATA.3 +++ b/core/curl/files/CURLOPT_XFERINFODATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_XFERINFODATA.md -.TH CURLOPT_XFERINFODATA 3 "2024-06-01" libcurl +.TH CURLOPT_XFERINFODATA 3 "2024-07-29" libcurl .SH NAME CURLOPT_XFERINFODATA \- pointer passed to the progress callback .SH SYNOPSIS @@ -14,9 +14,9 @@ argument in the progress callback set with \fICURLOPT_XFERINFOFUNCTION(3)\fP. This is an alias for \fICURLOPT_PROGRESSDATA(3)\fP. .SH DEFAULT -The default value of this parameter is NULL. +NULL .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf struct progress { @@ -50,7 +50,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.32.0 +Added in curl 7.32.0 .SH RETURN VALUE Returns CURLE_OK .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_XFERINFOFUNCTION.3 b/core/curl/files/CURLOPT_XFERINFOFUNCTION.3 index 1946f3f7..a67178bf 100644 --- a/core/curl/files/CURLOPT_XFERINFOFUNCTION.3 +++ b/core/curl/files/CURLOPT_XFERINFOFUNCTION.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_XFERINFOFUNCTION.md -.TH CURLOPT_XFERINFOFUNCTION 3 "2024-06-01" libcurl +.TH CURLOPT_XFERINFOFUNCTION 3 "2024-07-29" libcurl .SH NAME CURLOPT_XFERINFOFUNCTION \- progress meter callback .SH SYNOPSIS @@ -52,10 +52,9 @@ that performs transfers. \fICURLOPT_NOPROGRESS(3)\fP must be set to 0 to make this function actually get called. .SH DEFAULT -By default, libcurl has an internal progress meter. That is rarely wanted by -users. +NULL \- use the internal progress meter. That is rarely wanted by users. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf struct progress { @@ -94,7 +93,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.32.0. This callback replaces \fICURLOPT_PROGRESSFUNCTION(3)\fP +Added in curl 7.32.0 .SH RETURN VALUE Returns CURLE_OK. .SH SEE ALSO diff --git a/core/curl/files/CURLOPT_XOAUTH2_BEARER.3 b/core/curl/files/CURLOPT_XOAUTH2_BEARER.3 index 72ce3e2f..0adb9137 100644 --- a/core/curl/files/CURLOPT_XOAUTH2_BEARER.3 +++ b/core/curl/files/CURLOPT_XOAUTH2_BEARER.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLOPT_XOAUTH2_BEARER.md -.TH CURLOPT_XOAUTH2_BEARER 3 "2024-06-01" libcurl +.TH CURLOPT_XOAUTH2_BEARER 3 "2024-07-29" libcurl .SH NAME CURLOPT_XOAUTH2_BEARER \- OAuth 2.0 access token .SH SYNOPSIS @@ -21,7 +21,7 @@ option. .SH DEFAULT NULL .SH PROTOCOLS -HTTP, IMAP, LDAP, POP3 and SMTP +This functionality affects http, imap, ldap, pop3 and smtp .SH EXAMPLE .nf int main(void) @@ -36,8 +36,10 @@ int main(void) } } .fi +.SH HISTORY +Support for OpenLDAP added in 7.82.0. .SH AVAILABILITY -Added in 7.33.0. Support for OpenLDAP added in 7.82.0. +Added in curl 7.33.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. diff --git a/core/curl/files/CURLSHOPT_LOCKFUNC.3 b/core/curl/files/CURLSHOPT_LOCKFUNC.3 index cc7e7ae1..a80acfed 100644 --- a/core/curl/files/CURLSHOPT_LOCKFUNC.3 +++ b/core/curl/files/CURLSHOPT_LOCKFUNC.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLSHOPT_LOCKFUNC.md -.TH CURLSHOPT_LOCKFUNC 3 "2024-06-01" libcurl +.TH CURLSHOPT_LOCKFUNC 3 "2024-07-29" libcurl .SH NAME CURLSHOPT_LOCKFUNC \- mutex lock callback .SH SYNOPSIS @@ -30,7 +30,7 @@ sure that the callback uses a different lock for each kind of data. \fIclientp\fP is the private pointer you set with \fICURLSHOPT_USERDATA(3)\fP. This pointer is not used by libcurl itself. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf extern void mutex_lock(CURL *handle, curl_lock_data data, @@ -46,7 +46,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.10 +Added in curl 7.10.3 .SH RETURN VALUE CURLSHE_OK (zero) means that the option was set properly, non\-zero means an error occurred. See \fIlibcurl\-errors(3)\fP for the full list with diff --git a/core/curl/files/CURLSHOPT_SHARE.3 b/core/curl/files/CURLSHOPT_SHARE.3 index fb14c744..078e5cf7 100644 --- a/core/curl/files/CURLSHOPT_SHARE.3 +++ b/core/curl/files/CURLSHOPT_SHARE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLSHOPT_SHARE.md -.TH CURLSHOPT_SHARE 3 "2024-06-01" libcurl +.TH CURLSHOPT_SHARE 3 "2024-07-29" libcurl .SH NAME CURLSHOPT_SHARE \- add data to share .SH SYNOPSIS @@ -61,7 +61,7 @@ It is not supported to share the HSTS between multiple concurrent threads. Added in 7.88.0 .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -74,7 +74,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.10 +Added in curl 7.10.3 .SH RETURN VALUE CURLSHE_OK (zero) means that the option was set properly, non\-zero means an error occurred. See \fIlibcurl\-errors(3)\fP for the full list with diff --git a/core/curl/files/CURLSHOPT_UNLOCKFUNC.3 b/core/curl/files/CURLSHOPT_UNLOCKFUNC.3 index dc992c40..80024fad 100644 --- a/core/curl/files/CURLSHOPT_UNLOCKFUNC.3 +++ b/core/curl/files/CURLSHOPT_UNLOCKFUNC.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLSHOPT_UNLOCKFUNC.md -.TH CURLSHOPT_UNLOCKFUNC 3 "2024-06-01" libcurl +.TH CURLSHOPT_UNLOCKFUNC 3 "2024-07-29" libcurl .SH NAME CURLSHOPT_UNLOCKFUNC \- mutex unlock callback .SH SYNOPSIS @@ -26,7 +26,7 @@ sure that the callback uses a different lock for each kind of data. \fIclientp\fP is the private pointer you set with \fICURLSHOPT_USERDATA(3)\fP. This pointer is not used by libcurl itself. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf extern void mutex_unlock(CURL *, curl_lock_data, void *); @@ -41,7 +41,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.10 +Added in curl 7.10.3 .SH RETURN VALUE CURLSHE_OK (zero) means that the option was set properly, non\-zero means an error occurred. See \fIlibcurl\-errors(3)\fP for the full list with diff --git a/core/curl/files/CURLSHOPT_UNSHARE.3 b/core/curl/files/CURLSHOPT_UNSHARE.3 index b4e651db..52c53b20 100644 --- a/core/curl/files/CURLSHOPT_UNSHARE.3 +++ b/core/curl/files/CURLSHOPT_UNSHARE.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLSHOPT_UNSHARE.md -.TH CURLSHOPT_UNSHARE 3 "2024-06-01" libcurl +.TH CURLSHOPT_UNSHARE 3 "2024-07-29" libcurl .SH NAME CURLSHOPT_UNSHARE \- remove data to share .SH SYNOPSIS @@ -30,7 +30,7 @@ The connection cache is no longer shared. .IP CURL_LOCK_DATA_PSL The Public Suffix List is no longer shared. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) @@ -43,7 +43,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.10 +Added in curl 7.10.3 .SH RETURN VALUE CURLSHE_OK (zero) means that the option was set properly, non\-zero means an error occurred. See \fIlibcurl\-errors(3)\fP for the full list with diff --git a/core/curl/files/CURLSHOPT_USERDATA.3 b/core/curl/files/CURLSHOPT_USERDATA.3 index 61e10d87..70c3fc7a 100644 --- a/core/curl/files/CURLSHOPT_USERDATA.3 +++ b/core/curl/files/CURLSHOPT_USERDATA.3 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from CURLSHOPT_USERDATA.md -.TH CURLSHOPT_USERDATA 3 "2024-06-01" libcurl +.TH CURLSHOPT_USERDATA 3 "2024-07-29" libcurl .SH NAME CURLSHOPT_USERDATA \- pointer passed to the lock and unlock mutex callbacks .SH SYNOPSIS @@ -13,7 +13,7 @@ The \fIclientp\fP parameter is held verbatim by libcurl and is passed on as the \fIclientp\fP argument to the callbacks set with \fICURLSHOPT_LOCKFUNC(3)\fP and \fICURLSHOPT_UNLOCKFUNC(3)\fP. .SH PROTOCOLS -All +This functionality affects all supported protocols .SH EXAMPLE .nf struct secrets { @@ -31,7 +31,7 @@ int main(void) } .fi .SH AVAILABILITY -Added in 7.10 +Added in curl 7.10.3 .SH RETURN VALUE CURLSHE_OK (zero) means that the option was set properly, non\-zero means an error occurred. See \fIlibcurl\-errors(3)\fP for the full list with diff --git a/core/curl/files/curl-config.1 b/core/curl/files/curl-config.1 index 10642591..0f94c76e 100644 --- a/core/curl/files/curl-config.1 +++ b/core/curl/files/curl-config.1 @@ -1,5 +1,5 @@ .\" generated by cd2nroff 0.1 from curl-config.md -.TH curl-config 1 "2024-06-01" curl-config +.TH curl-config 1 "2024-07-29" curl-config .SH NAME curl\-config \- Get information about a libcurl installation .SH SYNOPSIS diff --git a/core/curl/files/curl.1 b/core/curl/files/curl.1 index 9ab6935e..e69de29b 100644 --- a/core/curl/files/curl.1 +++ b/core/curl/files/curl.1 @@ -1,6148 +0,0 @@ -.\" ************************************************************************** -.\" * _ _ ____ _ -.\" * Project ___| | | | _ \| | -.\" * / __| | | | |_) | | -.\" * | (__| |_| | _ <| |___ -.\" * \___|\___/|_| \_\_____| -.\" * -.\" * Copyright (C) Daniel Stenberg, , et al. -.\" * -.\" * This software is licensed as described in the file COPYING, which -.\" * you should have received as part of this distribution. The terms -.\" * are also available at https://curl.se/docs/copyright.html. -.\" * -.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell -.\" * copies of the Software, and permit persons to whom the Software is -.\" * furnished to do so, under the terms of the COPYING file. -.\" * -.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY -.\" * KIND, either express or implied. -.\" * -.\" * SPDX-License-Identifier: curl -.\" * -.\" ************************************************************************** -.\" -.\" DO NOT EDIT. Generated by the curl project managen man page generator. -.\" -.TH curl 1 "2024-06-01" "curl 8.8.0" "curl Manual" -.SH NAME -curl \- transfer a URL -.SH SYNOPSIS -\fBcurl [options / URLs]\fP -.SH DESCRIPTION -\fBcurl\fP is a tool for transferring data from or to a server using URLs. It -supports these protocols: DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, -IMAP, IMAPS, LDAP, LDAPS, MQTT, POP3, POP3S, RTMP, RTMPS, RTSP, SCP, SFTP, -SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS and WSS. - -curl is powered by libcurl for all transfer\-related features. See -\fIlibcurl(3)\fP for details. -.SH URL -The URL syntax is protocol\-dependent. You find a detailed description in -RFC 3986. - -If you provide a URL without a leading \fBprotocol://\fP scheme, curl guesses -what protocol you want. It then defaults to HTTP but assumes others based on -often\-used hostname prefixes. For example, for hostnames starting with "ftp." -curl assumes you want FTP. - -You can specify any amount of URLs on the command line. They are fetched in a -sequential manner in the specified order unless you use \fI\-Z, \-\-parallel\fP. You can -specify command line options and URLs mixed and in any order on the command -line. - -curl attempts to reuse connections when doing multiple transfers, so that -getting many files from the same server do not use multiple connects and setup -handshakes. This improves speed. Connection reuse can only be done for URLs -specified for a single command line invocation and cannot be performed between -separate curl runs. - -Provide an IPv6 zone id in the URL with an escaped percentage sign. Like in -.nf - -\&"http://[fe80::3%25eth0]/" -.fi - -Everything provided on the command line that is not a command line option or -its argument, curl assumes is a URL and treats it as such. -.SH GLOBBING -You can specify multiple URLs or parts of URLs by writing lists within braces -or ranges within brackets. We call this "globbing". - -Provide a list with three different names like this: -.nf - -\&"http://site.{one,two,three}.com" -.fi - -Do sequences of alphanumeric series by using [] as in: -.nf - -\&"ftp://ftp.example.com/file[1\-100].txt" -.fi - -With leading zeroes: -.nf - -\&"ftp://ftp.example.com/file[001\-100].txt" -.fi - -With letters through the alphabet: -.nf - -\&"ftp://ftp.example.com/file[a\-z].txt" -.fi - -Nested sequences are not supported, but you can use several ones next to each -other: -.nf - -\&"http://example.com/archive[1996\-1999]/vol[1\-4]/part{a,b,c}.html" -.fi - -You can specify a step counter for the ranges to get every Nth number or -letter: -.nf - -\&"http://example.com/file[1\-100:10].txt" - -\&"http://example.com/file[a\-z:2].txt" -.fi - -When using [] or {} sequences when invoked from a command line prompt, you -probably have to put the full URL within double quotes to avoid the shell from -interfering with it. This also goes for other characters treated special, like -for example \(aq&\(aq, \(aq?\(aq and \(aq*\(aq. - -Switch off globbing with \fI\-g, \-\-globoff\fP. -.SH VARIABLES -curl supports command line variables (added in 8.3.0). Set variables with -\fI\-\-variable\fP name=content or \fI\-\-variable\fP name@file (where "file" can be stdin if -set to a single dash (\-)). - -Variable contents can be expanded in option parameters using "{{name}}" if the -option name is prefixed with "\fI\-\-expand\-\fP". This gets the contents of the -variable "name" inserted, or a blank if the name does not exist as a -variable. Insert "{{" verbatim in the string by prefixing it with a backslash, -like "\\{{". - -You an access and expand environment variables by first importing them. You -can select to either require the environment variable to be set or you can -provide a default value in case it is not already set. Plain \fI\-\-variable\fP %name -imports the variable called \(aqname\(aq but exits with an error if that environment -variable is not already set. To provide a default value if it is not set, use -\fI\-\-variable\fP %name=content or \fI\-\-variable\fP %name@content. - -Example. Get the USER environment variable into the URL, fail if USER is not -set: -.nf - --\-variable \(aq%USER\(aq --\-expand\-url = "https://example.com/api/{{USER}}/method" -.fi - -When expanding variables, curl supports a set of functions that can make the -variable contents more convenient to use. It can trim leading and trailing -white space with "trim", it can output the contents as a JSON quoted string -with "json", URL encode the string with "url" or base64 encode it with "b64". -To apply functions to a variable expansion, add them colon separated to the -right side of the variable. Variable content holding null bytes that are not -encoded when expanded cause error. - -Example: get the contents of a file called $HOME/.secret into a variable -called "fix". Make sure that the content is trimmed and percent\-encoded when -sent as POST data: -.nf - --\-variable %HOME --\-expand\-variable fix@{{HOME}}/.secret --\-expand\-data "{{fix:trim:url}}" -https://example.com/ -.fi - -Command line variables and expansions were added in 8.3.0. -.SH OUTPUT -If not told otherwise, curl writes the received data to stdout. It can be -instructed to instead save that data into a local file, using the \fI\-o, \-\-output\fP or -\fI\-O, \-\-remote\-name\fP options. If curl is given multiple URLs to transfer on the -command line, it similarly needs multiple options for where to save them. - -curl does not parse or otherwise "understand" the content it gets or writes as -output. It does no encoding or decoding, unless explicitly asked to with -dedicated command line options. -.SH PROTOCOLS -curl supports numerous protocols, or put in URL terms: schemes. Your -particular build may not support them all. -.IP DICT -Lets you lookup words using online dictionaries. -.IP FILE -Read or write local files. curl does not support accessing file:// URL -remotely, but when running on Microsoft Windows using the native UNC approach -works. -.IP FTP(S) -curl supports the File Transfer Protocol with a lot of tweaks and levers. With -or without using TLS. -.IP GOPHER(S) -Retrieve files. -.IP HTTP(S) -curl supports HTTP with numerous options and variations. It can speak HTTP -version 0.9, 1.0, 1.1, 2 and 3 depending on build options and the correct -command line options. -.IP IMAP(S) -Using the mail reading protocol, curl can download emails for you. With or -without using TLS. -.IP LDAP(S) -curl can do directory lookups for you, with or without TLS. -.IP MQTT -curl supports MQTT version 3. Downloading over MQTT equals subscribe to a -topic while uploading/posting equals publish on a topic. MQTT over TLS is not -supported (yet). -.IP POP3(S) -Downloading from a pop3 server means getting a mail. With or without using -TLS. -.IP RTMP(S) -The \fBRealtime Messaging Protocol\fP is primarily used to serve streaming media -and curl can download it. -.IP RTSP -curl supports RTSP 1.0 downloads. -.IP SCP -curl supports SSH version 2 scp transfers. -.IP SFTP -curl supports SFTP (draft 5) done over SSH version 2. -.IP SMB(S) -curl supports SMB version 1 for upload and download. -.IP SMTP(S) -Uploading contents to an SMTP server means sending an email. With or without -TLS. -.IP TELNET -Fetching a telnet URL starts an interactive session where it sends what it -reads on stdin and outputs what the server sends it. -.IP TFTP -curl can do TFTP downloads and uploads. -.SH PROGRESS METER -curl normally displays a progress meter during operations, indicating the -amount of transferred data, transfer speeds and estimated time left, etc. The -progress meter displays the transfer rate in bytes per second. The suffixes -(k, M, G, T, P) are 1024 based. For example 1k is 1024 bytes. 1M is 1048576 -bytes. - -curl displays this data to the terminal by default, so if you invoke curl to -do an operation and it is about to write data to the terminal, it \fIdisables\fP -the progress meter as otherwise it would mess up the output mixing progress -meter and response data. - -If you want a progress meter for HTTP POST or PUT requests, you need to -redirect the response output to a file, using shell redirect (>), \fI\-o, \-\-output\fP -or similar. - -This does not apply to FTP upload as that operation does not spit out any -response data to the terminal. - -If you prefer a progress bar instead of the regular meter, \fI\-#, \-\-progress\-bar\fP is -your friend. You can also disable the progress meter completely with the -\fI\-s, \-\-silent\fP option. -.SH VERSION -This man page describes curl 8.8.0. If you use a later version, chances -are this man page does not fully document it. If you use an earlier version, -this document tries to include version information about which specific -version that introduced changes. - -You can always learn which the latest curl version is by running -.nf - -curl https://curl.se/info -.fi - -The online version of this man page is always showing the latest incarnation: -https://curl.se/docs/manpage.html -.SH OPTIONS -Options start with one or two dashes. Many of the options require an -additional value next to them. If provided text does not start with a dash, it -is presumed to be and treated as a URL. - -The short "single\-dash" form of the options, \-d for example, may be used with -or without a space between it and its value, although a space is a recommended -separator. The long double\-dash form, \fI\-d, \-\-data\fP for example, requires a space -between it and its value. - -Short version options that do not need any additional values can be used -immediately next to each other, like for example you can specify all the -options \fI\-O\fP, \fI\-L\fP and \fI\-v\fP at once as \fI\-OLv\fP. - -In general, all boolean options are enabled with \--\fBoption\fP and yet again -disabled with \--\fBno\-\fPoption. That is, you use the same option name but -prefix it with "no\-". However, in this list we mostly only list and show the --\-\fBoption\fP version of them. - -When \fI\-:, \-\-next\fP is used, it resets the parser state and you start again with a -clean option state, except for the options that are global. Global options -retain their values and meaning even after \fI\-:, \-\-next\fP. - -The following options are global: \fI\-\-fail\-early\fP, \fI\-\-libcurl\fP, \fI\-\-parallel\-immediate\fP, \fI\-Z, \-\-parallel\fP, \fI\-#, \-\-progress\-bar\fP, \fI\-\-rate\fP, \fI\-S, \-\-show\-error\fP, \fI\-\-stderr\fP, \fI\-\-styled\-output\fP, \fI\-\-trace\-ascii\fP, \fI\-\-trace\-config\fP, \fI\-\-trace\-ids\fP, \fI\-\-trace\-time\fP, \fI\-\-trace\fP and \fI\-v, \-\-verbose\fP. -.IP "\-\-abstract\-unix\-socket " -(HTTP) Connect through an abstract Unix domain socket, instead of using the network. -Note: netstat shows the path of an abstract socket prefixed with "@", however -the argument should not have this leading character. - -If --abstract-unix-socket is provided several times, the last set value is used. - -Example: -.nf - curl --abstract-unix-socket socketpath https://example.com -.fi - -See also \fI\-\-unix\-socket\fP. Added in 7.53.0. -.IP "\-\-alt\-svc " -(HTTPS) Enable the alt\-svc parser. If the filename points to an existing alt\-svc cache -file, that gets used. After a completed transfer, the cache is saved to the -filename again if it has been modified. - -Specify a "" filename (zero length) to avoid loading/saving and make curl just -handle the cache in memory. - -If this option is used several times, curl loads contents from all the -files but the last one is used for saving. - ---alt-svc can be used several times in a command line - -Example: -.nf - curl --alt-svc svc.txt https://example.com -.fi - -See also \fI\-\-resolve\fP and \fI\-\-connect\-to\fP. Added in 7.64.1. -.IP "\-\-anyauth" -(HTTP) Figure out authentication method automatically, and use the most secure one -the remote site claims to support. This is done by first doing a request and -checking the response\-headers, thus possibly inducing an extra network -round\-trip. This option is used instead of setting a specific authentication -method, which you can do with \fI\-\-basic\fP, \fI\-\-digest\fP, \fI\-\-ntlm\fP, and \fI\-\-negotiate\fP. - -Using \fI\-\-anyauth\fP is not recommended if you do uploads from stdin, since it may -require data to be sent twice and then the client must be able to rewind. If -the need should arise when uploading from stdin, the upload operation fails. - -Used together with \fI\-u, \-\-user\fP. - -Providing --anyauth multiple times has no extra effect. - -Example: -.nf - curl --anyauth --user me:pwd https://example.com -.fi - -See also \fI\-\-proxy\-anyauth\fP, \fI\-\-basic\fP and \fI\-\-digest\fP. -.IP "\-a, \-\-append" -(FTP SFTP) When used in an upload, this option makes curl append to the target file -instead of overwriting it. If the remote file does not exist, it is -created. Note that this flag is ignored by some SFTP servers (including -OpenSSH). - -Providing --append multiple times has no extra effect. -Disable it again with \-\-no-append. - -Example: -.nf - curl --upload-file local --append ftp://example.com/ -.fi - -See also \fI-r, \-\-range\fP and \fI-C, \-\-continue\-at\fP. -.IP "\-\-aws\-sigv4 " -(HTTP) Use AWS V4 signature authentication in the transfer. - -The provider argument is a string that is used by the algorithm when creating -outgoing authentication headers. - -The region argument is a string that points to a geographic area of -a resources collection (region\-code) when the region name is omitted from -the endpoint. - -The service argument is a string that points to a function provided by a cloud -(service\-code) when the service name is omitted from the endpoint. - -If --aws-sigv4 is provided several times, the last set value is used. - -Example: -.nf - curl --aws-sigv4 "aws:amz:us-east-2:es" --user "key:secret" https://example.com -.fi - -See also \fI\-\-basic\fP and \fI-u, \-\-user\fP. Added in 7.75.0. -.IP "\-\-basic" -(HTTP) Use HTTP Basic authentication with the remote host. This method is the default -and this option is usually pointless, unless you use it to override a -previously set option that sets a different authentication method (such as -\fI\-\-ntlm\fP, \fI\-\-digest\fP, or \fI\-\-negotiate\fP). - -Used together with \fI\-u, \-\-user\fP. - -Providing --basic multiple times has no extra effect. - -Example: -.nf - curl -u name:password --basic https://example.com -.fi - -See also \fI\-\-proxy\-basic\fP. -.IP "\-\-ca\-native" -(TLS) Use the CA store from the native operating system to verify the peer. By -default, curl otherwise uses a CA store provided in a single file or -directory, but when using this option it interfaces the operating system\(aqs own -vault. - -This option works for curl on Windows when built to use OpenSSL, wolfSSL -(added in 8.3.0) or GnuTLS (added in 8.5.0). When curl on Windows is built to -use Schannel, this feature is implied and curl then only uses the native CA -store. - -Providing --ca-native multiple times has no extra effect. -Disable it again with \-\-no-ca-native. - -Example: -.nf - curl --ca-native https://example.com -.fi - -See also \fI\-\-cacert\fP, \fI\-\-capath\fP and \fI-k, \-\-insecure\fP. Added in 8.2.0. -.IP "\-\-cacert " -(TLS) Use the specified certificate file to verify the peer. The file may contain -multiple CA certificates. The certificate(s) must be in PEM format. Normally -curl is built to use a default file for this, so this option is typically used -to alter that default file. - -curl recognizes the environment variable named \(aqCURL_CA_BUNDLE\(aq if it is set -and the TLS backend is not Schannel, and uses the given path as a path to a CA -cert bundle. This option overrides that variable. - -The windows version of curl automatically looks for a CA certs file named -\(aqcurl\-ca\-bundle.crt\(aq, either in the same directory as curl.exe, or in the -Current Working Directory, or in any folder along your PATH. - -(iOS and macOS only) If curl is built against Secure Transport, then this -option is supported for backward compatibility with other SSL engines, but it -should not be set. If the option is not set, then curl uses the certificates -in the system and user Keychain to verify the peer, which is the preferred -method of verifying the peer\(aqs certificate chain. - -(Schannel only) This option is supported for Schannel in Windows 7 or later -(added in 7.60.0). This option is supported for backward compatibility with -other SSL engines; instead it is recommended to use Windows\(aq store of root -certificates (the default for Schannel). - -If --cacert is provided several times, the last set value is used. - -Example: -.nf - curl --cacert CA-file.txt https://example.com -.fi - -See also \fI\-\-capath\fP and \fI-k, \-\-insecure\fP. -.IP "\-\-capath " -(TLS) Use the specified certificate directory to verify the peer. Multiple paths can -be provided by separated with colon (":") (e.g. "path1:path2:path3"). The -certificates must be in PEM format, and if curl is built against OpenSSL, the -directory must have been processed using the c_rehash utility supplied with -OpenSSL. Using \fI\-\-capath\fP can allow OpenSSL\-powered curl to make SSL\-connections -much more efficiently than using \fI\-\-cacert\fP if the \fI\-\-cacert\fP file contains many -CA certificates. - -If this option is set, the default capath value is ignored. - -If --capath is provided several times, the last set value is used. - -Example: -.nf - curl --capath /local/directory https://example.com -.fi - -See also \fI\-\-cacert\fP and \fI-k, \-\-insecure\fP. -.IP "\-E, \-\-cert " -(TLS) Use the specified client certificate file when getting a file with HTTPS, FTPS -or another SSL\-based protocol. The certificate must be in PKCS#12 format if -using Secure Transport, or PEM format if using any other engine. If the -optional password is not specified, it is queried for on the terminal. Note -that this option assumes a certificate file that is the private key and the -client certificate concatenated. See \fI\-E, \-\-cert\fP and \fI\-\-key\fP to specify them -independently. - -In the portion of the argument, you must escape the character -\&":" as "\\:" so that it is not recognized as the password delimiter. Similarly, -you must escape the double quote character as \\" so that it is not recognized -as an escape character. - -If curl is built against OpenSSL library, and the engine pkcs11 is available, -then a PKCS#11 URI (RFC 7512) can be used to specify a certificate located in -a PKCS#11 device. A string beginning with "pkcs11:" is interpreted as a -PKCS#11 URI. If a PKCS#11 URI is provided, then the \fI\-\-engine\fP option is set as -\&"pkcs11" if none was provided and the \fI\-\-cert\-type\fP option is set as "ENG" if -none was provided. - -(iOS and macOS only) If curl is built against Secure Transport, then the -certificate string can either be the name of a certificate/private key in the -system or user keychain, or the path to a PKCS#12\-encoded certificate and -private key. If you want to use a file from the current directory, please -precede it with "./" prefix, in order to avoid confusion with a nickname. - -(Schannel only) Client certificates must be specified by a path expression to -a certificate store. (Loading \fIPFX\fP is not supported; you can import it to a -store first). You can use "\\\\" -to refer to a certificate in the system certificates store, for example, -\fI"CurrentUser\\MY\\934a7ac6f8a5d579285a74fa61e19f23ddfe8d7a"\fP. Thumbprint is -usually a SHA\-1 hex string which you can see in certificate details. Following -store locations are supported: \fICurrentUser\fP, \fILocalMachine\fP, -\fICurrentService\fP, \fIServices\fP, \fICurrentUserGroupPolicy\fP, -\fILocalMachineGroupPolicy\fP and \fILocalMachineEnterprise\fP. - -If --cert is provided several times, the last set value is used. - -Example: -.nf - curl --cert certfile --key keyfile https://example.com -.fi - -See also \fI\-\-cert\-type\fP, \fI\-\-key\fP and \fI\-\-key\-type\fP. -.IP "\-\-cert\-status" -(TLS) 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. - -This support is currently only implemented in the OpenSSL and GnuTLS backends. - -Providing --cert-status multiple times has no extra effect. -Disable it again with \-\-no-cert-status. - -Example: -.nf - curl --cert-status https://example.com -.fi - -See also \fI\-\-pinnedpubkey\fP. -.IP "\-\-cert\-type " -(TLS) Set type of the provided client certificate. PEM, DER, ENG 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 \fI\-E, \-\-cert\fP is a pkcs11: URI then ENG is -the default type. - -If --cert-type is provided several times, the last set value is used. - -Example: -.nf - curl --cert-type PEM --cert file https://example.com -.fi - -See also \fI-E, \-\-cert\fP, \fI\-\-key\fP and \fI\-\-key\-type\fP. -.IP "\-\-ciphers " -(TLS) 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 --ciphers is provided several times, the last set value is used. - -Example: -.nf - curl --ciphers ECDHE-ECDSA-AES256-CCM8 https://example.com -.fi - -See also \fI\-\-tlsv1.3\fP, \fI\-\-tls13\-ciphers\fP and \fI\-\-proxy\-ciphers\fP. -.IP "\-\-compressed" -(HTTP) Request a compressed response using one of the algorithms curl supports, and -automatically decompress the content. - -Response headers are not modified when saved, so if they are "interpreted" -separately again at a later point they might appear to be saying that the -content is (still) compressed; while in fact it has already been decompressed. - -If this option is used and the server sends an unsupported encoding, curl -reports an error. This is a request, not an order; the server may or may not -deliver data compressed. - -Providing --compressed multiple times has no extra effect. -Disable it again with \-\-no-compressed. - -Example: -.nf - curl --compressed https://example.com -.fi - -See also \fI\-\-compressed\-ssh\fP. -.IP "\-\-compressed\-ssh" -(SCP SFTP) Enables built\-in SSH compression. This is a request, not an order; the server -may or may not do it. - -Providing --compressed-ssh multiple times has no extra effect. -Disable it again with \-\-no-compressed-ssh. - -Example: -.nf - curl --compressed-ssh sftp://example.com/ -.fi - -See also \fI\-\-compressed\fP. Added in 7.56.0. -.IP "\-K, \-\-config " -Specify a text file to read curl arguments from. The command line arguments -found in the text file are used as if they were provided on the command -line. - -Options and their parameters must be specified on the same line in the file, -separated by whitespace, colon, or the equals sign. Long option names can -optionally be given in the config file without the initial double dashes and -if so, the colon or equals characters can be used as separators. If the option -is specified with one or two dashes, there can be no colon or equals character -between the option and its parameter. - -If the parameter contains whitespace or starts with a colon (:) or equals sign -(=), it must be specified enclosed within double quotes ("like this"). Within -double quotes the following escape sequences are available: \\\\, \\", \\t, \\n, \\r -and \\v. A backslash preceding any other letter is ignored. - -If the first non\-blank column of a config line is a \(aq#\(aq character, that line -is treated as a comment. - -Only write one option per physical line in the config file. A single line is -required to be no more than 10 megabytes (since 8.2.0). - -Specify the filename to \fI\-K, \-\-config\fP as minus "\-" to make curl read the file from -stdin. - -Note that to be able to specify a URL in the config file, you need to specify -it using the \fI\-\-url\fP option, and not by simply writing the URL on its own -line. So, it could look similar to this: -.nf - -url = "https://curl.se/docs/" - -# \--\- Example file \--\- -# this is a comment -url = "example.com" -output = "curlhere.html" -user\-agent = "superagent/1.0" - -# and fetch another URL too -url = "example.com/docs/manpage.html" --O -referer = "http://nowhereatall.example.com/" -# \--\- End of example file \--\- -.fi - -When curl is invoked, it (unless \fI\-q, \-\-disable\fP is used) checks for a default -config file and uses it if found, even when \fI\-K, \-\-config\fP is used. The default -config file is checked for in the following places in this order: - -1) \fB"$CURL_HOME/.curlrc"\fP - -2) \fB"$XDG_CONFIG_HOME/curlrc"\fP (Added in 7.73.0) - -3) \fB"$HOME/.curlrc"\fP - -4) Windows: \fB"%USERPROFILE%\\.curlrc"\fP - -5) Windows: \fB"%APPDATA%\\.curlrc"\fP - -6) Windows: \fB"%USERPROFILE%\\Application Data\\.curlrc"\fP - -7) Non\-Windows: use getpwuid to find the home directory - -8) On Windows, if it finds no \fI.curlrc\fP file in the sequence described above, it -checks for one in the same directory the curl executable is placed. - -On Windows two filenames are checked per location: \fI.curlrc\fP and \fI_curlrc\fP, -preferring the former. Older versions on Windows checked for \fI_curlrc\fP only. - ---config can be used several times in a command line - -Example: -.nf - curl --config file.txt https://example.com -.fi - -See also \fI-q, \-\-disable\fP. -.IP "\-\-connect\-timeout " -Maximum time in seconds that you allow curl\(aqs connection to take. This only -limits the connection phase, so if curl connects within the given period it -continues \- if not it exits. - -This option accepts decimal values. The decimal value needs -to be provided using a dot (.) as decimal separator \- not the local version -even if it might be using another separator. - -The connection phase is considered complete when the DNS lookup and requested -TCP, TLS or QUIC handshakes are done. - -If --connect-timeout is provided several times, the last set value is used. - -Examples: -.nf - curl --connect-timeout 20 https://example.com - curl --connect-timeout 3.14 https://example.com -.fi - -See also \fI-m, \-\-max\-time\fP. -.IP "\-\-connect\-to " -For a request intended for the "HOST1:PORT1" pair, connect to "HOST2:PORT2" -instead. This option is only used to establish the network connection. It does -NOT affect the hostname/port number that is used for TLS/SSL (e.g. SNI, -certificate verification) or for the application protocols. - -\&"HOST1" and "PORT1" may be empty strings, meaning any host or any port number. -\&"HOST2" and "PORT2" may also be empty strings, meaning use the request\(aqs -original hostname and port number. - -A hostname 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". - ---connect-to can be used several times in a command line - -Example: -.nf - curl --connect-to example.com:443:example.net:8443 https://example.com -.fi - -See also \fI\-\-resolve\fP and \fI-H, \-\-header\fP. -.IP "\-C, \-\-continue\-at " -Resume a previous transfer from the given byte offset. The given offset is the -exact number of bytes that are skipped, counting from the beginning of the -source file before it is transferred to the destination. If used with uploads, -the FTP server command SIZE is not used by curl. - -Use "\-C \-" to instruct curl to automatically find out where/how to resume the -transfer. It then uses the given output/input files to figure that out. - -If --continue-at is provided several times, the last set value is used. - -Examples: -.nf - curl -C - https://example.com - curl -C 400 https://example.com -.fi - -See also \fI-r, \-\-range\fP. -.IP "\-b, \-\-cookie " -(HTTP) 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 -should be in the format "NAME1=VALUE1; NAME2=VALUE2" or as a single filename. - -When given a set of specific cookies and not a filename, it makes curl use the -cookie header with this content explicitly in all outgoing request(s). If -multiple requests are done due to authentication, followed redirects or -similar, they all get this cookie header passed on. - -If no "=" symbol is used in the argument, it is instead treated as a filename -to read previously stored cookie from. This option also activates the cookie -engine which makes curl record incoming cookies, which may be handy if you are -using this in combination with the \fI\-L, \-\-location\fP option or do multiple URL -transfers on the same invoke. - -If the filename is a single minus ("\-"), curl reads the contents from stdin. -If the filename is an empty string ("") and is the only cookie input, curl -activates the cookie engine without any cookies. - -The file format of the file to read cookies from should be plain HTTP headers -(Set\-Cookie style) or the Netscape/Mozilla cookie file format. - -The file specified with \fI\-b, \-\-cookie\fP is only used as input. No cookies are written -to that file. To store cookies, use the \fI\-c, \-\-cookie\-jar\fP option. - -If you use the Set\-Cookie file format and do not specify a domain then the -cookie is not sent since the domain never matches. To address this, set a -domain in Set\-Cookie line (doing that includes subdomains) or preferably: use -the Netscape format. - -Users often want to both read cookies from a file and write updated cookies -back to a file, so using both \fI\-b, \-\-cookie\fP and \fI\-c, \-\-cookie\-jar\fP in the same command -line is common. - -If curl is built with PSL (\fBPublic Suffix List\fP) support, it detects and -discards cookies that are specified for such suffix domains that should not be -allowed to have cookies. If curl is \fInot\fP built with PSL support, it has no -ability to stop super cookies. - ---cookie can be used several times in a command line - -Examples: -.nf - curl -b "" https://example.com - curl -b cookiefile https://example.com - curl -b cookiefile -c cookiefile https://example.com - curl -b name=Jane https://example.com -.fi - -See also \fI-c, \-\-cookie\-jar\fP and \fI-j, \-\-junk\-session\-cookies\fP. -.IP "\-c, \-\-cookie\-jar " -(HTTP) 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 -given file at the end of operations. Even if no cookies are known, a file is -created so that it removes any formerly existing cookies from the file. The -file uses the Netscape cookie file format. If you set the filename to a single -minus, "\-", the cookies are written to stdout. - -The file specified with \fI\-c, \-\-cookie\-jar\fP is only used for output. No cookies are -read from the file. To read cookies, use the \fI\-b, \-\-cookie\fP option. Both options -can specify the same file. - -This command line option activates the cookie engine that makes curl record -and use cookies. The \fI\-b, \-\-cookie\fP option also activates it. - -If the cookie jar cannot be created or written to, the whole curl operation -does not fail or even report an error clearly. Using \fI\-v, \-\-verbose\fP gets a warning -displayed, but that is the only visible feedback you get about this possibly -lethal situation. - -If --cookie-jar is provided several times, the last set value is used. - -Examples: -.nf - curl -c store-here.txt https://example.com - curl -c store-here.txt -b read-these https://example.com -.fi - -See also \fI-b, \-\-cookie\fP. -.IP "\-\-create\-dirs" -When used in conjunction with the \fI\-o, \-\-output\fP option, curl creates the necessary -local directory hierarchy as needed. This option creates the directories -mentioned with the \fI\-o, \-\-output\fP option combined with the path possibly set with -\fI\-\-output\-dir\fP. If the combined output filename uses no directory, or if the -directories it mentions already exist, no directories are created. - -Created directories are made with mode 0750 on unix style file systems. - -To create remote directories when using FTP or SFTP, try \fI\-\-ftp\-create\-dirs\fP. - -Providing --create-dirs multiple times has no extra effect. -Disable it again with \-\-no-create-dirs. - -Example: -.nf - curl --create-dirs --output local/dir/file https://example.com -.fi - -See also \fI\-\-ftp\-create\-dirs\fP and \fI\-\-output\-dir\fP. -.IP "\-\-create\-file\-mode " -(SFTP SCP FILE) When curl is used to create files remotely using one of the supported -protocols, this option allows the user to set which \(aqmode\(aq to set on the file -at creation time, instead of the default 0644. - -This option takes an octal number as argument. - -If --create-file-mode is provided several times, the last set value is used. - -Example: -.nf - curl --create-file-mode 0777 -T localfile sftp://example.com/new -.fi - -See also \fI\-\-ftp\-create\-dirs\fP. Added in 7.75.0. -.IP "\-\-crlf" -(FTP SMTP) Convert line feeds to carriage return plus line feeds in upload. Useful for -\fBMVS (OS/390)\fP. - -(SMTP added in 7.40.0) - -Providing --crlf multiple times has no extra effect. -Disable it again with \-\-no-crlf. - -Example: -.nf - curl --crlf -T file ftp://example.com/ -.fi - -See also \fI-B, \-\-use\-ascii\fP. -.IP "\-\-crlfile " -(TLS) Provide a file using PEM format with a Certificate Revocation List that may -specify peer certificates that are to be considered revoked. - -If --crlfile is provided several times, the last set value is used. - -Example: -.nf - curl --crlfile rejects.txt https://example.com -.fi - -See also \fI\-\-cacert\fP and \fI\-\-capath\fP. -.IP "\-\-curves " -(TLS) Set specific curves to use during SSL session establishment according to RFC -8422, 5.1. Multiple algorithms can be provided by separating them with ":" -(e.g. "X25519:P\-521"). The parameter is available identically in the OpenSSL -\&"s_client" and "s_server" utilities. - -\fI\-\-curves\fP allows a OpenSSL powered curl to make SSL\-connections with exactly -the (EC) curve requested by the client, avoiding nontransparent client/server -negotiations. - -If this option is set, the default curves list built into OpenSSL are ignored. - -If --curves is provided several times, the last set value is used. - -Example: -.nf - curl --curves X25519 https://example.com -.fi - -See also \fI\-\-ciphers\fP. Added in 7.73.0. -.IP "\-d, \-\-data " -(HTTP MQTT) 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 -submit button. This option makes curl pass the data to the server using the -content\-type application/x\-www\-form\-urlencoded. Compare to \fI\-F, \-\-form\fP. - -\fI\-\-data\-raw\fP is almost the same but does not have a special interpretation of -the @ character. To post data purely binary, you should instead use the -\fI\-\-data\-binary\fP option. To URL\-encode the value of a form field you may use -\fI\-\-data\-urlencode\fP. - -If any of these options is used more than once on the same command line, the -data pieces specified are merged with a separating &\-symbol. Thus, using -\(aq\-d name=daniel \-d skill=lousy\(aq would generate a post chunk that looks like -\(aqname=daniel&skill=lousy\(aq. - -If you start the data with the letter @, the rest should be a filename to read -the data from, or \- if you want curl to read the data from stdin. Posting data -from a file named \(aqfoobar\(aq would thus be done with \fI\-d, \-\-data\fP @foobar. When \fI\-d, \-\-data\fP -is told to read from a file like that, carriage returns, newlines and null -bytes are stripped out. If you do not want the @ character to have a special -interpretation use \fI\-\-data\-raw\fP instead. - -The data for this option is passed on to the server exactly as provided on the -command line. curl does not convert, change or improve it. It is up to the -user to provide the data in the correct form. - ---data can be used several times in a command line - -Examples: -.nf - curl -d "name=curl" https://example.com - curl -d "name=curl" -d "tool=cmdline" https://example.com - curl -d @filename https://example.com -.fi - -See also \fI\-\-data\-binary\fP, \fI\-\-data\-urlencode\fP and \fI\-\-data\-raw\fP. This option is mutually exclusive to \fI-F, \-\-form\fP and \fI-I, \-\-head\fP and \fI-T, \-\-upload\-file\fP. -.IP "\-\-data\-ascii " -(HTTP) This option is just an alias for \fI\-d, \-\-data\fP. - ---data-ascii can be used several times in a command line - -Example: -.nf - curl --data-ascii @file https://example.com -.fi - -See also \fI\-\-data\-binary\fP, \fI\-\-data\-raw\fP and \fI\-\-data\-urlencode\fP. -.IP "\-\-data\-binary " -(HTTP) Post data exactly as specified with no extra processing whatsoever. - -If you start the data with the letter @, the rest should be a filename. Data -is posted in a similar manner as \fI\-d, \-\-data\fP does, except that newlines and -carriage returns are preserved and conversions are never done. - -Like \fI\-d, \-\-data\fP the default content\-type sent to the server is -application/x\-www\-form\-urlencoded. If you want the data to be treated as -arbitrary binary data by the server then set the content\-type to octet\-stream: --H "Content\-Type: application/octet\-stream". - -If this option is used several times, the ones following the first append -data as described in \fI\-d, \-\-data\fP. - ---data-binary can be used several times in a command line - -Example: -.nf - curl --data-binary @filename https://example.com -.fi - -See also \fI\-\-data\-ascii\fP. -.IP "\-\-data\-raw " -(HTTP) Post data similarly to \fI\-d, \-\-data\fP but without the special interpretation of the @ -character. - ---data-raw can be used several times in a command line - -Examples: -.nf - curl --data-raw "hello" https://example.com - curl --data-raw "@at@at@" https://example.com -.fi - -See also \fI-d, \-\-data\fP. -.IP "\-\-data\-urlencode " -(HTTP) Post data, similar to the other \fI\-d, \-\-data\fP options with the exception that this -performs URL\-encoding. - -To be CGI\-compliant, the part should begin with a \fIname\fP followed by -a separator and a content specification. The part can be passed to -curl using one of the following syntaxes: -.RS -.IP content -URL\-encode the content and pass that on. Just be careful so that the content -does not contain any "=" or "@" symbols, as that makes the syntax match one of -the other cases below! -.IP =content -URL\-encode the content and pass that on. The preceding "=" symbol is not -included in the data. -.IP name=content -URL\-encode the content part and pass that on. Note that the name part is -expected to be URL\-encoded already. -.IP @filename -load data from the given file (including any newlines), URL\-encode that data -and pass it on in the POST. -.IP name@filename -load data from the given file (including any newlines), URL\-encode that data -and pass it on in the POST. The name part gets an equal sign appended, -resulting in \fIname=urlencoded\-file\-content\fP. Note that the name is expected to -be URL\-encoded already. -.RE -.IP - ---data-urlencode can be used several times in a command line - -Examples: -.nf - curl --data-urlencode name=val https://example.com - curl --data-urlencode =encodethis https://example.com - curl --data-urlencode name@file https://example.com - curl --data-urlencode @fileonly https://example.com -.fi - -See also \fI-d, \-\-data\fP and \fI\-\-data\-raw\fP. -.IP "\-\-delegation " -(GSS/kerberos) Set LEVEL what curl is allowed to delegate when it comes to user credentials. -.RS -.IP none -Do not allow any delegation. -.IP policy -Delegates if and only if the OK\-AS\-DELEGATE flag is set in the Kerberos -service ticket, which is a matter of realm policy. -.IP always -Unconditionally allow the server to delegate. -.RE -.IP - -If --delegation is provided several times, the last set value is used. - -Example: -.nf - curl --delegation "none" https://example.com -.fi - -See also \fI-k, \-\-insecure\fP and \fI\-\-ssl\fP. -.IP "\-\-digest" -(HTTP) Enables HTTP Digest authentication. This authentication scheme avoids sending -the password over the wire in clear text. Use this in combination with the -normal \fI\-u, \-\-user\fP option to set username and password. - -Providing --digest multiple times has no extra effect. -Disable it again with \-\-no-digest. - -Example: -.nf - curl -u name:password --digest https://example.com -.fi - -See also \fI-u, \-\-user\fP, \fI\-\-proxy\-digest\fP and \fI\-\-anyauth\fP. This option is mutually exclusive to \fI\-\-basic\fP and \fI\-\-ntlm\fP and \fI\-\-negotiate\fP. -.IP "\-q, \-\-disable" -If used as the \fBfirst\fP parameter on the command line, the \fIcurlrc\fP config -file is not read or used. See the \fI\-K, \-\-config\fP for details on the default config -file search path. - -Prior to 7.50.0 curl supported the short option name \fIq\fP but not the long -option name \fIdisable\fP. - -Providing --disable multiple times has no extra effect. -Disable it again with \-\-no-disable. - -Example: -.nf - curl -q https://example.com -.fi - -See also \fI-K, \-\-config\fP. -.IP "\-\-disable\-eprt" -(FTP) Disable the use of the EPRT and LPRT commands when doing active FTP transfers. -Curl normally first attempts to use EPRT before using PORT, but with this -option, it uses PORT right away. EPRT is an extension to the original FTP -protocol, and does not work on all servers, but enables more functionality in -a better way than the traditional PORT command. - -\fI\-\-eprt\fP can be used to explicitly enable EPRT again and \fI\-\-no\-eprt\fP is an alias -for \fI\-\-disable\-eprt\fP. - -If the server is accessed using IPv6, this option has no effect as EPRT is -necessary then. - -Disabling EPRT only changes the active behavior. If you want to switch to -passive mode you need to not use \fI\-P, \-\-ftp\-port\fP or force it with \fI\-\-ftp\-pasv\fP. - -Providing --disable-eprt multiple times has no extra effect. -Disable it again with \-\-no-disable-eprt. - -Example: -.nf - curl --disable-eprt ftp://example.com/ -.fi - -See also \fI\-\-disable\-epsv\fP and \fI-P, \-\-ftp\-port\fP. -.IP "\-\-disable\-epsv" -(FTP) Disable the use of the EPSV command when doing passive FTP transfers. Curl -normally first attempts to use EPSV before PASV, but with this option, it does -not try EPSV. - -\fI\-\-epsv\fP can be used to explicitly enable EPSV again and \fI\-\-no\-epsv\fP is an alias -for \fI\-\-disable\-epsv\fP. - -If the server is an IPv6 host, this option has no effect as EPSV is necessary -then. - -Disabling EPSV only changes the passive behavior. If you want to switch to -active mode you need to use \fI\-P, \-\-ftp\-port\fP. - -Providing --disable-epsv multiple times has no extra effect. -Disable it again with \-\-no-disable-epsv. - -Example: -.nf - curl --disable-epsv ftp://example.com/ -.fi - -See also \fI\-\-disable\-eprt\fP and \fI-P, \-\-ftp\-port\fP. -.IP "\-\-disallow\-username\-in\-url" -Exit with error if passed a URL containing a username. Probably most useful -when the URL is being provided at runtime or similar. - -Providing --disallow-username-in-url multiple times has no extra effect. -Disable it again with \-\-no-disallow-username-in-url. - -Example: -.nf - curl --disallow-username-in-url https://example.com -.fi - -See also \fI\-\-proto\fP. Added in 7.61.0. -.IP "\-\-dns\-interface " -(DNS) Send outgoing DNS requests through the given interface. This option is a -counterpart to \fI\-\-interface\fP (which does not affect DNS). The supplied string -must be an interface name (not an address). - -If --dns-interface is provided several times, the last set value is used. - -Example: -.nf - curl --dns-interface eth0 https://example.com -.fi - -See also \fI\-\-dns\-ipv4\-addr\fP and \fI\-\-dns\-ipv6\-addr\fP. \fI\-\-dns\-interface\fP requires that the underlying libcurl was built to support c-ares. -.IP "\-\-dns\-ipv4\-addr
" -(DNS) Bind to a specific 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 --dns-ipv4-addr is provided several times, the last set value is used. - -Example: -.nf - curl --dns-ipv4-addr 10.1.2.3 https://example.com -.fi - -See also \fI\-\-dns\-interface\fP and \fI\-\-dns\-ipv6\-addr\fP. \fI\-\-dns\-ipv4\-addr\fP requires that the underlying libcurl was built to support c-ares. -.IP "\-\-dns\-ipv6\-addr
" -(DNS) Bind to a specific 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 --dns-ipv6-addr is provided several times, the last set value is used. - -Example: -.nf - curl --dns-ipv6-addr 2a04:4e42::561 https://example.com -.fi - -See also \fI\-\-dns\-interface\fP and \fI\-\-dns\-ipv4\-addr\fP. \fI\-\-dns\-ipv6\-addr\fP requires that the underlying libcurl was built to support c-ares. -.IP "\-\-dns\-servers " -(DNS) 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, appended to the IP address separated with a colon. - -If --dns-servers is provided several times, the last set value is used. - -Examples: -.nf - curl --dns-servers 192.168.0.1,192.168.0.2 https://example.com - curl --dns-servers 10.0.0.1:53 https://example.com -.fi - -See also \fI\-\-dns\-interface\fP and \fI\-\-dns\-ipv4\-addr\fP. \fI\-\-dns\-servers\fP requires that the underlying libcurl was built to support c-ares. -.IP "\-\-doh\-cert\-status" -Same as \fI\-\-cert\-status\fP but used for DoH (DNS\-over\-HTTPS). - -Verifies the status of the DoH servers\(aq certificate by using the Certificate -Status Request (aka. OCSP stapling) TLS extension. - -If this option is enabled and the DoH 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. - -This support is currently only implemented in the OpenSSL and GnuTLS backends. - -Providing --doh-cert-status multiple times has no extra effect. -Disable it again with \-\-no-doh-cert-status. - -Example: -.nf - curl --doh-cert-status --doh-url https://doh.example https://example.com -.fi - -See also \fI\-\-doh\-insecure\fP. Added in 7.76.0. -.IP "\-\-doh\-insecure" -Same as \fI\-k, \-\-insecure\fP but used for DoH (DNS\-over\-HTTPS). - -Providing --doh-insecure multiple times has no extra effect. -Disable it again with \-\-no-doh-insecure. - -Example: -.nf - curl --doh-insecure --doh-url https://doh.example https://example.com -.fi - -See also \fI\-\-doh\-url\fP. Added in 7.76.0. -.IP "\-\-doh\-url " -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. - -Some SSL options that you set for your transfer also applies to DoH since the -name lookups take place over SSL. However, the certificate verification -settings are not inherited but are controlled separately via \fI\-\-doh\-insecure\fP -and \fI\-\-doh\-cert\-status\fP. - -This option is unset if an empty string "" is used as the URL. -(Added in 7.85.0) - -If --doh-url is provided several times, the last set value is used. - -Example: -.nf - curl --doh-url https://doh.example https://example.com -.fi - -See also \fI\-\-doh\-insecure\fP. Added in 7.62.0. -.IP "\-D, \-\-dump\-header " -(HTTP FTP) Write the received protocol headers to the specified file. If no headers are -received, the use of this option creates an empty file. - -When used in FTP, the FTP server response lines are considered being "headers" -and thus are saved there. - -Having multiple transfers in one set of operations (i.e. the URLs in one -\fI\-:, \-\-next\fP clause), appends them to the same file, separated by a blank line. - -If --dump-header is provided several times, the last set value is used. - -Example: -.nf - curl --dump-header store.txt https://example.com -.fi - -See also \fI-o, \-\-output\fP. -.IP "\-\-ech " -(HTTPS) Specifies how to do ECH (Encrypted Client Hello). - -The values allowed for can be: -.RS -.IP false -Do not attempt ECH -.IP grease -Send a GREASE ECH extension -.IP true -Attempt ECH if possible, but do not fail if ECH is not attempted. -(The connection fails if ECH is attempted but fails.) -.IP hard -Attempt ECH and fail if that is not possible. -ECH only works with TLS 1.3 and also requires using -DoH or providing an ECHConfigList on the command line. -.IP ecl: -A base64 encoded ECHConfigList that is used for ECH. -.IP pn: -A name to use to over\-ride the "public_name" field of an ECHConfigList -(only available with OpenSSL TLS support) -.IP Errors -Most errors cause error -\fICURLE_ECH_REQUIRED\fP (101). -.RE -.IP - -If --ech is provided several times, the last set value is used. - -Example: -.nf - curl --ech true https://example.com -.fi - -See also \fI\-\-doh\-url\fP. Added in 8.8.0. -.IP "\-\-egd\-file " -(TLS) Deprecated option (added in 7.84.0). Prior to that it only had an effect on -curl if built to use old versions of OpenSSL. - -Specify the path name to the Entropy Gathering Daemon socket. The socket is -used to seed the random engine for SSL connections. - -If --egd-file is provided several times, the last set value is used. - -Example: -.nf - curl --egd-file /random/here https://example.com -.fi - -See also \fI\-\-random\-file\fP. -.IP "\-\-engine " -(TLS) Select the OpenSSL crypto engine to use for cipher operations. Use \fI\-\-engine\fP -list to print a list of build\-time supported engines. Note that not all (and -possibly none) of the engines may be available at runtime. - -If --engine is provided several times, the last set value is used. - -Example: -.nf - curl --engine flavor https://example.com -.fi - -See also \fI\-\-ciphers\fP and \fI\-\-curves\fP. -.IP "\-\-etag\-compare " -(HTTP) Make a conditional HTTP request for the specific ETag read from the given file -by sending a custom If\-None\-Match header using the stored ETag. - -For correct results, make sure that the specified file contains only a single -line with the desired ETag. An empty file is parsed as an empty ETag. - -Use the option \fI\-\-etag\-save\fP to first save the ETag from a response, and then -use this option to compare against the saved ETag in a subsequent request. - -If --etag-compare is provided several times, the last set value is used. - -Example: -.nf - curl --etag-compare etag.txt https://example.com -.fi - -See also \fI\-\-etag\-save\fP and \fI-z, \-\-time\-cond\fP. Added in 7.68.0. -.IP "\-\-etag\-save " -(HTTP) Save an HTTP ETag to the specified file. An ETag is a caching related header, -usually returned in a response. - -If no ETag is sent by the server, an empty file is created. - -If --etag-save is provided several times, the last set value is used. - -Example: -.nf - curl --etag-save storetag.txt https://example.com -.fi - -See also \fI\-\-etag\-compare\fP. Added in 7.68.0. -.IP "\-\-expect100\-timeout " -(HTTP) 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 -default curl waits one second. This option accepts decimal values. When curl -stops waiting, it continues as if a response was received. - -The decimal value needs to provided using a dot (".") as decimal separator \- -not the local version even if it might be using another separator. - -If --expect100-timeout is provided several times, the last set value is used. - -Example: -.nf - curl --expect100-timeout 2.5 -T file https://example.com -.fi - -See also \fI\-\-connect\-timeout\fP. -.IP "\-f, \-\-fail" -(HTTP) 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 -HTTP server fails to deliver a document, it returns an HTML document stating -so (which often also describes why and more). This command line option -prevents curl from outputting that and return error 22. - -This method is not fail\-safe and there are occasions where non\-successful -response codes slip through, especially when authentication is involved -(response codes 401 and 407). - -Providing --fail multiple times has no extra effect. -Disable it again with \-\-no-fail. - -Example: -.nf - curl --fail https://example.com -.fi - -See also \fI\-\-fail\-with\-body\fP and \fI\-\-fail\-early\fP. This option is mutually exclusive to \fI\-\-fail\-with\-body\fP. -.IP "\-\-fail\-early" -Fail and exit on the first detected transfer error. - -When curl is used to do multiple transfers on the command line, it attempts to -operate on each given URL, one by one. By default, it ignores errors if there -are more URLs given and the last URL\(aqs success determines the error code curl -returns. Early failures are "hidden" by subsequent successful transfers. - -Using this option, curl instead returns an error on the first transfer that -fails, independent of the amount of URLs that are given on the command -line. This way, no transfer failures go undetected by scripts and similar. - -This option does not imply \fI\-f, \-\-fail\fP, which causes transfers to fail due to the -server\(aqs HTTP status code. You can combine the two options, however note \fI\-f, \-\-fail\fP -is not global and is therefore contained by \fI\-:, \-\-next\fP. - -This option is global and does not need to be specified for each use of --next. - -Providing --fail-early multiple times has no extra effect. -Disable it again with \-\-no-fail-early. - -Example: -.nf - curl --fail-early https://example.com https://two.example -.fi - -See also \fI-f, \-\-fail\fP and \fI\-\-fail\-with\-body\fP. Added in 7.52.0. -.IP "\-\-fail\-with\-body" -(HTTP) 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 -returns an HTML document stating so (which often also describes why and more). -This option allows curl to output and save that content but also to return -error 22. - -This is an alternative option to \fI\-f, \-\-fail\fP which makes curl fail for the same -circumstances but without saving the content. - -Providing --fail-with-body multiple times has no extra effect. -Disable it again with \-\-no-fail-with-body. - -Example: -.nf - curl --fail-with-body https://example.com -.fi - -See also \fI-f, \-\-fail\fP and \fI\-\-fail\-early\fP. This option is mutually exclusive to \fI-f, \-\-fail\fP. Added in 7.76.0. -.IP "\-\-false\-start" -(TLS) Use false start during the TLS handshake. False start is a mode where a TLS -client starts sending application data before verifying the server\(aqs Finished -message, thus saving a round trip when performing a full handshake. - -This functionality is currently only implemented in the Secure Transport (on -iOS 7.0 or later, or OS X 10.9 or later) backend. - -Providing --false-start multiple times has no extra effect. -Disable it again with \-\-no-false-start. - -Example: -.nf - curl --false-start https://example.com -.fi - -See also \fI\-\-tcp\-fastopen\fP. -.IP "\-F, \-\-form " -(HTTP SMTP IMAP) For the HTTP protocol family, emulate a filled\-in form in which a user has -pressed the submit button. This makes curl POST data using the Content\-Type -multipart/form\-data according to RFC 2388. - -For SMTP and IMAP protocols, this composes a multipart mail message to -transmit. - -This enables uploading of binary files etc. To force the \(aqcontent\(aq part to be -a file, prefix the filename with an @ sign. To just get the content part from -a file, prefix the filename with the symbol <. The difference between @ and -< is then that @ makes a file get attached in the post as a file upload, -while the < makes a text field and just get the contents for that text field -from a file. - -Read content from stdin instead of a file by using a single "\-" as filename. -This goes for both @ and < constructs. When stdin is used, the contents is -buffered in memory first by curl to determine its size and allow a possible -resend. Defining a part\(aqs data from a named non\-regular file (such as a named -pipe or similar) is not subject to buffering and is instead read at -transmission time; since the full size is unknown before the transfer starts, -such data is sent as chunks by HTTP and rejected by IMAP. - -Example: send an image to an HTTP server, where \(aqprofile\(aq is the name of the -form\-field to which the file \fBportrait.jpg\fP is the input: -.nf - -curl \-F profile=@portrait.jpg https://example.com/upload.cgi -.fi - -Example: send your name and shoe size in two text fields to the server: -.nf - -curl \-F name=John \-F shoesize=11 https://example.com/ -.fi - -Example: send your essay in a text field to the server. Send it as a plain -text field, but get the contents for it from a local file: -.nf - -curl \-F "story=HTML message;type=text/html\(aq \\ - \-F \(aq=)\(aq \-F \(aq=@textfile.txt\(aq ... smtp://example.com -.fi - -Data can be encoded for transfer using encoder=. Available encodings are -\fIbinary\fP and \fI8bit\fP that do nothing else than adding the corresponding -Content\-Transfer\-Encoding header, \fI7bit\fP that only rejects 8\-bit characters -with a transfer error, \fIquoted\-printable\fP and \fIbase64\fP that encodes data -according to the corresponding schemes, limiting lines length to 76 -characters. - -Example: send multipart mail with a quoted\-printable text message and a -base64 attached file: -.nf - -curl \-F \(aq=text message;encoder=quoted\-printable\(aq \\ - \-F \(aq=@localfile;encoder=base64\(aq ... smtp://example.com -.fi - -See further examples and details in the MANUAL. - ---form can be used several times in a command line - -Example: -.nf - curl --form "name=curl" --form "file=@loadthis" https://example.com -.fi - -See also \fI-d, \-\-data\fP, \fI\-\-form\-string\fP and \fI\-\-form\-escape\fP. This option is mutually exclusive to \fI-d, \-\-data\fP and \fI-I, \-\-head\fP and \fI-T, \-\-upload\-file\fP. -.IP "\-\-form\-escape" -(HTTP) Pass on names of multipart form fields and files using backslash\-escaping -instead of percent\-encoding. - -If --form-escape is provided several times, the last set value is used. - -Example: -.nf - curl --form-escape -F 'field\\name=curl' -F 'file=@load"this' https://example.com -.fi - -See also \fI-F, \-\-form\fP. Added in 7.81.0. -.IP "\-\-form\-string " -(HTTP SMTP IMAP) Similar to \fI\-F, \-\-form\fP except that the value string for the named parameter is used -literally. Leading @ and < characters, and the ";type=" string in the value -have no special meaning. Use this in preference to \fI\-F, \-\-form\fP if there is any -possibility that the string value may accidentally trigger the @ or < -features of \fI\-F, \-\-form\fP. - ---form-string can be used several times in a command line - -Example: -.nf - curl --form-string "name=data" https://example.com -.fi - -See also \fI-F, \-\-form\fP. -.IP "\-\-ftp\-account " -(FTP) When an FTP server asks for "account data" after username and password has -been provided, this data is sent off using the ACCT command. - -If --ftp-account is provided several times, the last set value is used. - -Example: -.nf - curl --ftp-account "mr.robot" ftp://example.com/ -.fi - -See also \fI-u, \-\-user\fP. -.IP "\-\-ftp\-alternative\-to\-user " -(FTP) If authenticating with the USER and PASS commands fails, send this command. -When connecting to Tumbleweed\(aqs Secure Transport server over FTPS using a -client certificate, using "SITE AUTH" tells the server to retrieve the -username from the certificate. - -If --ftp-alternative-to-user is provided several times, the last set value is used. - -Example: -.nf - curl --ftp-alternative-to-user "U53r" ftp://example.com -.fi - -See also \fI\-\-ftp\-account\fP and \fI-u, \-\-user\fP. -.IP "\-\-ftp\-create\-dirs" -(FTP SFTP) 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 -instead attempts to create missing directories. - -Providing --ftp-create-dirs multiple times has no extra effect. -Disable it again with \-\-no-ftp-create-dirs. - -Example: -.nf - curl --ftp-create-dirs -T file ftp://example.com/remote/path/file -.fi - -See also \fI\-\-create\-dirs\fP. -.IP "\-\-ftp\-method " -(FTP) 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: -.RS -.IP multicwd -Do a single CWD operation for each path part in the given URL. For deep -hierarchies this means many commands. This is how RFC 1738 says it should be -done. This is the default but the slowest behavior. -.IP nocwd -Do no CWD at all. curl does SIZE, RETR, STOR etc and gives the full path to -the server for each of these commands. This is the fastest behavior. -.IP singlecwd -Do one CWD with the full target directory and then operate on the file -\&"normally" (like in the multicwd case). This is somewhat more standards -compliant than "nocwd" but without the full penalty of "multicwd". -.RE -.IP - -If --ftp-method is provided several times, the last set value is used. - -Examples: -.nf - curl --ftp-method multicwd ftp://example.com/dir1/dir2/file - curl --ftp-method nocwd ftp://example.com/dir1/dir2/file - curl --ftp-method singlecwd ftp://example.com/dir1/dir2/file -.fi - -See also \fI-l, \-\-list\-only\fP. -.IP "\-\-ftp\-pasv" -(FTP) Use passive mode for the data connection. Passive is the internal default -behavior, but using this option can be used to override a previous \fI\-P, \-\-ftp\-port\fP -option. - -Reversing an enforced passive really is not doable but you must then instead -enforce the correct \fI\-P, \-\-ftp\-port\fP again. - -Passive mode means that curl tries the EPSV command first and then PASV, -unless \fI\-\-disable\-epsv\fP is used. - -Providing --ftp-pasv multiple times has no extra effect. -Disable it again with \-\-no-ftp-pasv. - -Example: -.nf - curl --ftp-pasv ftp://example.com/ -.fi - -See also \fI\-\-disable\-epsv\fP. -.IP "\-P, \-\-ftp\-port
" -(FTP) Reverses the default initiator/listener roles when connecting with FTP. This -option makes curl use active mode. curl then commands the server to connect -back to the client\(aqs specified address and port, while passive mode asks the -server to setup an IP address and port for it to connect to.
-should be one of: -.RS -.IP interface -e.g. \fBeth0\fP to specify which interface\(aqs IP address you want to use (Unix only) -.IP "IP address" -e.g. \fB192.168.10.1\fP to specify the exact IP address -.IP hostname -e.g. \fBmy.host.domain\fP to specify the machine -.IP - -make curl pick the same IP address that is already used for the control -connection. This is the recommended choice. -.RE -.IP -Disable the use of PORT with \fI\-\-ftp\-pasv\fP. Disable the attempt to use the EPRT -command instead of PORT by using \fI\-\-disable\-eprt\fP. 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 -lower to a higher number. A single number works as well, but do note that it -increases the risk of failure since the port may not be available. - - -If --ftp-port is provided several times, the last set value is used. - -Examples: -.nf - curl -P - ftp:/example.com - curl -P eth0 ftp:/example.com - curl -P 192.168.0.2 ftp:/example.com -.fi - -See also \fI\-\-ftp\-pasv\fP and \fI\-\-disable\-eprt\fP. -.IP "\-\-ftp\-pret" -(FTP) Send a PRET command before PASV (and EPSV). Certain FTP servers, mainly -drftpd, require this non\-standard command for directory listings as well as up -and downloads in PASV mode. - -Providing --ftp-pret multiple times has no extra effect. -Disable it again with \-\-no-ftp-pret. - -Example: -.nf - curl --ftp-pret ftp://example.com/ -.fi - -See also \fI-P, \-\-ftp\-port\fP and \fI\-\-ftp\-pasv\fP. -.IP "\-\-ftp\-skip\-pasv\-ip" -(FTP) Do not use the IP address the server suggests in its response to curl\(aqs PASV -command when curl connects the data connection. Instead curl reuses the same -IP address it already uses for the control connection. - -This option is enabled by default (added in 7.74.0). - -This option has no effect if PORT, EPRT or EPSV is used instead of PASV. - -Providing --ftp-skip-pasv-ip multiple times has no extra effect. -Disable it again with \-\-no-ftp-skip-pasv-ip. - -Example: -.nf - curl --ftp-skip-pasv-ip ftp://example.com/ -.fi - -See also \fI\-\-ftp\-pasv\fP. -.IP "\-\-ftp\-ssl\-ccc" -(FTP) Use CCC (Clear Command Channel) Shuts down the SSL/TLS layer after -authenticating. The rest of the control channel communication is be -unencrypted. This allows NAT routers to follow the FTP transaction. The -default mode is passive. - -Providing --ftp-ssl-ccc multiple times has no extra effect. -Disable it again with \-\-no-ftp-ssl-ccc. - -Example: -.nf - curl --ftp-ssl-ccc ftps://example.com/ -.fi - -See also \fI\-\-ssl\fP and \fI\-\-ftp\-ssl\-ccc\-mode\fP. -.IP "\-\-ftp\-ssl\-ccc\-mode " -(FTP) Sets the CCC mode. The passive mode does not initiate the shutdown, but -instead waits for the server to do it, and does not reply to the shutdown from -the server. The active mode initiates the shutdown and waits for a reply from -the server. - -Providing --ftp-ssl-ccc-mode multiple times has no extra effect. -Disable it again with \-\-no-ftp-ssl-ccc-mode. - -Example: -.nf - curl --ftp-ssl-ccc-mode active --ftp-ssl-ccc ftps://example.com/ -.fi - -See also \fI\-\-ftp\-ssl\-ccc\fP. -.IP "\-\-ftp\-ssl\-control" -(FTP) Require SSL/TLS for the FTP login, clear for transfer. Allows secure -authentication, but non\-encrypted data transfers for efficiency. Fails the -transfer if the server does not support SSL/TLS. - -Providing --ftp-ssl-control multiple times has no extra effect. -Disable it again with \-\-no-ftp-ssl-control. - -Example: -.nf - curl --ftp-ssl-control ftp://example.com -.fi - -See also \fI\-\-ssl\fP. -.IP "\-G, \-\-get" -(HTTP) When used, this option makes all data specified with \fI\-d, \-\-data\fP, \fI\-\-data\-binary\fP -or \fI\-\-data\-urlencode\fP to be used in an HTTP GET request instead of the POST -request that otherwise would be used. The data is appended to the URL -with a \(aq?\(aq separator. - -If used in combination with \fI\-I, \-\-head\fP, the POST data is instead appended to the -URL with a HEAD request. - -Providing --get multiple times has no extra effect. -Disable it again with \-\-no-get. - -Examples: -.nf - curl --get https://example.com - curl --get -d "tool=curl" -d "age=old" https://example.com - curl --get -I -d "tool=curl" https://example.com -.fi - -See also \fI-d, \-\-data\fP and \fI-X, \-\-request\fP. -.IP "\-g, \-\-globoff" -Switch off the URL globbing function. When you set this option, you can -specify URLs that contain the letters {}[] without having curl itself -interpret them. Note that these letters are not normal legal URL contents but -they should be encoded according to the URI standard. - -Providing --globoff multiple times has no extra effect. -Disable it again with \-\-no-globoff. - -Example: -.nf - curl -g "https://example.com/{[]}}}}" -.fi - -See also \fI-K, \-\-config\fP and \fI-q, \-\-disable\fP. -.IP "\-\-happy\-eyeballs\-timeout\-ms " -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 -number of milliseconds. If the IPv6 address cannot be connected to within that -time, then a connection attempt is made to the IPv4 address in parallel. The -first connection to be established is the one that is used. - -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 --happy-eyeballs-timeout-ms is provided several times, the last set value is used. - -Example: -.nf - curl --happy-eyeballs-timeout-ms 500 https://example.com -.fi - -See also \fI-m, \-\-max\-time\fP and \fI\-\-connect\-timeout\fP. Added in 7.59.0. -.IP "\-\-haproxy\-clientip " -(HTTP) Sets a client IP in HAProxy PROXY protocol v1 header at the beginning of the -connection. - -For valid requests, IPv4 addresses must be indicated as a series of exactly -4 integers in the range [0..255] inclusive written in decimal representation -separated by exactly one dot between each other. Heading zeroes are not -permitted in front of numbers in order to avoid any possible confusion -with octal numbers. IPv6 addresses must be indicated as series of 4 hexadecimal -digits (upper or lower case) delimited by colons between each other, with the -acceptance of one double colon sequence to replace the largest acceptable range -of consecutive zeroes. The total number of decoded bits must exactly be 128. - -Otherwise, any string can be accepted for the client IP and get sent. - -It replaces \fI\-\-haproxy\-protocol\fP if used, it is not necessary to specify both flags. - -If --haproxy-clientip is provided several times, the last set value is used. - -Example: -.nf - curl --haproxy-clientip $IP -.fi - -See also \fI-x, \-\-proxy\fP. Added in 8.2.0. -.IP "\-\-haproxy\-protocol" -(HTTP) Send a HAProxy PROXY protocol v1 header at the beginning of the connection. -This is used by some load balancers and reverse proxies to indicate the -client\(aqs true IP address and port. - -This option is primarily useful when sending test requests to a service that -expects this header. - -Providing --haproxy-protocol multiple times has no extra effect. -Disable it again with \-\-no-haproxy-protocol. - -Example: -.nf - curl --haproxy-protocol https://example.com -.fi - -See also \fI-x, \-\-proxy\fP. Added in 7.60.0. -.IP "\-I, \-\-head" -(HTTP FTP FILE) 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, -curl displays the file size and last modification time only. - -Providing --head multiple times has no extra effect. -Disable it again with \-\-no-head. - -Example: -.nf - curl -I https://example.com -.fi - -See also \fI-G, \-\-get\fP, \fI-v, \-\-verbose\fP and \fI\-\-trace\-ascii\fP. -.IP "\-H, \-\-header
" -(HTTP IMAP SMTP) Extra header to include in information sent. When used within an HTTP request, -it is added to the regular request headers. - -For an IMAP or SMTP MIME uploaded mail built with \fI\-F, \-\-form\fP options, it is -prepended to the resulting MIME document, effectively including it at the mail -global level. It does not affect raw uploaded mails (Added in 7.56.0). - -You may specify any number of extra headers. Note that if you should add a -custom header that has the same name as one of the internal ones curl would -use, your externally set header is used instead of the internal one. This -allows you to make even trickier stuff than curl would normally do. You should -not replace internally set headers without knowing perfectly well what you are -doing. Remove an internal header by giving a replacement without content on -the right side of the colon, as in: \-H "Host:". If you send the custom header -with no\-value then its header must be terminated with a semicolon, such as \-H -\&"X\-Custom\-Header;" to send "X\-Custom\-Header:". - -curl makes sure that each header you add/replace is sent with the proper -end\-of\-line marker, you should thus \fBnot\fP add that as a part of the header -content: do not add newlines or carriage returns, they only mess things up for -you. curl passes on the verbatim string you give it without any filter or -other safe guards. That includes white space and control characters. - -This option can take an argument in @filename style, which then adds a header -for each line in the input file. Using @\- makes curl read the header file from -stdin. Added in 7.55.0. - -Please note that most anti\-spam utilities check the presence and value of -several MIME mail headers: these are "From:", "To:", "Date:" and "Subject:" -among others and should be added with this option. - -You need \fI\-\-proxy\-header\fP to send custom headers intended for an HTTP -proxy. Added in 7.37.0. - -Passing on a "Transfer\-Encoding: chunked" header when doing an HTTP request -with a request body, makes curl send the data using chunked encoding. - -\fBWARNING\fP: headers set with this option are set in all HTTP requests \- even -after redirects are followed, like when told with \fI\-L, \-\-location\fP. This can 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. - ---header can be used several times in a command line - -Examples: -.nf - curl -H "X-First-Name: Joe" https://example.com - curl -H "User-Agent: yes-please/2000" https://example.com - curl -H "Host:" https://example.com - curl -H @headers.txt https://example.com -.fi - -See also \fI-A, \-\-user\-agent\fP and \fI-e, \-\-referer\fP. -.IP "\-h, \-\-help " -Usage help. List all curl command line options within the given \fBcategory\fP. - -If no argument is provided, curl displays the most important command line -arguments. - -For category \fBall\fP, curl displays help for all options. - -If \fBcategory\fP is specified, curl displays all available help categories. - -Example: -.nf - curl --help all -.fi - -See also \fI-v, \-\-verbose\fP. -.IP "\-\-hostpubmd5 " -(SFTP SCP) Pass a string containing 32 hexadecimal digits. The string should be the 128 -bit \fBMD5\fP checksum of the remote host\(aqs public key, curl refuses the -connection with the host unless the checksums match. - -If --hostpubmd5 is provided several times, the last set value is used. - -Example: -.nf - curl --hostpubmd5 e5c1c49020640a5ab0f2034854c321a8 sftp://example.com/ -.fi - -See also \fI\-\-hostpubsha256\fP. -.IP "\-\-hostpubsha256 " -(SFTP SCP) Pass a string containing a Base64\-encoded SHA256 hash of the remote host\(aqs -public key. Curl refuses the connection with the host unless the hashes match. - -This feature requires libcurl to be built with libssh2 and does not work with -other SSH backends. - -If --hostpubsha256 is provided several times, the last set value is used. - -Example: -.nf - curl --hostpubsha256 NDVkMTQxMGQ1ODdmMjQ3MjczYjAyOTY5MmRkMjVmNDQ= sftp://example.com/ -.fi - -See also \fI\-\-hostpubmd5\fP. Added in 7.80.0. -.IP "\-\-hsts " -(HTTPS) Enable HSTS for the transfer. If the filename points to an existing HSTS cache -file, that is used. After a completed transfer, the cache is saved to the -filename again if it has been modified. - -If curl is told to use HTTP:// for a transfer involving a hostname that exists -in the HSTS cache, it upgrades the transfer to use HTTPS. Each HSTS cache -entry has an individual life time after which the upgrade is no longer -performed. - -Specify a "" filename (zero length) to avoid loading/saving and make curl just -handle HSTS in memory. - -If this option is used several times, curl loads contents from all the -files but the last one is used for saving. - ---hsts can be used several times in a command line - -Example: -.nf - curl --hsts cache.txt https://example.com -.fi - -See also \fI\-\-proto\fP. Added in 7.74.0. -.IP "\-\-http0.9" -(HTTP) Accept an HTTP version 0.9 response. - -HTTP/0.9 is a response without headers and therefore you can also connect with -this to non\-HTTP servers and still get a response since curl simply -transparently downgrades \- if allowed. - -HTTP/0.9 is disabled by default (added in 7.66.0) - -Providing --http0.9 multiple times has no extra effect. -Disable it again with \-\-no-http0.9. - -Example: -.nf - curl --http0.9 https://example.com -.fi - -See also \fI\-\-http1.1\fP, \fI\-\-http2\fP and \fI\-\-http3\fP. Added in 7.64.0. -.IP "\-0, \-\-http1.0" -(HTTP) Use HTTP version 1.0 instead of using its internally preferred HTTP version. - -Providing --http1.0 multiple times has no extra effect. - -Example: -.nf - curl --http1.0 https://example.com -.fi - -See also \fI\-\-http0.9\fP and \fI\-\-http1.1\fP. This option is mutually exclusive to \fI\-\-http1.1\fP and \fI\-\-http2\fP and \fI\-\-http2\-prior\-knowledge\fP and \fI\-\-http3\fP. -.IP "\-\-http1.1" -(HTTP) Use HTTP version 1.1. This is the default with HTTP:// URLs. - -Providing --http1.1 multiple times has no extra effect. - -Example: -.nf - curl --http1.1 https://example.com -.fi - -See also \fI\-\-http1.0\fP and \fI\-\-http0.9\fP. This option is mutually exclusive to \fI\-\-http1.0\fP and \fI\-\-http2\fP and \fI\-\-http2\-prior\-knowledge\fP and \fI\-\-http3\fP. -.IP "\-\-http2" -(HTTP) Use HTTP/2. - -For HTTPS, this means curl negotiates HTTP/2 in the TLS handshake. curl does -this by default. - -For HTTP, this means curl attempts to upgrade the request to HTTP/2 using the -Upgrade: request header. - -When curl uses HTTP/2 over HTTPS, it does not itself insist on TLS 1.2 or -higher even though that is required by the specification. A user can add this -version requirement with \fI\-\-tlsv1.2\fP. - -Providing --http2 multiple times has no extra effect. - -Example: -.nf - curl --http2 https://example.com -.fi - -See also \fI\-\-http1.1\fP, \fI\-\-http3\fP and \fI\-\-no\-alpn\fP. \fI\-\-http2\fP requires that the underlying libcurl was built to support HTTP/2. This option is mutually exclusive to \fI\-\-http1.1\fP and \fI\-\-http1.0\fP and \fI\-\-http2\-prior\-knowledge\fP and \fI\-\-http3\fP. -.IP "\-\-http2\-prior\-knowledge" -(HTTP) Issue a non\-TLS HTTP requests using HTTP/2 directly without HTTP/1.1 Upgrade. -It requires prior knowledge that the server supports HTTP/2 straight away. -HTTPS requests still do HTTP/2 the standard way with negotiated protocol -version in the TLS handshake. - -Providing --http2-prior-knowledge multiple times has no extra effect. -Disable it again with \-\-no-http2-prior-knowledge. - -Example: -.nf - curl --http2-prior-knowledge https://example.com -.fi - -See also \fI\-\-http2\fP and \fI\-\-http3\fP. \fI\-\-http2\-prior\-knowledge\fP requires that the underlying libcurl was built to support HTTP/2. This option is mutually exclusive to \fI\-\-http1.1\fP and \fI\-\-http1.0\fP and \fI\-\-http2\fP and \fI\-\-http3\fP. -.IP "\-\-http3" -(HTTP) Attempt HTTP/3 to the host in the URL, but fallback to earlier HTTP versions -if the HTTP/3 connection establishment fails. HTTP/3 is only available for -HTTPS and not for HTTP URLs. - -This option allows a user to avoid using the Alt\-Svc method of upgrading to -HTTP/3 when you know that the target speaks HTTP/3 on the given host and port. - -When asked to use HTTP/3, curl issues a separate attempt to use older HTTP -versions with a slight delay, so if the HTTP/3 transfer fails or is slow, curl -still tries to proceed with an older HTTP version. - -Use \fI\-\-http3\-only\fP for similar functionality \fIwithout\fP a fallback. - -Providing --http3 multiple times has no extra effect. - -Example: -.nf - curl --http3 https://example.com -.fi - -See also \fI\-\-http1.1\fP and \fI\-\-http2\fP. \fI\-\-http3\fP requires that the underlying libcurl was built to support HTTP/3. This option is mutually exclusive to \fI\-\-http1.1\fP and \fI\-\-http1.0\fP and \fI\-\-http2\fP and \fI\-\-http2\-prior\-knowledge\fP and \fI\-\-http3\-only\fP. Added in 7.66.0. -.IP "\-\-http3\-only" -(HTTP) Instructs curl to use HTTP/3 to the host in the URL, with no fallback to -earlier HTTP versions. HTTP/3 can only be used for HTTPS and not for HTTP -URLs. For HTTP, this option triggers an error. - -This option allows a user to avoid using the Alt\-Svc method of upgrading to -HTTP/3 when you know that the target speaks HTTP/3 on the given host and port. - -This option makes curl fail if a QUIC connection cannot be established, it -does not attempt any other HTTP versions on its own. Use \fI\-\-http3\fP for similar -functionality \fIwith\fP a fallback. - -Providing --http3-only multiple times has no extra effect. - -Example: -.nf - curl --http3-only https://example.com -.fi - -See also \fI\-\-http1.1\fP, \fI\-\-http2\fP and \fI\-\-http3\fP. \fI\-\-http3\-only\fP requires that the underlying libcurl was built to support HTTP/3. This option is mutually exclusive to \fI\-\-http1.1\fP and \fI\-\-http1.0\fP and \fI\-\-http2\fP and \fI\-\-http2\-prior\-knowledge\fP and \fI\-\-http3\fP. Added in 7.88.0. -.IP "\-\-ignore\-content\-length" -(FTP HTTP) For HTTP, Ignore the Content\-Length header. This is particularly useful for -servers running Apache 1.x, which reports incorrect Content\-Length for -files larger than 2 gigabytes. - -For FTP, this makes curl skip the SIZE command to figure out the size before -downloading a file. - -This option does not work for HTTP if libcurl was built to use hyper. - -Providing --ignore-content-length multiple times has no extra effect. -Disable it again with \-\-no-ignore-content-length. - -Example: -.nf - curl --ignore-content-length https://example.com -.fi - -See also \fI\-\-ftp\-skip\-pasv\-ip\fP. -.IP "\-i, \-\-include" -(HTTP FTP) Include response headers in the output. HTTP response headers can include -things like server name, cookies, date of the document, HTTP version and -more... With non\-HTTP protocols, the "headers" are other server communication. - -To view the request headers, consider the \fI\-v, \-\-verbose\fP option. - -Prior to 7.75.0 curl did not print the headers if \fI\-f, \-\-fail\fP was used in -combination with this option and there was error reported by server. - -Providing --include multiple times has no extra effect. -Disable it again with \-\-no-include. - -Example: -.nf - curl -i https://example.com -.fi - -See also \fI-v, \-\-verbose\fP. -.IP "\-k, \-\-insecure" -(TLS SFTP SCP) 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 -and proceed without checking. - -When this option is not used for protocols using TLS, curl verifies the -server\(aqs TLS certificate before it continues: that the certificate contains -the right name which matches the hostname used in the URL and that the -certificate has been signed by a CA certificate present in the cert store. See -this online resource for further details: -\fBhttps://curl.se/docs/sslcerts.html\fP - -For SFTP and SCP, this option makes curl skip the \fIknown_hosts\fP verification. -\fIknown_hosts\fP is a file normally stored in the user\(aqs home directory in the -\&".ssh" subdirectory, which contains hostnames and their public keys. - -\fBWARNING\fP: using this option makes the transfer insecure. - -When curl uses secure protocols it trusts responses and allows for example -HSTS and Alt\-Svc information to be stored and used subsequently. Using -\fI\-k, \-\-insecure\fP can make curl trust and use such information from malicious -servers. - -Providing --insecure multiple times has no extra effect. -Disable it again with \-\-no-insecure. - -Example: -.nf - curl --insecure https://example.com -.fi - -See also \fI\-\-proxy\-insecure\fP, \fI\-\-cacert\fP and \fI\-\-capath\fP. -.IP "\-\-interface " -Perform an operation using a specified interface. You can enter interface -name, IP address or hostname. An example could look like: -.nf - -curl \--interface eth0:1 https://www.example.com/ -.fi - -On Linux it can be used to specify a \fBVRF\fP, but the binary needs to either -have \fBCAP_NET_RAW\fP or to be run as root. More information about Linux -\fBVRF\fP: https://www.kernel.org/doc/Documentation/networking/vrf.txt - -If --interface is provided several times, the last set value is used. - -Example: -.nf - curl --interface eth0 https://example.com -.fi - -See also \fI\-\-dns\-interface\fP. -.IP "\-\-ipfs\-gateway " -(IPFS) Specify which gateway to use for IPFS and IPNS URLs. Not specifying this -instead makes curl check if the IPFS_GATEWAY environment variable is set, or -if a "~/.ipfs/gateway" file holding the gateway URL exists. - -If you run a local IPFS node, this gateway is by default available under -\&"http://localhost:8080". A full example URL would look like: -.nf - -curl \--ipfs\-gateway http://localhost:8080 ipfs://bafybeigagd5nmnn2iys2f3doro7ydrevyr2mzarwidgadawmamiteydbzi -.fi - -There are many public IPFS gateways. See for example: -https://ipfs.github.io/public\-gateway\-checker/ - -If you opt to go for a remote gateway you need to be aware that you completely -trust the gateway. This might be fine in local gateways that you host -yourself. With remote gateways there could potentially be malicious actors -returning you data that does not match the request you made, inspect or even -interfere with the request. You may not notice this when using curl. A -mitigation could be to go for a "trustless" gateway. This means you locally -verify that the data. Consult the docs page on trusted vs trustless: -https://docs.ipfs.tech/reference/http/gateway/#trusted\-vs\-trustless - -If --ipfs-gateway is provided several times, the last set value is used. - -Example: -.nf - curl --ipfs-gateway https://example.com ipfs:// -.fi - -See also \fI-h, \-\-help\fP and \fI-M, \-\-manual\fP. Added in 8.4.0. -.IP "\-4, \-\-ipv4" -Use IPv4 addresses only when resolving hostnames, and not for example try -IPv6. - -Providing --ipv4 multiple times has no extra effect. - -Example: -.nf - curl --ipv4 https://example.com -.fi - -See also \fI\-\-http1.1\fP and \fI\-\-http2\fP. This option is mutually exclusive to \fI-6, \-\-ipv6\fP. -.IP "\-6, \-\-ipv6" -Use IPv6 addresses only when resolving hostnames, and not for example try -IPv4. - -Your resolver may respond to an IPv6\-only resolve request by returning IPv6 -addresses that contain "mapped" IPv4 addresses for compatibility purposes. -macOS is known to do this. - -Providing --ipv6 multiple times has no extra effect. - -Example: -.nf - curl --ipv6 https://example.com -.fi - -See also \fI\-\-http1.1\fP and \fI\-\-http2\fP. This option is mutually exclusive to \fI-4, \-\-ipv4\fP. -.IP "\-\-json " -(HTTP) Sends the specified JSON data in a POST request to the HTTP server. \fI\-\-json\fP -works as a shortcut for passing on these three options: -.nf - --\-data [arg] --\-header "Content\-Type: application/json" --\-header "Accept: application/json" -.fi - -There is \fBno verification\fP that the passed in data is actual JSON or that -the syntax is correct. - -If you start the data with the letter @, the rest should be a filename to read -the data from, or a single dash (\-) if you want curl to read the data from -stdin. Posting data from a file named \(aqfoobar\(aq would thus be done with \fI\-\-json\fP -@foobar and to instead read the data from stdin, use \fI\-\-json\fP @\-. - -If this option is used more than once on the same command line, the additional -data pieces are concatenated to the previous before sending. - -The headers this option sets can be overridden with \fI\-H, \-\-header\fP as usual. - ---json can be used several times in a command line - -Examples: -.nf - curl --json '{ "drink": "coffe" }' https://example.com - curl --json '{ "drink":' --json ' "coffe" }' https://example.com - curl --json @prepared https://example.com - curl --json @- https://example.com < json.txt -.fi - -See also \fI\-\-data\-binary\fP and \fI\-\-data\-raw\fP. This option is mutually exclusive to \fI-F, \-\-form\fP and \fI-I, \-\-head\fP and \fI-T, \-\-upload\-file\fP. Added in 7.82.0. -.IP "\-j, \-\-junk\-session\-cookies" -(HTTP) When curl is told to read cookies from a given file, this option makes it -discard all "session cookies". This has the same effect as if a new session is -started. Typical browsers discard session cookies when they are closed down. - -Providing --junk-session-cookies multiple times has no extra effect. -Disable it again with \-\-no-junk-session-cookies. - -Example: -.nf - curl --junk-session-cookies -b cookies.txt https://example.com -.fi - -See also \fI-b, \-\-cookie\fP and \fI-c, \-\-cookie\-jar\fP. -.IP "\-\-keepalive\-time " -Set the time a connection needs to remain idle before sending keepalive probes -and the time between individual keepalive probes. It is currently effective on -operating systems offering the "TCP_KEEPIDLE" and "TCP_KEEPINTVL" socket -options (meaning Linux, recent AIX, HP\-UX and more). Keepalive is used by the -TCP stack to detect broken networks on idle 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 \fI\-\-no\-keepalive\fP is used. - -If unspecified, the option defaults to 60 seconds. - -If --keepalive-time is provided several times, the last set value is used. - -Example: -.nf - curl --keepalive-time 20 https://example.com -.fi - -See also \fI\-\-no\-keepalive\fP and \fI-m, \-\-max\-time\fP. -.IP "\-\-key " -(TLS SSH) Private key filename. Allows you to provide your private key in this separate -file. For SSH, if not specified, curl tries the following candidates in order: -\&"~/.ssh/id_rsa", "~/.ssh/id_dsa", "./id_rsa", "./id_dsa". - -If curl is built against OpenSSL library, and the engine pkcs11 is available, -then a PKCS#11 URI (RFC 7512) can be used to specify a private key located in -a PKCS#11 device. A string beginning with "pkcs11:" is interpreted as a -PKCS#11 URI. If a PKCS#11 URI is provided, then the \fI\-\-engine\fP option is set as -\&"pkcs11" if none was provided and the \fI\-\-key\-type\fP option is set as "ENG" if -none was provided. - -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 --key is provided several times, the last set value is used. - -Example: -.nf - curl --cert certificate --key here https://example.com -.fi - -See also \fI\-\-key\-type\fP and \fI-E, \-\-cert\fP. -.IP "\-\-key\-type " -(TLS) Private key file type. Specify which type your \fI\-\-key\fP provided private key -is. DER, PEM, and ENG are supported. If not specified, PEM is assumed. - -If --key-type is provided several times, the last set value is used. - -Example: -.nf - curl --key-type DER --key here https://example.com -.fi - -See also \fI\-\-key\fP. -.IP "\-\-krb " -(FTP) Enable Kerberos authentication and use. The level must be entered and should -be one of \(aqclear\(aq, \(aqsafe\(aq, \(aqconfidential\(aq, or \(aqprivate\(aq. Should you use a -level that is not one of these, \(aqprivate\(aq is used. - -If --krb is provided several times, the last set value is used. - -Example: -.nf - curl --krb clear ftp://example.com/ -.fi - -See also \fI\-\-delegation\fP and \fI\-\-ssl\fP. \fI\-\-krb\fP requires that the underlying libcurl was built to support Kerberos. -.IP "\-\-libcurl " -Append this option to any ordinary curl command line, and you get -libcurl\-using C source code written to the file that does the equivalent of -what your command\-line operation does! - -This option is global and does not need to be specified for each use of --next. - -If --libcurl is provided several times, the last set value is used. - -Example: -.nf - curl --libcurl client.c https://example.com -.fi - -See also \fI-v, \-\-verbose\fP. -.IP "\-\-limit\-rate " -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 your transfer not to use your entire bandwidth. To make it slower than it -otherwise would be. - -The given speed is measured in bytes/second, unless a suffix is appended. -Appending \(aqk\(aq or \(aqK\(aq counts the number as kilobytes, \(aqm\(aq or \(aqM\(aq makes it -megabytes, while \(aqg\(aq or \(aqG\(aq makes it gigabytes. The suffixes (k, M, G, T, P) -are 1024 based. For example 1k is 1024. Examples: 200K, 3m and 1G. - -The rate limiting logic works on averaging the transfer speed to no more than -the set threshold over a period of multiple seconds. - -If you also use the \fI\-Y, \-\-speed\-limit\fP option, that option takes precedence and -might cripple the rate\-limiting slightly, to help keeping the speed\-limit -logic working. - -If --limit-rate is provided several times, the last set value is used. - -Examples: -.nf - curl --limit-rate 100K https://example.com - curl --limit-rate 1000 https://example.com - curl --limit-rate 10M https://example.com -.fi - -See also \fI\-\-rate\fP, \fI-Y, \-\-speed\-limit\fP and \fI-y, \-\-speed\-time\fP. -.IP "\-l, \-\-list\-only" -(FTP POP3 SFTP FILE) When listing an FTP directory, force a name\-only view. Maybe particularly -useful if the user wants to machine\-parse the contents of an FTP directory -since the normal directory view does not use a standard look or format. When -used like this, the option causes an NLST command to be sent to the server -instead of LIST. - -Note: Some FTP servers list only files in their response to NLST; they do not -include sub\-directories and symbolic links. - -When listing an SFTP directory, this switch forces a name\-only view, one per -line. This is especially useful if the user wants to machine\-parse the -contents of an SFTP directory since the normal directory view provides more -information than just filenames. - -When retrieving a specific email from POP3, this switch forces a LIST command -to be performed instead of RETR. This is particularly useful if the user wants -to see if a specific message\-id exists on the server and what size it is. - -For FILE, this option has no effect yet as directories are always listed in -this mode. - -Note: When combined with \fI\-X, \-\-request\fP, this option can be used to send a UIDL -command instead, so the user may use the email\(aqs unique identifier rather than -its message\-id to make the request. - -Providing --list-only multiple times has no extra effect. -Disable it again with \-\-no-list-only. - -Example: -.nf - curl --list-only ftp://example.com/dir/ -.fi - -See also \fI-Q, \-\-quote\fP and \fI-X, \-\-request\fP. -.IP "\-\-local\-port " -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 -so setting this range to something too narrow might cause unnecessary -connection setup failures. - -If --local-port is provided several times, the last set value is used. - -Example: -.nf - curl --local-port 1000-3000 https://example.com -.fi - -See also \fI-g, \-\-globoff\fP. -.IP "\-L, \-\-location" -(HTTP) 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 -option makes curl redo the request on the new place. If used together with -\fI\-i, \-\-include\fP or \fI\-I, \-\-head\fP, headers from all requested pages are shown. - -When authentication is used, curl only sends its credentials to the initial -host. If a redirect takes curl to a different host, it does not get the -user+password pass on. See also \fI\-\-location\-trusted\fP on how to change this. - -Limit the amount of redirects to follow by using the \fI\-\-max\-redirs\fP option. - -When curl follows a redirect and if the request is a POST, it sends the -following request with a GET if the HTTP response was 301, 302, or 303. If the -response code was any other 3xx code, curl resends the following request using -the same unmodified method. - -You can tell curl to not change POST requests to GET after a 30x response by -using the dedicated options for that: \fI\-\-post301\fP, \fI\-\-post302\fP and \fI\-\-post303\fP. - -The method set with \fI\-X, \-\-request\fP overrides the method curl would otherwise select -to use. - -Providing --location multiple times has no extra effect. -Disable it again with \-\-no-location. - -Example: -.nf - curl -L https://example.com -.fi - -See also \fI\-\-resolve\fP and \fI\-\-alt\-svc\fP. -.IP "\-\-location\-trusted" -(HTTP) Like \fI\-L, \-\-location\fP, but allows sending the name + password to all hosts that the -site may redirect to. This may or may not introduce a security breach if the -site redirects you to a site to which you send your authentication info (which -is clear\-text in the case of HTTP Basic authentication). - -Providing --location-trusted multiple times has no extra effect. -Disable it again with \-\-no-location-trusted. - -Example: -.nf - curl --location-trusted -u user:password https://example.com -.fi - -See also \fI-u, \-\-user\fP. -.IP "\-\-login\-options " -(IMAP LDAP POP3 SMTP) Specify the login options to use during server authentication. - -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 the IETF draft -https://datatracker.ietf.org/doc/html/draft\-earhart\-url\-smtp\-00 - -Since 8.2.0, IMAP supports the login option "AUTH=+LOGIN". With this option, -curl uses the plain (not SASL) "LOGIN IMAP" command even if the server -advertises SASL authentication. Care should be taken in using this option, as -it sends your password over the network in plain text. This does not work if -the IMAP server disables the plain "LOGIN" (e.g. to prevent password -snooping). - -If --login-options is provided several times, the last set value is used. - -Example: -.nf - curl --login-options 'AUTH=*' imap://example.com -.fi - -See also \fI-u, \-\-user\fP. -.IP "\-\-mail\-auth
" -(SMTP) Specify a single address. This is used to specify the authentication address -(identity) of a submitted message that is being relayed to another server. - -If --mail-auth is provided several times, the last set value is used. - -Example: -.nf - curl --mail-auth user@example.come -T mail smtp://example.com/ -.fi - -See also \fI\-\-mail\-rcpt\fP and \fI\-\-mail\-from\fP. -.IP "\-\-mail\-from
" -(SMTP) Specify a single address that the given mail should get sent from. - -If --mail-from is provided several times, the last set value is used. - -Example: -.nf - curl --mail-from user@example.com -T mail smtp://example.com/ -.fi - -See also \fI\-\-mail\-rcpt\fP and \fI\-\-mail\-auth\fP. -.IP "\-\-mail\-rcpt
" -(SMTP) Specify a single email address, username or mailing list name. Repeat this -option several times to send to multiple recipients. - -When performing an address verification (\fBVRFY\fP command), the recipient -should be specified as the username or username and domain (as per Section 3.5 -of RFC 5321). - -When performing a mailing list expand (EXPN command), the recipient should be -specified using the mailing list name, such as "Friends" or "London\-Office". - - ---mail-rcpt can be used several times in a command line - -Example: -.nf - curl --mail-rcpt user@example.net smtp://example.com -.fi - -See also \fI\-\-mail\-rcpt\-allowfails\fP. -.IP "\-\-mail\-rcpt\-allowfails" -(SMTP) When sending data to multiple recipients, by default curl aborts SMTP -conversation if at least one of the recipients causes RCPT TO command to -return an error. - -The default behavior can be changed by passing \fI\-\-mail\-rcpt\-allowfails\fP -command\-line option which makes curl ignore errors and proceed with the -remaining valid recipients. - -If all recipients trigger RCPT TO failures and this flag is specified, curl -still aborts the SMTP conversation and returns the error received from to the -last RCPT TO command. - -Providing --mail-rcpt-allowfails multiple times has no extra effect. -Disable it again with \-\-no-mail-rcpt-allowfails. - -Example: -.nf - curl --mail-rcpt-allowfails --mail-rcpt dest@example.com smtp://example.com -.fi - -See also \fI\-\-mail\-rcpt\fP. Added in 7.69.0. -.IP "\-M, \-\-manual" -Manual. Display the huge help text. - -Example: -.nf - curl --manual -.fi - -See also \fI-v, \-\-verbose\fP, \fI\-\-libcurl\fP and \fI\-\-trace\fP. -.IP "\-\-max\-filesize " -(FTP HTTP MQTT) Specify the maximum size (in bytes) of a file to download. If the file -requested is larger than this value, the transfer does not start and curl -returns with exit code 63. - -A size modifier may be used. For example, Appending \(aqk\(aq or \(aqK\(aq counts the -number as kilobytes, \(aqm\(aq or \(aqM\(aq makes it megabytes, while \(aqg\(aq or \(aqG\(aq makes it -gigabytes. Examples: 200K, 3m and 1G. (Added in 7.58.0) - -\fBNOTE\fP: before curl 8.4.0, when the file size is not known prior to -download, for such files this option has no effect even if the file transfer -ends up being larger than this given limit. - -Starting with curl 8.4.0, this option aborts the transfer if it reaches the -threshold during transfer. - -If --max-filesize is provided several times, the last set value is used. - -Example: -.nf - curl --max-filesize 100K https://example.com -.fi - -See also \fI\-\-limit\-rate\fP. -.IP "\-\-max\-redirs " -(HTTP) Set maximum number of redirections to follow. When \fI\-L, \-\-location\fP 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 --max-redirs is provided several times, the last set value is used. - -Example: -.nf - curl --max-redirs 3 --location https://example.com -.fi - -See also \fI-L, \-\-location\fP. -.IP "\-m, \-\-max\-time " -Set maximum time in seconds that you allow each transfer to take. Prevents -your batch jobs from hanging for hours due to slow networks or links going -down. This option accepts decimal values. - -If you enable retrying the transfer (\fI\-\-retry\fP) then the maximum time counter is -reset each time the transfer is retried. You can use \fI\-\-retry\-max\-time\fP to limit -the retry time. - -The decimal value needs to provided using a dot (.) as decimal separator \- not -the local version even if it might be using another separator. - -If --max-time is provided several times, the last set value is used. - -Examples: -.nf - curl --max-time 10 https://example.com - curl --max-time 2.92 https://example.com -.fi - -See also \fI\-\-connect\-timeout\fP and \fI\-\-retry\-max\-time\fP. -.IP "\-\-metalink" -This option was previously used to specify a Metalink resource. Metalink -support is disabled in curl for security reasons (added in 7.78.0). - -If --metalink is provided several times, the last set value is used. - -Example: -.nf - curl --metalink file https://example.com -.fi - -See also \fI-Z, \-\-parallel\fP. -.IP "\-\-negotiate" -(HTTP) Enable Negotiate (SPNEGO) authentication. - -This option requires a library built with GSS\-API or SSPI support. Use -\fI\-V, \-\-version\fP to see if your curl supports GSS\-API/SSPI or SPNEGO. - -When using this option, you must also provide a fake \fI\-u, \-\-user\fP option to activate -the authentication code properly. Sending a \(aq\-u :\(aq is enough as the username -and password from the \fI\-u, \-\-user\fP option are not actually used. - -Providing --negotiate multiple times has no extra effect. - -Example: -.nf - curl --negotiate -u : https://example.com -.fi - -See also \fI\-\-basic\fP, \fI\-\-ntlm\fP, \fI\-\-anyauth\fP and \fI\-\-proxy\-negotiate\fP. -.IP "\-n, \-\-netrc" -Make curl scan the \fI.netrc\fP file in the user\(aqs home directory for login name -and password. This is typically used for FTP on Unix. If used with HTTP, curl -enables user authentication. See \fInetrc(5)\fP and \fIftp(1)\fP for details on the -file format. Curl does not complain if that file does not have the right -permissions (it should be neither world\- nor group\-readable). The environment -variable "HOME" is used to find the home directory. - -On Windows two filenames in the home directory are checked: \fI.netrc\fP and -\fI_netrc\fP, preferring the former. Older versions on Windows checked for \fI_netrc\fP -only. - -A quick and simple example of how to setup a \fI.netrc\fP to allow curl to FTP to -the machine host.domain.com with username \(aqmyself\(aq and password \(aqsecret\(aq could -look similar to: -.nf - -machine host.domain.com -login myself -password secret - -Providing --netrc multiple times has no extra effect. -Disable it again with \-\-no-netrc. - -Example: -.nf - curl --netrc https://example.com -.fi - -See also \fI\-\-netrc\-file\fP, \fI-K, \-\-config\fP and \fI-u, \-\-user\fP. This option is mutually exclusive to \fI\-\-netrc\-file\fP and \fI\-\-netrc\-optional\fP. -.IP "\-\-netrc\-file " -Set the netrc file to use. Similar to \fI\-n, \-\-netrc\fP, except that you also provide -the path (absolute or relative). - -It abides by \fI\-\-netrc\-optional\fP if specified. - -If --netrc-file is provided several times, the last set value is used. - -Example: -.nf - curl --netrc-file netrc https://example.com -.fi - -See also \fI-n, \-\-netrc\fP, \fI-u, \-\-user\fP and \fI-K, \-\-config\fP. This option is mutually exclusive to \fI-n, \-\-netrc\fP. -.IP "\-\-netrc\-optional" -Similar to \fI\-n, \-\-netrc\fP, but this option makes the .netrc usage \fBoptional\fP -and not mandatory as the \fI\-n, \-\-netrc\fP option does. - -Providing --netrc-optional multiple times has no extra effect. -Disable it again with \-\-no-netrc-optional. - -Example: -.nf - curl --netrc-optional https://example.com -.fi - -See also \fI\-\-netrc\-file\fP. This option is mutually exclusive to \fI-n, \-\-netrc\fP. -.IP "\-:, \-\-next" -Use a separate operation for the following URL and associated options. This -allows you to send several URL requests, each with their own specific options, -for example, such as different usernames or custom requests for each. - -\fI\-:, \-\-next\fP resets all local options and only global ones have their values survive -over to the operation following the \fI\-:, \-\-next\fP instruction. Global options include -\fI\-v, \-\-verbose\fP, \fI\-\-trace\fP, \fI\-\-trace\-ascii\fP and \fI\-\-fail\-early\fP. - -For example, you can do both a GET and a POST in a single command line: -.nf - -curl www1.example.com \--next \-d postthis www2.example.com - ---next can be used several times in a command line - -Examples: -.nf - curl https://example.com --next -d postthis www2.example.com - curl -I https://example.com --next https://example.net/ -.fi - -See also \fI-Z, \-\-parallel\fP and \fI-K, \-\-config\fP. -.IP "\-\-no\-alpn" -(HTTPS) 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 -HTTP/2 to negotiate HTTP/2 support with the server during https sessions. - -Note that this is the negated option name documented. You can use \fI\-\-alpn\fP to -enable ALPN. - -Providing --no-alpn multiple times has no extra effect. -Disable it again with \-\-alpn. - -Example: -.nf - curl --no-alpn https://example.com -.fi - -See also \fI\-\-no\-npn\fP and \fI\-\-http2\fP. \fI\-\-no\-alpn\fP requires that the underlying libcurl was built to support TLS. -.IP "\-N, \-\-no\-buffer" -Disables the buffering of the output stream. In normal work situations, curl -uses a standard buffered output stream that has the effect that it outputs the -data in chunks, not necessarily exactly when the data arrives. Using this -option disables that buffering. - -Note that this is the negated option name documented. You can use \fI\-\-buffer\fP to -enable buffering again. - -Providing --no-buffer multiple times has no extra effect. -Disable it again with \-\-buffer. - -Example: -.nf - curl --no-buffer https://example.com -.fi - -See also \fI-#, \-\-progress\-bar\fP. -.IP "\-\-no\-clobber" -When used in conjunction with the \fI\-o, \-\-output\fP, \fI\-J, \-\-remote\-header\-name\fP, -\fI\-O, \-\-remote\-name\fP, or \fI\-\-remote\-name\-all\fP options, curl avoids overwriting files -that already exist. Instead, a dot and a number gets appended to the name of -the file that would be created, up to filename.100 after which it does not -create any file. - -Note that this is the negated option name documented. You can thus use -\fI\-\-clobber\fP to enforce the clobbering, even if \fI\-J, \-\-remote\-header\-name\fP is -specified. - -Providing --no-clobber multiple times has no extra effect. -Disable it again with \-\-clobber. - -Example: -.nf - curl --no-clobber --output local/dir/file https://example.com -.fi - -See also \fI-o, \-\-output\fP and \fI-O, \-\-remote\-name\fP. Added in 7.83.0. -.IP "\-\-no\-keepalive" -Disables the use of keepalive messages on the TCP connection. curl otherwise -enables them by default. - -Note that this is the negated option name documented. You can thus use -\fI\-\-keepalive\fP to enforce keepalive. - -Providing --no-keepalive multiple times has no extra effect. -Disable it again with \-\-keepalive. - -Example: -.nf - curl --no-keepalive https://example.com -.fi - -See also \fI\-\-keepalive\-time\fP. -.IP "\-\-no\-npn" -(HTTPS) curl never uses NPN, this option has no effect (added in 7.86.0). - -Disable the NPN TLS extension. NPN is enabled by default if libcurl was built -with an SSL library that supports NPN. NPN is used by a libcurl that supports -HTTP/2 to negotiate HTTP/2 support with the server during https sessions. - -Providing --no-npn multiple times has no extra effect. -Disable it again with \-\-npn. - -Example: -.nf - curl --no-npn https://example.com -.fi - -See also \fI\-\-no\-alpn\fP and \fI\-\-http2\fP. \fI\-\-no\-npn\fP requires that the underlying libcurl was built to support TLS. -.IP "\-\-no\-progress\-meter" -Option to switch off the progress meter output without muting or otherwise -affecting warning and informational messages like \fI\-s, \-\-silent\fP does. - -Note that this is the negated option name documented. You can thus use -\fI\-\-progress\-meter\fP to enable the progress meter again. - -Providing --no-progress-meter multiple times has no extra effect. -Disable it again with \-\-progress-meter. - -Example: -.nf - curl --no-progress-meter -o store https://example.com -.fi - -See also \fI-v, \-\-verbose\fP and \fI-s, \-\-silent\fP. Added in 7.67.0. -.IP "\-\-no\-sessionid" -(TLS) Disable curl\(aqs use of SSL session\-ID caching. By default all transfers are -done using the cache. Note that while nothing should ever get hurt by -attempting to reuse SSL session\-IDs, there seem to be broken SSL -implementations in the wild that may require you to disable this in order for -you to succeed. - -Note that this is the negated option name documented. You can thus use -\fI\-\-sessionid\fP to enforce session\-ID caching. - -Providing --no-sessionid multiple times has no extra effect. -Disable it again with \-\-sessionid. - -Example: -.nf - curl --no-sessionid https://example.com -.fi - -See also \fI-k, \-\-insecure\fP. -.IP "\-\-noproxy " -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, and effectively disables the proxy. Each name in this list is matched -as either a domain which contains the hostname, or the hostname itself. For -example, "local.com" would match "local.com", "local.com:80", and -\&"www.local.com", but not "www.notlocal.com". - -This option overrides the environment variables that disable the proxy -("no_proxy" and "NO_PROXY") (added in 7.53.0). If there is an environment -variable disabling a proxy, you can set the no proxy list to "" to override -it. - -IP addresses specified to this option can be provided using CIDR notation -(added in 7.86.0): an appended slash and number specifies the number of -network bits out of the address to use in the comparison. For example -\&"192.168.0.0/16" would match all addresses starting with "192.168". - -If --noproxy is provided several times, the last set value is used. - -Example: -.nf - curl --noproxy "www.example" https://example.com -.fi - -See also \fI-x, \-\-proxy\fP. -.IP "\-\-ntlm" -(HTTP) Use NTLM authentication. The NTLM authentication method was designed by -Microsoft and is used by IIS web servers. It is a proprietary protocol, -reverse\-engineered by clever people and implemented in curl based on their -efforts. This kind of behavior should not be endorsed, you should encourage -everyone who uses NTLM to switch to a public and documented authentication -method instead, such as Digest. - -If you want to enable NTLM for your proxy authentication, then use -\fI\-\-proxy\-ntlm\fP. - -Providing --ntlm multiple times has no extra effect. - -Example: -.nf - curl --ntlm -u user:password https://example.com -.fi - -See also \fI\-\-proxy\-ntlm\fP. \fI\-\-ntlm\fP requires that the underlying libcurl was built to support TLS. This option is mutually exclusive to \fI\-\-basic\fP and \fI\-\-negotiate\fP and \fI\-\-digest\fP and \fI\-\-anyauth\fP. -.IP "\-\-ntlm\-wb" -(HTTP) Deprecated option (added in 8.8.0). - -Enabled NTLM much in the style \fI\-\-ntlm\fP does, but handed over the authentication -to a separate executable that was executed when needed. - -Providing --ntlm-wb multiple times has no extra effect. - -Example: -.nf - curl --ntlm-wb -u user:password https://example.com -.fi - -See also \fI\-\-ntlm\fP and \fI\-\-proxy\-ntlm\fP. -.IP "\-\-oauth2\-bearer " -(IMAP LDAP POP3 SMTP HTTP) Specify the Bearer Token for OAUTH 2.0 server authentication. The Bearer Token -is used in conjunction with the username which can be specified as part of the -\fI\-\-url\fP or \fI\-u, \-\-user\fP options. - -The Bearer Token and username are formatted according to RFC 6750. - -If --oauth2-bearer is provided several times, the last set value is used. - -Example: -.nf - curl --oauth2-bearer "mF_9.B5f-4.1JqM" https://example.com -.fi - -See also \fI\-\-basic\fP, \fI\-\-ntlm\fP and \fI\-\-digest\fP. -.IP "\-o, \-\-output " -Write output to the given file instead of stdout. If you are using globbing to -fetch multiple documents, you should quote the URL and you can use "#" -followed by a number in the filename. That variable is then replaced with the -current string for the URL being fetched. Like in: -.nf - -curl "http://{one,two}.example.com" \-o "file_#1.txt" -.fi - -or use several variables like: -.nf - -curl "http://{site,host}.host[1\-5].example" \-o "#1_#2" -.fi - -You may use this option as many times as the number of URLs you have. For -example, if you specify two URLs on the same command line, you can use it like -this: -.nf - -curl \-o aa example.com \-o bb example.net -.fi - -and the order of the \-o options and the URLs does not matter, just that the -first \-o is for the first URL and so on, so the above command line can also be -written as -.nf - -curl example.com example.net \-o aa \-o bb -.fi - -See also the \fI\-\-create\-dirs\fP option to create the local directories -dynamically. Specifying the output as \(aq\-\(aq (a single dash) passes the output to -stdout. - -To suppress response bodies, you can redirect output to /dev/null: -.nf - -curl example.com \-o /dev/null -.fi - -Or for Windows: -.nf - -curl example.com \-o nul -.fi - -Specify the filename as single minus to force the output to stdout, to -override curl\(aqs internal binary output in terminal prevention: -.nf - -curl https://example.com/jpeg \-o \- - ---output can be used several times in a command line - -Examples: -.nf - curl -o file https://example.com - curl "http://{one,two}.example.com" -o "file_#1.txt" - curl "http://{site,host}.host[1-5].example" -o "#1_#2" - curl -o file https://example.com -o file2 https://example.net -.fi - -See also \fI-O, \-\-remote\-name\fP, \fI\-\-remote\-name\-all\fP and \fI-J, \-\-remote\-header\-name\fP. -.IP "\-\-output\-dir " -Specify the directory in which files should be stored, when \fI\-O, \-\-remote\-name\fP or -\fI\-o, \-\-output\fP are used. - -The given output directory is used for all URLs and output options on the -command line, up until the first \fI\-:, \-\-next\fP. - -If the specified target directory does not exist, the operation fails unless -\fI\-\-create\-dirs\fP is also used. - -If --output-dir is provided several times, the last set value is used. - -Example: -.nf - curl --output-dir "tmp" -O https://example.com -.fi - -See also \fI-O, \-\-remote\-name\fP and \fI-J, \-\-remote\-header\-name\fP. Added in 7.73.0. -.IP "\-Z, \-\-parallel" -Makes curl perform its transfers in parallel as compared to the regular serial -manner. - -This option is global and does not need to be specified for each use of --next. - -Providing --parallel multiple times has no extra effect. -Disable it again with \-\-no-parallel. - -Example: -.nf - curl --parallel https://example.com -o file1 https://example.com -o file2 -.fi - -See also \fI-:, \-\-next\fP and \fI-v, \-\-verbose\fP. Added in 7.66.0. -.IP "\-\-parallel\-immediate" -When doing parallel transfers, this option instructs curl that it should -rather prefer opening up more connections in parallel at once rather than -waiting to see if new transfers can be added as multiplexed streams on another -connection. - -This option is global and does not need to be specified for each use of --next. - -Providing --parallel-immediate multiple times has no extra effect. -Disable it again with \-\-no-parallel-immediate. - -Example: -.nf - curl --parallel-immediate -Z https://example.com -o file1 https://example.com -o file2 -.fi - -See also \fI-Z, \-\-parallel\fP and \fI\-\-parallel\-max\fP. Added in 7.68.0. -.IP "\-\-parallel\-max " -When asked to do parallel transfers, using \fI\-Z, \-\-parallel\fP, this option controls -the maximum amount of transfers to do simultaneously. - -This option is global and does not need to be specified for each use of -\fI\-:, \-\-next\fP. - -The default is 50. - -If --parallel-max is provided several times, the last set value is used. - -Example: -.nf - curl --parallel-max 100 -Z https://example.com ftp://example.com/ -.fi - -See also \fI-Z, \-\-parallel\fP. Added in 7.66.0. -.IP "\-\-pass " -(SSH TLS) Passphrase for the private key. - -If --pass is provided several times, the last set value is used. - -Example: -.nf - curl --pass secret --key file https://example.com -.fi - -See also \fI\-\-key\fP and \fI-u, \-\-user\fP. -.IP "\-\-path\-as\-is" -Do not handle sequences of /../ or /./ in the given URL path. Normally curl -squashes or merges them according to standards but with this option set you -tell it not to do that. - -Providing --path-as-is multiple times has no extra effect. -Disable it again with \-\-no-path-as-is. - -Example: -.nf - curl --path-as-is https://example.com/../../etc/passwd -.fi - -See also \fI\-\-request\-target\fP. -.IP "\-\-pinnedpubkey " -(TLS) 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 or DER format, or -any number of base64 encoded sha256 hashes preceded by \(aqsha256//\(aq and -separated by \(aq;\(aq. - -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 -aborts the connection before sending or receiving any data. - -This option is independent of option \fI\-k, \-\-insecure\fP. If you use both options -together then the peer is still verified by public key. - -PEM/DER support: - -OpenSSL and GnuTLS, wolfSSL (added in 7.43.0), mbedTLS -, Secure Transport macOS 10.7+/iOS 10+ (7.54.1), Schannel -(7.58.1) - -sha256 support: - -OpenSSL, GnuTLS and wolfSSL, mbedTLS (added in 7.47.0), -Secure Transport macOS 10.7+/iOS 10+ (7.54.1), Schannel (7.58.1) - -Other SSL backends not supported. - -If --pinnedpubkey is provided several times, the last set value is used. - -Examples: -.nf - curl --pinnedpubkey keyfile https://example.com - curl --pinnedpubkey 'sha256//ce118b51897f4452dc' https://example.com -.fi - -See also \fI\-\-hostpubsha256\fP. -.IP "\-\-post301" -(HTTP) Respect RFC 7231/6.4.2 and do not convert POST requests into GET requests when -following a 301 redirect. The non\-RFC behavior is ubiquitous in web browsers, -so curl does the conversion by default to maintain consistency. However, a -server may require a POST to remain a POST after such a redirection. This -option is meaningful only when using \fI\-L, \-\-location\fP. - -Providing --post301 multiple times has no extra effect. -Disable it again with \-\-no-post301. - -Example: -.nf - curl --post301 --location -d "data" https://example.com -.fi - -See also \fI\-\-post302\fP, \fI\-\-post303\fP and \fI-L, \-\-location\fP. -.IP "\-\-post302" -(HTTP) Respect RFC 7231/6.4.3 and do not convert POST requests into GET requests when -following a 302 redirect. The non\-RFC behavior is ubiquitous in web browsers, -so curl does the conversion by default to maintain consistency. However, a -server may require a POST to remain a POST after such a redirection. This -option is meaningful only when using \fI\-L, \-\-location\fP. - -Providing --post302 multiple times has no extra effect. -Disable it again with \-\-no-post302. - -Example: -.nf - curl --post302 --location -d "data" https://example.com -.fi - -See also \fI\-\-post301\fP, \fI\-\-post303\fP and \fI-L, \-\-location\fP. -.IP "\-\-post303" -(HTTP) Violate RFC 7231/6.4.4 and do not convert POST requests into GET requests when -following 303 redirect. A server may require a POST to remain a POST after a -303 redirection. This option is meaningful only when using \fI\-L, \-\-location\fP. - -Providing --post303 multiple times has no extra effect. -Disable it again with \-\-no-post303. - -Example: -.nf - curl --post303 --location -d "data" https://example.com -.fi - -See also \fI\-\-post302\fP, \fI\-\-post301\fP and \fI-L, \-\-location\fP. -.IP "\-\-preproxy [protocol://]host[:port]" -Use the specified SOCKS proxy before connecting to an HTTP or HTTPS \fI\-x, \-\-proxy\fP. In -such a case curl first connects to the SOCKS proxy and then connects (through -SOCKS) to the HTTP or HTTPS proxy. Hence pre proxy. - -The pre proxy string should be specified with a protocol:// prefix to specify -alternative proxy protocols. Use socks4://, socks4a://, socks5:// or -socks5h:// to request the specific SOCKS version to be used. No protocol -specified makes curl default to SOCKS4. - -If the port number is not specified in the proxy string, it is assumed to be -1080. - -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 --preproxy is provided several times, the last set value is used. - -Example: -.nf - curl --preproxy socks5://proxy.example -x http://http.example https://example.com -.fi - -See also \fI-x, \-\-proxy\fP and \fI\-\-socks5\fP. Added in 7.52.0. -.IP "\-#, \-\-progress\-bar" -Make curl display transfer progress as a simple progress bar instead of the -standard, more informational, meter. - -This progress bar draws a single line of \(aq#\(aq characters across the screen and -shows a percentage if the transfer size is known. For transfers without a -known size, there is a space ship (\-=o=\-) that moves back and forth but only -while data is being transferred, with a set of flying hash sign symbols on -top. - -This option is global and does not need to be specified for each use of --next. - -Providing --progress-bar multiple times has no extra effect. -Disable it again with \-\-no-progress-bar. - -Example: -.nf - curl -# -O https://example.com -.fi - -See also \fI\-\-styled\-output\fP. -.IP "\-\-proto " -Limit what protocols to allow for transfers. Protocols are evaluated left to -right, are comma separated, and are each a protocol name or \(aqall\(aq, optionally -prefixed by zero or more modifiers. Available modifiers are: -.RS -.IP + -Permit this protocol in addition to protocols already permitted (this is -the default if no modifier is used). -.IP - -Deny this protocol, removing it from the list of protocols already permitted. -.IP = -Permit only this protocol (ignoring the list already permitted), though -subject to later modification by subsequent entries in the comma separated -list. -.RE -.IP -For example: \fI\-\-proto\fP \-ftps uses the default protocols, but disables ftps - -\fI\-\-proto\fP \-all,https,+http only enables http and https - -\fI\-\-proto\fP =http,https also only enables http and https - -Unknown and disabled protocols produce a warning. This allows scripts to -safely rely on being able to disable potentially dangerous protocols, without -relying upon support for that protocol being built into curl to avoid an error. - -This option can be used multiple times, in which case the effect is the same -as concatenating the protocols into one instance of the option. - -If --proto is provided several times, the last set value is used. - -Example: -.nf - curl --proto =http,https,sftp https://example.com -.fi - -See also \fI\-\-proto\-redir\fP and \fI\-\-proto\-default\fP. -.IP "\-\-proto\-default " -Use \fIprotocol\fP for any provided URL missing a scheme. - -An unknown or unsupported protocol causes error \fICURLE_UNSUPPORTED_PROTOCOL\fP. - -This option does not change the default proxy protocol (http). - -Without this option set, curl guesses protocol based on the hostname, see -\fI\-\-url\fP for details. - -If --proto-default is provided several times, the last set value is used. - -Example: -.nf - curl --proto-default https ftp.example.com -.fi - -See also \fI\-\-proto\fP and \fI\-\-proto\-redir\fP. -.IP "\-\-proto\-redir " -Limit what protocols to allow on redirects. Protocols denied by \fI\-\-proto\fP are -not overridden by this option. See \fI\-\-proto\fP for how protocols are represented. - -Example, allow only HTTP and HTTPS on redirect: -.nf - -curl \--proto\-redir \-all,http,https http://example.com -.fi - -By default curl only allows HTTP, HTTPS, FTP and FTPS on redirects (added in -7.65.2). Specifying \fIall\fP or \fI+all\fP enables all protocols on redirects, which -is not good for security. - -If --proto-redir is provided several times, the last set value is used. - -Example: -.nf - curl --proto-redir =http,https https://example.com -.fi - -See also \fI\-\-proto\fP. -.IP "\-x, \-\-proxy [protocol://]host[:port]" -Use the specified proxy. - -The proxy string can be specified with a protocol:// prefix. No protocol -specified or http:// it is treated as an HTTP proxy. Use socks4://, -socks4a://, socks5:// or socks5h:// to request a specific SOCKS version to be -used. - -Unix domain sockets are supported for socks proxy. Set localhost for the host -part. e.g. socks5h://localhost/path/to/socket.sock - -HTTPS proxy support works set with the https:// protocol prefix for OpenSSL -and GnuTLS (added in 7.52.0). It also works for BearSSL, mbedTLS, rustls, -Schannel, Secure Transport and wolfSSL (added in 7.87.0). - -Unrecognized and unsupported proxy protocols cause an error (added in 7.52.0). -Ancient curl versions ignored unknown schemes and used http:// instead. - -If the port number is not specified in the proxy string, it is assumed to be -1080. - -This option overrides existing environment variables that set the proxy to -use. If there is an environment variable setting a proxy, you can set proxy to -\&"" to override it. - -All operations that are performed over an HTTP proxy are transparently -converted to HTTP. It means that certain protocol specific operations might -not be available. This is not the case if you can tunnel through the proxy, as -one with the \fI\-p, \-\-proxytunnel\fP option. - -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. - -The proxy host can be specified the same way as the proxy environment -variables, including the protocol prefix (http://) and the embedded user + -password. - -When a proxy is used, the active FTP mode as set with \fI\-P, \-\-ftp\-port\fP, cannot be -used. - -If --proxy is provided several times, the last set value is used. - -Example: -.nf - curl --proxy http://proxy.example https://example.com -.fi - -See also \fI\-\-socks5\fP and \fI\-\-proxy\-basic\fP. -.IP "\-\-proxy\-anyauth" -Automatically pick a suitable authentication method when communicating with -the given HTTP proxy. This might cause an extra request/response round\-trip. - -Providing --proxy-anyauth multiple times has no extra effect. - -Example: -.nf - curl --proxy-anyauth --proxy-user user:passwd -x proxy https://example.com -.fi - -See also \fI-x, \-\-proxy\fP, \fI\-\-proxy\-basic\fP and \fI\-\-proxy\-digest\fP. -.IP "\-\-proxy\-basic" -Use HTTP Basic authentication when communicating with the given proxy. Use -\fI\-\-basic\fP for enabling HTTP Basic with a remote host. Basic is the default -authentication method curl uses with proxies. - -Providing --proxy-basic multiple times has no extra effect. - -Example: -.nf - curl --proxy-basic --proxy-user user:passwd -x proxy https://example.com -.fi - -See also \fI-x, \-\-proxy\fP, \fI\-\-proxy\-anyauth\fP and \fI\-\-proxy\-digest\fP. -.IP "\-\-proxy\-ca\-native" -(TLS) Use the CA store from the native operating system to verify the HTTPS proxy. -By default, curl uses a CA store provided in a single file or directory, but -when using this option it interfaces the operating system\(aqs own vault. - -This option works for curl on Windows when built to use OpenSSL, wolfSSL -(added in 8.3.0) or GnuTLS (added in 8.5.0). When curl on Windows is built to -use Schannel, this feature is implied and curl then only uses the native CA -store. - -Providing --proxy-ca-native multiple times has no extra effect. -Disable it again with \-\-no-proxy-ca-native. - -Example: -.nf - curl --ca-native https://example.com -.fi - -See also \fI\-\-cacert\fP, \fI\-\-capath\fP and \fI-k, \-\-insecure\fP. Added in 8.2.0. -.IP "\-\-proxy\-cacert " -Same as \fI\-\-cacert\fP but used in HTTPS proxy context. - -If --proxy-cacert is provided several times, the last set value is used. - -Example: -.nf - curl --proxy-cacert CA-file.txt -x https://proxy https://example.com -.fi - -See also \fI\-\-proxy\-capath\fP, \fI\-\-cacert\fP, \fI\-\-capath\fP and \fI-x, \-\-proxy\fP. Added in 7.52.0. -.IP "\-\-proxy\-capath " -Same as \fI\-\-capath\fP but used in HTTPS proxy context. - -Use the specified certificate directory to verify the proxy. Multiple paths -can be provided by separated with colon (":") (e.g. "path1:path2:path3"). The -certificates must be in PEM format, and if curl is built against OpenSSL, the -directory must have been processed using the c_rehash utility supplied with -OpenSSL. Using \fI\-\-proxy\-capath\fP can allow OpenSSL\-powered curl to make -SSL\-connections much more efficiently than using \fI\-\-proxy\-cacert\fP if the -\fI\-\-proxy\-cacert\fP file contains many CA certificates. - -If this option is set, the default capath value is ignored. - -If --proxy-capath is provided several times, the last set value is used. - -Example: -.nf - curl --proxy-capath /local/directory -x https://proxy https://example.com -.fi - -See also \fI\-\-proxy\-cacert\fP, \fI-x, \-\-proxy\fP and \fI\-\-capath\fP. Added in 7.52.0. -.IP "\-\-proxy\-cert " -Same as \fI\-E, \-\-cert\fP but used in HTTPS proxy context. - -If --proxy-cert is provided several times, the last set value is used. - -Example: -.nf - curl --proxy-cert file -x https://proxy https://example.com -.fi - -See also \fI\-\-proxy\-cert\-type\fP. Added in 7.52.0. -.IP "\-\-proxy\-cert\-type " -Same as \fI\-\-cert\-type\fP but used in HTTPS proxy context. - -If --proxy-cert-type is provided several times, the last set value is used. - -Example: -.nf - curl --proxy-cert-type PEM --proxy-cert file -x https://proxy https://example.com -.fi - -See also \fI\-\-proxy\-cert\fP. Added in 7.52.0. -.IP "\-\-proxy\-ciphers " -Same as \fI\-\-ciphers\fP but used in HTTPS proxy context. - -Specifies which ciphers to use in the connection to the HTTPS proxy. 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 --proxy-ciphers is provided several times, the last set value is used. - -Example: -.nf - curl --proxy-ciphers ECDHE-ECDSA-AES256-CCM8 -x https://proxy https://example.com -.fi - -See also \fI\-\-ciphers\fP, \fI\-\-curves\fP and \fI-x, \-\-proxy\fP. Added in 7.52.0. -.IP "\-\-proxy\-crlfile " -Same as \fI\-\-crlfile\fP but used in HTTPS proxy context. - -If --proxy-crlfile is provided several times, the last set value is used. - -Example: -.nf - curl --proxy-crlfile rejects.txt -x https://proxy https://example.com -.fi - -See also \fI\-\-crlfile\fP and \fI-x, \-\-proxy\fP. Added in 7.52.0. -.IP "\-\-proxy\-digest" -Use HTTP Digest authentication when communicating with the given proxy. Use -\fI\-\-digest\fP for enabling HTTP Digest with a remote host. - -Providing --proxy-digest multiple times has no extra effect. - -Example: -.nf - curl --proxy-digest --proxy-user user:passwd -x proxy https://example.com -.fi - -See also \fI-x, \-\-proxy\fP, \fI\-\-proxy\-anyauth\fP and \fI\-\-proxy\-basic\fP. -.IP "\-\-proxy\-header
" -(HTTP) 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 \fI\-H, \-\-header\fP -but is for proxy communication only like in CONNECT requests when you want a -separate header sent to the proxy to what is sent to the actual remote host. - -curl makes sure that each header you add/replace is sent with the proper -end\-of\-line marker, you should thus \fBnot\fP add that as a part of the header -content: do not add newlines or carriage returns, they only mess things up for -you. - -Headers specified with this option are not included in requests that curl -knows are not be sent to a proxy. - -This option can take an argument in @filename style, which then adds a header -for each line in the input file (added in 7.55.0). Using @\- makes curl read -the headers from stdin. - -This option can be used multiple times to add/replace/remove multiple headers. - ---proxy-header can be used several times in a command line - -Examples: -.nf - curl --proxy-header "X-First-Name: Joe" -x http://proxy https://example.com - curl --proxy-header "User-Agent: surprise" -x http://proxy https://example.com - curl --proxy-header "Host:" -x http://proxy https://example.com -.fi - -See also \fI-x, \-\-proxy\fP. -.IP "\-\-proxy\-http2" -(HTTP) Negotiate HTTP/2 with an HTTPS proxy. The proxy might still only offer HTTP/1 -and then curl sticks to using that version. - -This has no effect for any other kinds of proxies. - -Providing --proxy-http2 multiple times has no extra effect. -Disable it again with \-\-no-proxy-http2. - -Example: -.nf - curl --proxy-http2 -x proxy https://example.com -.fi - -See also \fI-x, \-\-proxy\fP. \fI\-\-proxy\-http2\fP requires that the underlying libcurl was built to support HTTP/2. Added in 8.1.0. -.IP "\-\-proxy\-insecure" -Same as \fI\-k, \-\-insecure\fP but used in HTTPS proxy context. - -Every secure connection curl makes is verified to be secure before the -transfer takes place. This option makes curl skip the verification step with a -proxy and proceed without checking. - -When this option is not used for a proxy using HTTPS, curl verifies the -proxy\(aqs TLS certificate before it continues: that the certificate contains the -right name which matches the hostname and that the certificate has been signed -by a CA certificate present in the cert store. See this online resource for -further details: \fBhttps://curl.se/docs/sslcerts.html\fP - -\fBWARNING\fP: using this option makes the transfer to the proxy insecure. - -Providing --proxy-insecure multiple times has no extra effect. -Disable it again with \-\-no-proxy-insecure. - -Example: -.nf - curl --proxy-insecure -x https://proxy https://example.com -.fi - -See also \fI-x, \-\-proxy\fP and \fI-k, \-\-insecure\fP. Added in 7.52.0. -.IP "\-\-proxy\-key " -Same as \fI\-\-key\fP but used in HTTPS proxy context. - -If --proxy-key is provided several times, the last set value is used. - -Example: -.nf - curl --proxy-key here -x https://proxy https://example.com -.fi - -See also \fI\-\-proxy\-key\-type\fP and \fI-x, \-\-proxy\fP. Added in 7.52.0. -.IP "\-\-proxy\-key\-type " -Same as \fI\-\-key\-type\fP but used in HTTPS proxy context. - -If --proxy-key-type is provided several times, the last set value is used. - -Example: -.nf - curl --proxy-key-type DER --proxy-key here -x https://proxy https://example.com -.fi - -See also \fI\-\-proxy\-key\fP and \fI-x, \-\-proxy\fP. Added in 7.52.0. -.IP "\-\-proxy\-negotiate" -Use HTTP Negotiate (SPNEGO) authentication when communicating with the given -proxy. Use \fI\-\-negotiate\fP for enabling HTTP Negotiate (SPNEGO) with a remote -host. - -Providing --proxy-negotiate multiple times has no extra effect. - -Example: -.nf - curl --proxy-negotiate --proxy-user user:passwd -x proxy https://example.com -.fi - -See also \fI\-\-proxy\-anyauth\fP and \fI\-\-proxy\-basic\fP. -.IP "\-\-proxy\-ntlm" -Use HTTP NTLM authentication when communicating with the given proxy. Use -\fI\-\-ntlm\fP for enabling NTLM with a remote host. - -Providing --proxy-ntlm multiple times has no extra effect. - -Example: -.nf - curl --proxy-ntlm --proxy-user user:passwd -x http://proxy https://example.com -.fi - -See also \fI\-\-proxy\-negotiate\fP and \fI\-\-proxy\-anyauth\fP. -.IP "\-\-proxy\-pass " -Same as \fI\-\-pass\fP but used in HTTPS proxy context. - -If --proxy-pass is provided several times, the last set value is used. - -Example: -.nf - curl --proxy-pass secret --proxy-key here -x https://proxy https://example.com -.fi - -See also \fI-x, \-\-proxy\fP and \fI\-\-proxy\-key\fP. Added in 7.52.0. -.IP "\-\-proxy\-pinnedpubkey " -(TLS) 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 or DER format, or -any number of base64 encoded sha256 hashes preceded by \(aqsha256//\(aq and -separated by \(aq;\(aq. - -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 -aborts the connection before sending or receiving any data. - -If --proxy-pinnedpubkey is provided several times, the last set value is used. - -Examples: -.nf - curl --proxy-pinnedpubkey keyfile https://example.com - curl --proxy-pinnedpubkey 'sha256//ce118b51897f4452dc' https://example.com -.fi - -See also \fI\-\-pinnedpubkey\fP and \fI-x, \-\-proxy\fP. Added in 7.59.0. -.IP "\-\-proxy\-service\-name " -Set the service name for proxy negotiation. - -If --proxy-service-name is provided several times, the last set value is used. - -Example: -.nf - curl --proxy-service-name "shrubbery" -x proxy https://example.com -.fi - -See also \fI\-\-service\-name\fP and \fI-x, \-\-proxy\fP. -.IP "\-\-proxy\-ssl\-allow\-beast" -Same as \fI\-\-ssl\-allow\-beast\fP but used in HTTPS proxy context. - -Providing --proxy-ssl-allow-beast multiple times has no extra effect. -Disable it again with \-\-no-proxy-ssl-allow-beast. - -Example: -.nf - curl --proxy-ssl-allow-beast -x https://proxy https://example.com -.fi - -See also \fI\-\-ssl\-allow\-beast\fP and \fI-x, \-\-proxy\fP. Added in 7.52.0. -.IP "\-\-proxy\-ssl\-auto\-client\-cert" -Same as \fI\-\-ssl\-auto\-client\-cert\fP but used in HTTPS proxy context. - -This is only supported by Schannel. - -Providing --proxy-ssl-auto-client-cert multiple times has no extra effect. -Disable it again with \-\-no-proxy-ssl-auto-client-cert. - -Example: -.nf - curl --proxy-ssl-auto-client-cert -x https://proxy https://example.com -.fi - -See also \fI\-\-ssl\-auto\-client\-cert\fP and \fI-x, \-\-proxy\fP. Added in 7.77.0. -.IP "\-\-proxy\-tls13\-ciphers " -(TLS) Specify 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 ciphers. -Read up on TLS 1.3 cipher suite details on this URL: - -https://curl.se/docs/ssl\-ciphers.html - -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 \fI\-\-proxy\-ciphers\fP option. - -If --proxy-tls13-ciphers is provided several times, the last set value is used. - -Example: -.nf - curl --proxy-tls13-ciphers TLS_AES_128_GCM_SHA256 -x proxy https://example.com -.fi - -See also \fI\-\-tls13\-ciphers\fP, \fI\-\-curves\fP and \fI\-\-proxy\-ciphers\fP. Added in 7.61.0. -.IP "\-\-proxy\-tlsauthtype " -Same as \fI\-\-tlsauthtype\fP but used in HTTPS proxy context. - -If --proxy-tlsauthtype is provided several times, the last set value is used. - -Example: -.nf - curl --proxy-tlsauthtype SRP -x https://proxy https://example.com -.fi - -See also \fI-x, \-\-proxy\fP and \fI\-\-proxy\-tlsuser\fP. Added in 7.52.0. -.IP "\-\-proxy\-tlspassword " -Same as \fI\-\-tlspassword\fP but used in HTTPS proxy context. - -If --proxy-tlspassword is provided several times, the last set value is used. - -Example: -.nf - curl --proxy-tlspassword passwd -x https://proxy https://example.com -.fi - -See also \fI-x, \-\-proxy\fP and \fI\-\-proxy\-tlsuser\fP. Added in 7.52.0. -.IP "\-\-proxy\-tlsuser " -Same as \fI\-\-tlsuser\fP but used in HTTPS proxy context. - -If --proxy-tlsuser is provided several times, the last set value is used. - -Example: -.nf - curl --proxy-tlsuser smith -x https://proxy https://example.com -.fi - -See also \fI-x, \-\-proxy\fP and \fI\-\-proxy\-tlspassword\fP. Added in 7.52.0. -.IP "\-\-proxy\-tlsv1" -Same as \fI\-1, \-\-tlsv1\fP but used in HTTPS proxy context. - -Providing --proxy-tlsv1 multiple times has no extra effect. - -Example: -.nf - curl --proxy-tlsv1 -x https://proxy https://example.com -.fi - -See also \fI-x, \-\-proxy\fP. Added in 7.52.0. -.IP "\-U, \-\-proxy\-user " -Specify the username and password to use for proxy authentication. - -If you use a Windows SSPI\-enabled curl binary and do either Negotiate or NTLM -authentication then you can tell curl to select the username and password from -your environment by specifying a single colon with this option: "\-U :". - -On systems where it works, curl hides the given option argument from process -listings. This is not enough to protect credentials from possibly getting seen -by other users on the same system as they still are 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 --proxy-user is provided several times, the last set value is used. - -Example: -.nf - curl --proxy-user smith:secret -x proxy https://example.com -.fi - -See also \fI\-\-proxy\-pass\fP. -.IP "\-\-proxy1.0 " -Use the specified HTTP 1.0 proxy. If the port number is not specified, it is -assumed at port 1080. - -The only difference between this and the HTTP proxy option \fI\-x, \-\-proxy\fP, is that -attempts to use CONNECT through the proxy specifies an HTTP 1.0 protocol -instead of the default HTTP 1.1. - -Providing --proxy1.0 multiple times has no extra effect. - -Example: -.nf - curl --proxy1.0 http://proxy https://example.com -.fi - -See also \fI-x, \-\-proxy\fP, \fI\-\-socks5\fP and \fI\-\-preproxy\fP. -.IP "\-p, \-\-proxytunnel" -When an HTTP proxy is used \fI\-x, \-\-proxy\fP, this option makes curl tunnel the traffic -through the proxy. The tunnel approach is made with the HTTP proxy CONNECT -request and requires that the proxy allows direct connect to the remote port -number curl wants to tunnel through to. - -To suppress proxy CONNECT response headers when curl is set to output headers -use \fI\-\-suppress\-connect\-headers\fP. - -Providing --proxytunnel multiple times has no extra effect. -Disable it again with \-\-no-proxytunnel. - -Example: -.nf - curl --proxytunnel -x http://proxy https://example.com -.fi - -See also \fI-x, \-\-proxy\fP. -.IP "\-\-pubkey " -(SFTP SCP) Public key filename. Allows you to provide your public key in this separate -file. - -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 libssh2 1.2.8 -or higher that is itself linked against OpenSSL. - -If --pubkey is provided several times, the last set value is used. - -Example: -.nf - curl --pubkey file.pub sftp://example.com/ -.fi - -See also \fI\-\-pass\fP. -.IP "\-Q, \-\-quote " -(FTP SFTP) Send an arbitrary command to the remote FTP or SFTP server. Quote commands are -sent BEFORE the transfer takes place (just after the initial \fBPWD\fP command -in an FTP transfer, to be exact). To make commands take place after a -successful transfer, prefix them with a dash \(aq\-\(aq. - -(FTP only) To make commands be sent after curl has changed the working -directory, just before the file transfer command(s), prefix the command with a -\(aq+\(aq. This is not performed when a directory listing is performed. - -You may specify any number of commands. - -By default curl stops at first failure. To make curl continue even if the -command fails, prefix the command with an asterisk (*). Otherwise, if the -server returns failure for one of the commands, the entire operation is -aborted. - -You must send syntactically correct FTP commands as RFC 959 defines to FTP -servers, or one of the commands listed below to SFTP servers. - -SFTP is a binary protocol. Unlike for FTP, curl interprets SFTP quote commands -itself before sending them to the server. Filenames may be quoted shell\-style -to embed spaces or special characters. Following is the list of all supported -SFTP quote commands: -.RS -.IP "atime date file" -The atime command sets the last access time of the file named by the file -operand. The date expression can be all sorts of date strings, see the -\fIcurl_getdate(3)\fP man page for date expression details. (Added in 7.73.0) -.IP "chgrp group file" -The chgrp command sets the group ID of the file named by the file operand to -the group ID specified by the group operand. The group operand is a decimal -integer group ID. -.IP "chmod mode file" -The chmod command modifies the file mode bits of the specified file. The -mode operand is an octal integer mode number. -.IP "chown user file" -The chown command sets the owner of the file named by the file operand to the -user ID specified by the user operand. The user operand is a decimal -integer user ID. -.IP "ln source_file target_file" -The ln and symlink commands create a symbolic link at the target_file location -pointing to the source_file location. -.IP "mkdir directory_name" -The mkdir command creates the directory named by the directory_name operand. -.IP "mtime date file" -The mtime command sets the last modification time of the file named by the -file operand. The date expression can be all sorts of date strings, see the -\fIcurl_getdate(3)\fP man page for date expression details. (Added in 7.73.0) -.IP pwd -The pwd command returns the absolute path name of the current working directory. -.IP "rename source target" -The rename command renames the file or directory named by the source -operand to the destination path named by the target operand. -.IP "rm file" -The rm command removes the file specified by the file operand. -.IP "rmdir directory" -The rmdir command removes the directory entry specified by the directory -operand, provided it is empty. -.IP "symlink source_file target_file" -See ln. -.RE -.IP - ---quote can be used several times in a command line - -Example: -.nf - curl --quote "DELE file" ftp://example.com/foo -.fi - -See also \fI-X, \-\-request\fP. -.IP "\-\-random\-file " -Deprecated option. This option is ignored (added in 7.84.0). Prior to that it -only had an effect on curl if built to use old versions of OpenSSL. - -Specify the path name to file containing random data. The data may be used to -seed the random engine for SSL connections. - -If --random-file is provided several times, the last set value is used. - -Example: -.nf - curl --random-file rubbish https://example.com -.fi - -See also \fI\-\-egd\-file\fP. -.IP "\-r, \-\-range " -(HTTP FTP SFTP FILE) 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. -.RS -.IP 0-499 -specifies the first 500 bytes -.IP 500-999 -specifies the second 500 bytes -.IP -500 -specifies the last 500 bytes -.IP 9500- -specifies the bytes from offset 9500 and forward -.IP 0-0,-1 -specifies the first and last byte only(*)(HTTP) -.IP 100-199,500-599 -specifies two separate 100\-byte ranges(*) (HTTP) -.RE -.IP -(*) = NOTE that these make the server reply with a multipart response, which -is returned as\-is by curl! Parsing or otherwise transforming this response is -the responsibility of the caller. - -Only digit characters (0\-9) are valid in the \(aqstart\(aq and \(aqstop\(aq fields of the -\(aqstart\-stop\(aq range syntax. If a non\-digit character is given in the range, the -server\(aqs response is unspecified, depending on the server\(aqs configuration. - -Many HTTP/1.1 servers do not have this feature enabled, so that when you -attempt to get a range, curl instead gets the whole document. - -FTP and SFTP range downloads only support the simple \(aqstart\-stop\(aq syntax -(optionally with one of the numbers omitted). FTP use depends on the extended -FTP command SIZE. - -If --range is provided several times, the last set value is used. - -Example: -.nf - curl --range 22-44 https://example.com -.fi - -See also \fI-C, \-\-continue\-at\fP and \fI-a, \-\-append\fP. -.IP "\-\-rate " -Specify the maximum transfer frequency you allow curl to use \- in number of -transfer starts per time unit (sometimes called request rate). Without this -option, curl starts the next transfer as fast as possible. - -If given several URLs and a transfer completes faster than the allowed rate, -curl waits until the next transfer is started to maintain the requested -rate. This option has no effect when \fI\-Z, \-\-parallel\fP is used. - -The request rate is provided as "N/U" where N is an integer number and U is a -time unit. Supported units are \(aqs\(aq (second), \(aqm\(aq (minute), \(aqh\(aq (hour) and \(aqd\(aq -/(day, as in a 24 hour unit). The default time unit, if no "/U" is provided, -is number of transfers per hour. - -If curl is told to allow 10 requests per minute, it does not start the next -request until 6 seconds have elapsed since the previous transfer was started. - -This function uses millisecond resolution. If the allowed frequency is set -more than 1000 per second, it instead runs unrestricted. - -When retrying transfers, enabled with \fI\-\-retry\fP, the separate retry delay logic -is used and not this setting. - -This option is global and does not need to be specified for each use of --next. - -If --rate is provided several times, the last set value is used. - -Examples: -.nf - curl --rate 2/s https://example.com ... - curl --rate 3/h https://example.com ... - curl --rate 14/m https://example.com ... -.fi - -See also \fI\-\-limit\-rate\fP and \fI\-\-retry\-delay\fP. Added in 7.84.0. -.IP "\-\-raw" -(HTTP) When used, it disables all internal HTTP decoding of content or transfer -encodings and instead makes them passed on unaltered, raw. - -Providing --raw multiple times has no extra effect. -Disable it again with \-\-no-raw. - -Example: -.nf - curl --raw https://example.com -.fi - -See also \fI\-\-tr\-encoding\fP. -.IP "\-e, \-\-referer " -(HTTP) Set the referrer URL in the HTTP request. This can also be set with the -\fI\-H, \-\-header\fP flag of course. When used with \fI\-L, \-\-location\fP you can append ";auto"" to -the \fI\-e, \-\-referer\fP 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 \fI\-e, \-\-referer\fP. - -If --referer is provided several times, the last set value is used. - -Examples: -.nf - curl --referer "https://fake.example" https://example.com - curl --referer "https://fake.example;auto" -L https://example.com - curl --referer ";auto" -L https://example.com -.fi - -See also \fI-A, \-\-user\-agent\fP and \fI-H, \-\-header\fP. -.IP "\-J, \-\-remote\-header\-name" -(HTTP) Tell the \fI\-O, \-\-remote\-name\fP option to use the server\-specified Content\-Disposition -filename instead of extracting a filename from the URL. If the server\-provided -filename contains a path, that is stripped off before the filename is used. - -The file is saved in the current directory, or in the directory specified with -\fI\-\-output\-dir\fP. - -If the server specifies a filename and a file with that name already exists in -the destination directory, it is not overwritten and an error occurs \- unless -you allow it by using the \fI\-\-clobber\fP option. If the server does not specify a -filename then this option has no effect. - -There is no attempt to decode %\-sequences (yet) in the provided filename, so -this option may provide you with rather unexpected filenames. - -This feature uses the name from the "filename" field, it does not yet support -the "filename*" field (filenames with explicit character sets). - -\fBWARNING\fP: Exercise judicious use of this option, especially on Windows. A -rogue server could send you the name of a DLL or other file that could be -loaded automatically by Windows or some third party software. - -Providing --remote-header-name multiple times has no extra effect. -Disable it again with \-\-no-remote-header-name. - -Example: -.nf - curl -OJ https://example.com/file -.fi - -See also \fI-O, \-\-remote\-name\fP. -.IP "\-O, \-\-remote\-name" -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.) - -The file is saved in the current working directory. If you want the file saved -in a different directory, make sure you change the current working directory -before invoking curl with this option or use \fI\-\-output\-dir\fP. - -The remote filename to use for saving is extracted from the given URL, nothing -else, and if it already exists it is overwritten. If you want the server to be -able to choose the filename refer to \fI\-J, \-\-remote\-header\-name\fP which can be used in -addition to this option. If the server chooses a filename and that name -already exists it is not overwritten. - -There is no URL decoding done on the filename. If it has %20 or other URL -encoded parts of the name, they end up as\-is as filename. - -You may use this option as many times as the number of URLs you have. - ---remote-name can be used several times in a command line - -Example: -.nf - curl -O https://example.com/filename -.fi - -See also \fI\-\-remote\-name\-all\fP, \fI\-\-output\-dir\fP and \fI-J, \-\-remote\-header\-name\fP. -.IP "\-\-remote\-name\-all" -Change the default action for all given URLs to be dealt with as if -\fI\-O, \-\-remote\-name\fP were used for each one. If you want to disable that for a -specific URL after \fI\-\-remote\-name\-all\fP has been used, you must use "\-o \-" or -\fI\-\-no\-remote\-name\fP. - -Providing --remote-name-all multiple times has no extra effect. -Disable it again with \-\-no-remote-name-all. - -Example: -.nf - curl --remote-name-all ftp://example.com/file1 ftp://example.com/file2 -.fi - -See also \fI-O, \-\-remote\-name\fP. -.IP "\-R, \-\-remote\-time" -Makes curl attempt to figure out the timestamp of the remote file that is -getting downloaded, and if that is available make the local file get that same -timestamp. - -Providing --remote-time multiple times has no extra effect. -Disable it again with \-\-no-remote-time. - -Example: -.nf - curl --remote-time -o foo https://example.com -.fi - -See also \fI-O, \-\-remote\-name\fP and \fI-z, \-\-time\-cond\fP. -.IP "\-\-remove\-on\-error" -Remove output file if an error occurs. If curl returns an error when told to -save output in a local file. This prevents curl from leaving a partial file in -the case of an error during transfer. - -If the output is not a regular file, this option has no effect. - -Providing --remove-on-error multiple times has no extra effect. -Disable it again with \-\-no-remove-on-error. - -Example: -.nf - curl --remove-on-error -o output https://example.com -.fi - -See also \fI-f, \-\-fail\fP. Added in 7.83.0. -.IP "\-X, \-\-request " -Change the method to use when starting the transfer. - -curl passes on the verbatim string you give it its the request without any -filter or other safe guards. That includes white space and control characters. -.RS -.IP HTTP -Specifies a custom request method to use when communicating with the HTTP -server. The specified request method is used instead of the method otherwise -used (which defaults to \fIGET\fP). Read the HTTP 1.1 specification for details -and explanations. Common additional HTTP requests include \fIPUT\fP and \fIDELETE\fP, -while related technologies like WebDAV offers \fIPROPFIND\fP, \fICOPY\fP, \fIMOVE\fP and -more. - -Normally you do not need this option. All sorts of \fIGET\fP, \fIHEAD\fP, \fIPOST\fP and -\fIPUT\fP requests are rather invoked by using dedicated command line options. - -This option only changes the actual word used in the HTTP request, it does not -alter the way curl behaves. For example if you want to make a proper HEAD -request, using \-X HEAD does not suffice. You need to use the \fI\-I, \-\-head\fP option. - -The method string you set with \fI\-X, \-\-request\fP is used for all requests, which -if you for example use \fI\-L, \-\-location\fP may cause unintended side\-effects when curl -does not change request method according to the HTTP 30x response codes \- and -similar. -.IP FTP -Specifies a custom FTP command to use instead of \fILIST\fP when doing file lists -with FTP. -.IP POP3 -Specifies a custom POP3 command to use instead of \fILIST\fP or \fIRETR\fP. - -.IP IMAP -Specifies a custom IMAP command to use instead of \fILIST\fP. -.IP SMTP -Specifies a custom SMTP command to use instead of \fIHELP\fP or \fBVRFY\fP. -.RE -.IP - -If --request is provided several times, the last set value is used. - -Examples: -.nf - curl -X "DELETE" https://example.com - curl -X NLST ftp://example.com/ -.fi - -See also \fI\-\-request\-target\fP. -.IP "\-\-request\-target " -(HTTP) Use an alternative target (path) instead of using the path as provided in the -URL. Particularly useful when wanting to issue HTTP requests without leading -slash or other data that does not follow the regular URL pattern, like -\&"OPTIONS *". - -curl passes on the verbatim string you give it its the request without any -filter or other safe guards. That includes white space and control characters. - -If --request-target is provided several times, the last set value is used. - -Example: -.nf - curl --request-target "*" -X OPTIONS https://example.com -.fi - -See also \fI-X, \-\-request\fP. Added in 7.55.0. -.IP "\-\-resolve <[+]host:port:addr[,addr]...>" -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 -otherwise normally resolved address to be used. Consider it a sort of -/etc/hosts alternative provided on the command line. The port number should be -the number used for the specific protocol the host is used for. It means -you need several entries if you want to provide address for the same host but -different ports. - -By specifying "*" as host you can tell curl to resolve any host and specific -port pair to the specified address. Wildcard is resolved last so any \fI\-\-resolve\fP -with a specific host and port is used first. - -The provided address set by this option is used even if \fI\-4, \-\-ipv4\fP or \fI\-6, \-\-ipv6\fP is -set to make curl use another IP version. - -By prefixing the host with a \(aq+\(aq you can make the entry time out after curl\(aqs -default timeout (1 minute). Note that this only makes sense for long running -parallel transfers with a lot of files. In such cases, if this option is used -curl tries to resolve the host as it normally would once the timeout has -expired. - -Support for providing the IP address within [brackets] was added in 7.57.0. - -Support for providing multiple IP addresses per entry was added in 7.59.0. - -Support for resolving with wildcard was added in 7.64.0. - -Support for the \(aq+\(aq prefix was added in 7.75.0. - ---resolve can be used several times in a command line - -Example: -.nf - curl --resolve example.com:443:127.0.0.1 https://example.com -.fi - -See also \fI\-\-connect\-to\fP and \fI\-\-alt\-svc\fP. -.IP "\-\-retry " -If a transient error is returned when curl tries to perform a transfer, it -retries this number of times before giving up. Setting the number to 0 -makes curl do no retries (which is the default). Transient error means either: -a timeout, an FTP 4xx response code or an HTTP 408, 429, 500, 502, 503 or 504 -response code. - -When curl is about to retry a transfer, it first waits one second and then for -all forthcoming retries it doubles the waiting time until it reaches 10 -minutes which then remains delay between the rest of the retries. By using -\fI\-\-retry\-delay\fP you disable this exponential backoff algorithm. See also -\fI\-\-retry\-max\-time\fP to limit the total time allowed for retries. - -curl complies with the Retry\-After: response header if one was present to know -when to issue the next retry (added in 7.66.0). - -If --retry is provided several times, the last set value is used. - -Example: -.nf - curl --retry 7 https://example.com -.fi - -See also \fI\-\-retry\-max\-time\fP. -.IP "\-\-retry\-all\-errors" -Retry on any error. This option is used together with \fI\-\-retry\fP. - -This option is the "sledgehammer" of retrying. Do not use this option by -default (for example in your \fBcurlrc\fP), there may be unintended consequences -such as sending or receiving duplicate data. Do not use with redirected input -or output. You might be better off handling your unique problems in a shell -script. Please read the example below. - -\fBWARNING\fP: For server compatibility curl attempts to retry failed flaky -transfers as close as possible to how they were started, but this is not -possible with redirected input or output. For example, before retrying it -removes output data from a failed partial transfer that was written to an -output file. However this is not true of data redirected to a | pipe or > -file, which are not reset. We strongly suggest you do not parse or record -output via redirect in combination with this option, since you may receive -duplicate data. - -By default curl does not return error for transfers with an HTTP response code -that indicates an HTTP error, if the transfer was successful. For example, if -a server replies 404 Not Found and the reply is fully received then that is -not an error. When \fI\-\-retry\fP is used then curl retries on some HTTP response -codes that indicate transient HTTP errors, but that does not include most 4xx -response codes such as 404. If you want to retry on all response codes that -indicate HTTP errors (4xx and 5xx) then combine with \fI\-f, \-\-fail\fP. - -Providing --retry-all-errors multiple times has no extra effect. -Disable it again with \-\-no-retry-all-errors. - -Example: -.nf - curl --retry 5 --retry-all-errors https://example.com -.fi - -See also \fI\-\-retry\fP. Added in 7.71.0. -.IP "\-\-retry\-connrefused" -In addition to the other conditions, consider ECONNREFUSED as a transient -error too for \fI\-\-retry\fP. This option is used together with \fI\-\-retry\fP. - -Providing --retry-connrefused multiple times has no extra effect. -Disable it again with \-\-no-retry-connrefused. - -Example: -.nf - curl --retry-connrefused --retry 7 https://example.com -.fi - -See also \fI\-\-retry\fP and \fI\-\-retry\-all\-errors\fP. Added in 7.52.0. -.IP "\-\-retry\-delay " -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 \fI\-\-retry\fP is also -used. Setting this delay to zero makes curl use the default backoff time. - -If --retry-delay is provided several times, the last set value is used. - -Example: -.nf - curl --retry-delay 5 --retry 7 https://example.com -.fi - -See also \fI\-\-retry\fP. -.IP "\-\-retry\-max\-time " -The retry timer is reset before the first transfer attempt. Retries are done -as usual (see \fI\-\-retry\fP) as long as the timer has not reached this given -limit. Notice that if the timer has not reached the limit, the request is -made and while performing, it may take longer than this given time period. To -limit a single request\(aqs maximum time, use \fI\-m, \-\-max\-time\fP. Set this option to zero -to not timeout retries. - -If --retry-max-time is provided several times, the last set value is used. - -Example: -.nf - curl --retry-max-time 30 --retry 10 https://example.com -.fi - -See also \fI\-\-retry\fP. -.IP "\-\-sasl\-authzid " -Use this authorization identity (\fBauthzid\fP), during SASL PLAIN -authentication, in addition to the authentication identity (\fBauthcid\fP) as -specified by \fI\-u, \-\-user\fP. - -If the option is not specified, the server derives the \fBauthzid\fP from the -\fBauthcid\fP, but if specified, and depending on the server implementation, it -may be used to access another user\(aqs inbox, that the user has been granted -access to, or a shared mailbox for example. - -If --sasl-authzid is provided several times, the last set value is used. - -Example: -.nf - curl --sasl-authzid zid imap://example.com/ -.fi - -See also \fI\-\-login\-options\fP. Added in 7.66.0. -.IP "\-\-sasl\-ir" -Enable initial response in SASL authentication. - -Providing --sasl-ir multiple times has no extra effect. -Disable it again with \-\-no-sasl-ir. - -Example: -.nf - curl --sasl-ir imap://example.com/ -.fi - -See also \fI\-\-sasl\-authzid\fP. -.IP "\-\-service\-name " -Set the service name for SPNEGO. - -If --service-name is provided several times, the last set value is used. - -Example: -.nf - curl --service-name sockd/server https://example.com -.fi - -See also \fI\-\-negotiate\fP and \fI\-\-proxy\-service\-name\fP. -.IP "\-S, \-\-show\-error" -When used with \fI\-s, \-\-silent\fP, it makes curl show an error message if it fails. - -This option is global and does not need to be specified for each use of --next. - -Providing --show-error multiple times has no extra effect. -Disable it again with \-\-no-show-error. - -Example: -.nf - curl --show-error --silent https://example.com -.fi - -See also \fI\-\-no\-progress\-meter\fP. -.IP "\-s, \-\-silent" -Silent or quiet mode. Do not show progress meter or error messages. Makes Curl -mute. It still outputs the data you ask for, potentially even to the -terminal/stdout unless you redirect it. - -Use \fI\-S, \-\-show\-error\fP in addition to this option to disable progress meter but -still show error messages. - -Providing --silent multiple times has no extra effect. -Disable it again with \-\-no-silent. - -Example: -.nf - curl -s https://example.com -.fi - -See also \fI-v, \-\-verbose\fP, \fI\-\-stderr\fP and \fI\-\-no\-progress\-meter\fP. -.IP "\-\-socks4 " -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 hostname -and passing the address on to the proxy. - -To specify proxy on a unix domain socket, use localhost for host, e.g. -\&"socks4://localhost/path/to/socket.sock" - -This option overrides any previous use of \fI\-x, \-\-proxy\fP, as they are mutually -exclusive. - -This option is superfluous since you can specify a socks4 proxy with \fI\-x, \-\-proxy\fP -using a socks4:// protocol prefix. - -\fI\-\-preproxy\fP can be used to specify a SOCKS proxy at the same time proxy is used -with an HTTP/HTTPS proxy (added in 7.52.0). In such a case, curl first -connects to the SOCKS proxy and then connects (through SOCKS) to the HTTP or -HTTPS proxy. - -If --socks4 is provided several times, the last set value is used. - -Example: -.nf - curl --socks4 hostname:4096 https://example.com -.fi - -See also \fI\-\-socks4a\fP, \fI\-\-socks5\fP and \fI\-\-socks5\-hostname\fP. -.IP "\-\-socks4a " -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 hostname. - -To specify proxy on a unix domain socket, use localhost for host, e.g. -\&"socks4a://localhost/path/to/socket.sock" - -This option overrides any previous use of \fI\-x, \-\-proxy\fP, as they are mutually -exclusive. - -This option is superfluous since you can specify a socks4a proxy with \fI\-x, \-\-proxy\fP -using a socks4a:// protocol prefix. - -\fI\-\-preproxy\fP can be used to specify a SOCKS proxy at the same time \fI\-x, \-\-proxy\fP is -used with an HTTP/HTTPS proxy (added in 7.52.0). In such a case, curl first -connects to the SOCKS proxy and then connects (through SOCKS) to the HTTP or -HTTPS proxy. - -If --socks4a is provided several times, the last set value is used. - -Example: -.nf - curl --socks4a hostname:4096 https://example.com -.fi - -See also \fI\-\-socks4\fP, \fI\-\-socks5\fP and \fI\-\-socks5\-hostname\fP. -.IP "\-\-socks5 " -Use the specified SOCKS5 proxy \- but resolve the hostname locally. If the -port number is not specified, it is assumed at port 1080. - -To specify proxy on a unix domain socket, use localhost for host, e.g. -\&"socks5://localhost/path/to/socket.sock" - -This option overrides any previous use of \fI\-x, \-\-proxy\fP, as they are mutually -exclusive. - -This option is superfluous since you can specify a socks5 proxy with \fI\-x, \-\-proxy\fP -using a socks5:// protocol prefix. - -\fI\-\-preproxy\fP can be used to specify a SOCKS proxy at the same time \fI\-x, \-\-proxy\fP is -used with an HTTP/HTTPS proxy (added in 7.52.0). In such a case, curl first -connects to the SOCKS proxy and then connects (through SOCKS) to the HTTP or -HTTPS proxy. - -This option (as well as \fI\-\-socks4\fP) does not work with IPV6, FTPS or LDAP. - -If --socks5 is provided several times, the last set value is used. - -Example: -.nf - curl --socks5 proxy.example:7000 https://example.com -.fi - -See also \fI\-\-socks5\-hostname\fP and \fI\-\-socks4a\fP. -.IP "\-\-socks5\-basic" -Use username/password authentication when connecting to a SOCKS5 proxy. The -username/password authentication is enabled by default. Use \fI\-\-socks5\-gssapi\fP to -force GSS\-API authentication to SOCKS5 proxies. - -Providing --socks5-basic multiple times has no extra effect. - -Example: -.nf - curl --socks5-basic --socks5 hostname:4096 https://example.com -.fi - -See also \fI\-\-socks5\fP. Added in 7.55.0. -.IP "\-\-socks5\-gssapi" -Use GSS\-API authentication when connecting to a SOCKS5 proxy. The GSS\-API -authentication is enabled by default (if curl is compiled with GSS\-API -support). Use \fI\-\-socks5\-basic\fP to force username/password authentication to -SOCKS5 proxies. - -Providing --socks5-gssapi multiple times has no extra effect. -Disable it again with \-\-no-socks5-gssapi. - -Example: -.nf - curl --socks5-gssapi --socks5 hostname:4096 https://example.com -.fi - -See also \fI\-\-socks5\fP. Added in 7.55.0. -.IP "\-\-socks5\-gssapi\-nec" -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 -implementation does not. The option \fI\-\-socks5\-gssapi\-nec\fP allows the -unprotected exchange of the protection mode negotiation. - -Providing --socks5-gssapi-nec multiple times has no extra effect. -Disable it again with \-\-no-socks5-gssapi-nec. - -Example: -.nf - curl --socks5-gssapi-nec --socks5 hostname:4096 https://example.com -.fi - -See also \fI\-\-socks5\fP. -.IP "\-\-socks5\-gssapi\-service " -Set the service name for a socks server. Default is \fBrcmd/server\-fqdn\fP. - -If --socks5-gssapi-service is provided several times, the last set value is used. - -Example: -.nf - curl --socks5-gssapi-service sockd --socks5 hostname:4096 https://example.com -.fi - -See also \fI\-\-socks5\fP. -.IP "\-\-socks5\-hostname " -Use the specified SOCKS5 proxy (and let the proxy resolve the hostname). If -the port number is not specified, it is assumed at port 1080. - -To specify proxy on a unix domain socket, use localhost for host, e.g. -\&"socks5h://localhost/path/to/socket.sock" - -This option overrides any previous use of \fI\-x, \-\-proxy\fP, as they are mutually -exclusive. - -This option is superfluous since you can specify a socks5 hostname proxy with -\fI\-x, \-\-proxy\fP using a socks5h:// protocol prefix. - -\fI\-\-preproxy\fP can be used to specify a SOCKS proxy at the same time \fI\-x, \-\-proxy\fP is -used with an HTTP/HTTPS proxy (added in 7.52.0). In such a case, curl first -connects to the SOCKS proxy and then connects (through SOCKS) to the HTTP or -HTTPS proxy. - -If --socks5-hostname is provided several times, the last set value is used. - -Example: -.nf - curl --socks5-hostname proxy.example:7000 https://example.com -.fi - -See also \fI\-\-socks5\fP and \fI\-\-socks4a\fP. -.IP "\-Y, \-\-speed\-limit " -If a transfer is slower than this set speed (in bytes per second) for a given -number of seconds, it gets aborted. The time period is set with \fI\-y, \-\-speed\-time\fP -and is 30 seconds by default. - -If --speed-limit is provided several times, the last set value is used. - -Example: -.nf - curl --speed-limit 300 --speed-time 10 https://example.com -.fi - -See also \fI-y, \-\-speed\-time\fP, \fI\-\-limit\-rate\fP and \fI-m, \-\-max\-time\fP. -.IP "\-y, \-\-speed\-time " -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 -speed\-limit is 1 unless set with \fI\-Y, \-\-speed\-limit\fP. - -This option controls transfers (in both directions) but does not affect slow -connects etc. If this is a concern for you, try the \fI\-\-connect\-timeout\fP option. - -If --speed-time is provided several times, the last set value is used. - -Example: -.nf - curl --speed-limit 300 --speed-time 10 https://example.com -.fi - -See also \fI-Y, \-\-speed\-limit\fP and \fI\-\-limit\-rate\fP. -.IP "\-\-ssl" -(FTP IMAP POP3 SMTP LDAP) Warning: this is considered an insecure option. Consider using \fI\-\-ssl\-reqd\fP -instead to be sure curl upgrades to a secure connection. - -Try to use SSL/TLS for the connection \- often referred to as STARTTLS or STLS -because of the involved commands. Reverts to a non\-secure connection if the -server does not support SSL/TLS. See also \fI\-\-ftp\-ssl\-control\fP and \fI\-\-ssl\-reqd\fP for -different levels of encryption required. - -This option is handled in LDAP (added in 7.81.0). It is fully supported by the -OpenLDAP backend and ignored by the generic ldap backend. - -Please note that a server may close the connection if the negotiation does -not succeed. - -This option was formerly known as \fI\-\-ftp\-ssl\fP. That option -name can still be used but might be removed in a future version. - -Providing --ssl multiple times has no extra effect. -Disable it again with \-\-no-ssl. - -Example: -.nf - curl --ssl pop3://example.com/ -.fi - -See also \fI\-\-ssl\-reqd\fP, \fI-k, \-\-insecure\fP and \fI\-\-ciphers\fP. -.IP "\-\-ssl\-allow\-beast" -(TLS) Do 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 may use workarounds known to -cause interoperability problems with some older SSL implementations. - -\fBWARNING\fP: this option loosens the SSL security, and by using this flag you -ask for exactly that. - -Providing --ssl-allow-beast multiple times has no extra effect. -Disable it again with \-\-no-ssl-allow-beast. - -Example: -.nf - curl --ssl-allow-beast https://example.com -.fi - -See also \fI\-\-proxy\-ssl\-allow\-beast\fP and \fI-k, \-\-insecure\fP. -.IP "\-\-ssl\-auto\-client\-cert" -(TLS) (Schannel) Automatically locate and use a client certificate for -authentication, when requested by the server. Since the server can request any -certificate that supports client authentication in the OS certificate store it -could be a privacy violation and unexpected. - -Providing --ssl-auto-client-cert multiple times has no extra effect. -Disable it again with \-\-no-ssl-auto-client-cert. - -Example: -.nf - curl --ssl-auto-client-cert https://example.com -.fi - -See also \fI\-\-proxy\-ssl\-auto\-client\-cert\fP. Added in 7.77.0. -.IP "\-\-ssl\-no\-revoke" -(TLS) (Schannel) Disable certificate revocation checks. WARNING: this option loosens -the SSL security, and by using this flag you ask for exactly that. - -Providing --ssl-no-revoke multiple times has no extra effect. -Disable it again with \-\-no-ssl-no-revoke. - -Example: -.nf - curl --ssl-no-revoke https://example.com -.fi - -See also \fI\-\-crlfile\fP. -.IP "\-\-ssl\-reqd" -(FTP IMAP POP3 SMTP LDAP) Require SSL/TLS for the connection \- often referred to as STARTTLS or STLS -because of the involved commands. Terminates the connection if the transfer -cannot be upgraded to use SSL/TLS. - -This option is handled in LDAP (added in 7.81.0). It is fully supported by the -OpenLDAP backend and rejected by the generic ldap backend if explicit TLS is -required. - -This option is unnecessary if you use a URL scheme that in itself implies -immediate and implicit use of TLS, like for FTPS, IMAPS, POP3S, SMTPS and -LDAPS. Such a transfer always fails if the TLS handshake does not work. - -This option was formerly known as \fI\-\-ftp\-ssl\-reqd\fP. - -Providing --ssl-reqd multiple times has no extra effect. -Disable it again with \-\-no-ssl-reqd. - -Example: -.nf - curl --ssl-reqd ftp://example.com -.fi - -See also \fI\-\-ssl\fP and \fI-k, \-\-insecure\fP. -.IP "\-\-ssl\-revoke\-best\-effort" -(TLS) (Schannel) Ignore certificate revocation checks when they failed due to -missing/offline distribution points for the revocation check lists. - -Providing --ssl-revoke-best-effort multiple times has no extra effect. -Disable it again with \-\-no-ssl-revoke-best-effort. - -Example: -.nf - curl --ssl-revoke-best-effort https://example.com -.fi - -See also \fI\-\-crlfile\fP and \fI-k, \-\-insecure\fP. Added in 7.70.0. -.IP "\-2, \-\-sslv2" -(SSL) This option previously asked curl to use SSLv2, but is now ignored -(added in 7.77.0). SSLv2 is widely considered insecure (see RFC 6176). - -Providing --sslv2 multiple times has no extra effect. - -Example: -.nf - curl --sslv2 https://example.com -.fi - -See also \fI\-\-http1.1\fP and \fI\-\-http2\fP. \fI-2, \-\-sslv2\fP requires that the underlying libcurl was built to support TLS. This option is mutually exclusive to \fI-3, \-\-sslv3\fP and \fI-1, \-\-tlsv1\fP and \fI\-\-tlsv1.1\fP and \fI\-\-tlsv1.2\fP. -.IP "\-3, \-\-sslv3" -(SSL) This option previously asked curl to use SSLv3, but is now ignored -(added in 7.77.0). SSLv3 is widely considered insecure (see RFC 7568). - -Providing --sslv3 multiple times has no extra effect. - -Example: -.nf - curl --sslv3 https://example.com -.fi - -See also \fI\-\-http1.1\fP and \fI\-\-http2\fP. \fI-3, \-\-sslv3\fP requires that the underlying libcurl was built to support TLS. This option is mutually exclusive to \fI-2, \-\-sslv2\fP and \fI-1, \-\-tlsv1\fP and \fI\-\-tlsv1.1\fP and \fI\-\-tlsv1.2\fP. -.IP "\-\-stderr " -Redirect all writes to stderr to the specified file instead. If the filename -is a plain \(aq\-\(aq, it is instead written to stdout. - -This option is global and does not need to be specified for each use of --next. - -If --stderr is provided several times, the last set value is used. - -Example: -.nf - curl --stderr output.txt https://example.com -.fi - -See also \fI-v, \-\-verbose\fP and \fI-s, \-\-silent\fP. -.IP "\-\-styled\-output" -Enable automatic use of bold font styles when writing HTTP headers to the -terminal. Use \fI\-\-no\-styled\-output\fP to switch them off. - -Styled output requires a terminal that supports bold fonts. This feature is -not present on curl for Windows due to lack of this capability. - -This option is global and does not need to be specified for each use of --next. - -Providing --styled-output multiple times has no extra effect. -Disable it again with \-\-no-styled-output. - -Example: -.nf - curl --styled-output -I https://example.com -.fi - -See also \fI-I, \-\-head\fP and \fI-v, \-\-verbose\fP. Added in 7.61.0. -.IP "\-\-suppress\-connect\-headers" -When \fI\-p, \-\-proxytunnel\fP is used and a CONNECT request is made do not output proxy -CONNECT response headers. This option is meant to be used with \fI\-D, \-\-dump\-header\fP or -\fI\-i, \-\-include\fP which are used to show protocol headers in the output. It has no -effect on debug options such as \fI\-v, \-\-verbose\fP or \fI\-\-trace\fP, or any statistics. - -Providing --suppress-connect-headers multiple times has no extra effect. -Disable it again with \-\-no-suppress-connect-headers. - -Example: -.nf - curl --suppress-connect-headers --include -x proxy https://example.com -.fi - -See also \fI-D, \-\-dump\-header\fP, \fI-i, \-\-include\fP and \fI-p, \-\-proxytunnel\fP. Added in 7.54.0. -.IP "\-\-tcp\-fastopen" -Enable use of TCP Fast Open (RFC 7413). TCP Fast Open is a TCP extension that -allows data to get sent earlier over the connection (before the final -handshake ACK) if the client and server have been connected previously. - -Providing --tcp-fastopen multiple times has no extra effect. -Disable it again with \-\-no-tcp-fastopen. - -Example: -.nf - curl --tcp-fastopen https://example.com -.fi - -See also \fI\-\-false\-start\fP. -.IP "\-\-tcp\-nodelay" -Turn on the TCP_NODELAY option. See the \fIcurl_easy_setopt(3)\fP man page for -details about this option. - -curl sets this option by default and you need to explicitly switch it off if -you do not want it on (added in 7.50.2). - -Providing --tcp-nodelay multiple times has no extra effect. -Disable it again with \-\-no-tcp-nodelay. - -Example: -.nf - curl --tcp-nodelay https://example.com -.fi - -See also \fI-N, \-\-no\-buffer\fP. -.IP "\-t, \-\-telnet\-option " -Pass options to the telnet protocol. Supported options are: -.RS -.IP `TTYPE=` -Sets the terminal type. -.IP "`XDISPLOC=`" -Sets the X display location. -.IP `NEW_ENV=` -Sets an environment variable. -.RE -.IP - ---telnet-option can be used several times in a command line - -Example: -.nf - curl -t TTYPE=vt100 telnet://example.com/ -.fi - -See also \fI-K, \-\-config\fP. -.IP "\-\-tftp\-blksize " -(TFTP) Set the TFTP \fBBLKSIZE\fP option (must be 512 or larger). This is the block -size that curl tries to use when transferring data to or from a TFTP -server. By default 512 bytes are used. - -If --tftp-blksize is provided several times, the last set value is used. - -Example: -.nf - curl --tftp-blksize 1024 tftp://example.com/file -.fi - -See also \fI\-\-tftp\-no\-options\fP. -.IP "\-\-tftp\-no\-options" -(TFTP) Do not to send TFTP options requests. This improves interop with some legacy -servers that do not acknowledge or properly implement TFTP options. When this -option is used \fI\-\-tftp\-blksize\fP is ignored. - -Providing --tftp-no-options multiple times has no extra effect. -Disable it again with \-\-no-tftp-no-options. - -Example: -.nf - curl --tftp-no-options tftp://192.168.0.1/ -.fi - -See also \fI\-\-tftp\-blksize\fP. -.IP "\-z, \-\-time\-cond