3. as an [issue](https://github.com/curl/curl/issues)
-/ The curl team!
+/ The curl team
# config file help: https://github.com/amperser/proselint/
- name: create proselint config
run: |
- cat <<JSON > $HOME/.proselintrc
+ cat <<JSON > $HOME/.proselintrc.json
{
"checks": {
"typography.diacritical_marks": false,
run: git ls-files -z '*.md' | xargs -0 -n1 .github/scripts/trimmarkdownheader.pl
- name: check prose
- run: git ls-files -z '*.md' | grep -Evz 'CHECKSRC.md|DISTROS.md|CURLOPT_INTERFACE.md|interface.md' | xargs -0 proselint README
+ run: git ls-files -z '*.md' | grep -Evz 'CHECKSRC.md|DISTROS.md|curl_mprintf.md|CURLOPT_INTERFACE.md|interface.md' | xargs -0 proselint README
# This is for CHECKSRC and files with aggressive exclamation mark needs
- name: create second proselint config
run: |
- cat <<JSON > $HOME/.proselintrc
+ cat <<JSON > $HOME/.proselintrc.json
{
"checks": {
"typography.diacritical_marks": false,
"typography.symbols": false,
"typography.exclamation": false,
+ "lexical_illusions.misc": false,
"annotations.misc": false
}
}
JSON
- name: check special prose
- run: proselint docs/CHECKSRC.md docs/libcurl/opts/CURLOPT_INTERFACE.md docs/cmdline-opts/interface.md
+ run: proselint docs/internals/CHECKSRC.md docs/libcurl/curl_mprintf.md docs/libcurl/opts/CURLOPT_INTERFACE.md docs/cmdline-opts/interface.md
# Docs: https://github.com/marketplace/actions/markdown-link-check
linkcheck:
## Backers
-Thank you to all our backers! 🙏 [Become a backer](https://opencollective.com/curl#section-contribute).
+Thank you to all our backers 🙏 [Become a backer](https://opencollective.com/curl#section-contribute).
## Sponsors
In addition to above list the following cipher suites can be used:
`TLS_SM4_GCM_SM3` `TLS_SM4_CCM_SM3` `TLS_SHA256_SHA256` `TLS_SHA384_SHA384`.
Usage of these cipher suites is not recommended. (The last two cipher suites
-are NULL ciphers!)
+are NULL ciphers, offering no encryption whatsoever.)
### Schannel notes
autoreconf -fi
LDFLAGS="-Wl,-rpath,$HOME/code/boringssl/inst/lib" ./configure --with-ssl=$HOME/code/boringssl/inst --enable-ech --enable-httpsrr
...lots of output...
- WARNING: ECH HTTPSRR enabled but marked EXPERIMENTAL. Use with caution!
+ WARNING: ECH HTTPSRR enabled but marked EXPERIMENTAL. Use with caution.
make
```
% cd ..
% git clone https://github.com/curl/curl
% cd curl
- % cmake . -B build -DCURL_USE_OPENSSL=ON -DUSE_OPENSSL_QUIC=ON
- % cmake --build build
- % cmake --install build
+ % cmake . -B bld -DCURL_USE_OPENSSL=ON -DUSE_OPENSSL_QUIC=ON
+ % cmake --build bld
+ % cmake --install bld
If `make install` results in `Permission denied` error, you need to prepend
it with `sudo`.
% git clone https://github.com/nghttp2/nghttp2.git
% cd nghttp2
% autoreconf -fi
- % PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/home/daniel/build-quictls/lib/pkgconfig:/home/daniel/build-nghttp3/lib/pkgconfig:/home/daniel/build-ngtcp2/lib/pkgconfig LDFLAGS=-L/home/daniel/build-quictls/lib CFLAGS=-I/home/daniel/build-quictls/include ./configure --enable-maintainer-mode --prefix=/home/daniel/build-nghttp2 --disable-shared --enable-app --enable-http3 --without-jemalloc --without-libxml2 --without-systemd
+ % PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/home/daniel/build-quictls/lib/pkgconfig:/home/daniel/build-nghttp3/lib/pkgconfig:/home/daniel/build-ngtcp2/lib/pkgconfig LDFLAGS=-L/home/daniel/build-quictls/lib CFLAGS=-I/home/daniel/build-quictls/include ./configure --enable-maintainer-mode --prefix=/home/daniel/build-nghttp2 --disable-shared --enable-app --enable-http3 --without-jemalloc --without-libxml2 --without-systemd
% make && make install
Run the local h3 server on port 9443, make it proxy all traffic through to
This is a probably incomplete list of known CPU architectures and operating
systems that curl has been compiled for. If you know a system curl compiles
-and runs on, that is not listed, please let us know!
+and runs on, that is not listed, please let us know.
## 101 Operating Systems
lists. A digest is a collection of mails lumped together in one single mail.
Should you decide to reply to a mail sent out as a digest, there are two
-things you MUST consider if you really really cannot subscribe normally
+things you MUST consider if you really, really cannot subscribe normally
instead:
Cut off all mails and chatter that is not related to the mail you want to
`--trace` or `--trace-ascii` options with a given filename to log to, like
this:
- curl --trace trace.txt www.haxx.se
+ curl --trace my-trace.txt www.haxx.se
## Detailed Information
## Past Sponsors
Sponsors that stop paying are considered *Past Sponsors* and are not displayed
-on the sponsor page anymore. We thank you for your contributions!
+on the sponsor page anymore. We thank you for your contributions.
when connecting to make the connection succeed.
An additional complication can be that modern SSL libraries sometimes are
- built with support for older SSL and TLS versions disabled!
+ built with support for older SSL and TLS versions disabled.
All versions of SSL and the TLS versions before 1.2 are considered insecure
and should be avoided. Use TLS 1.2 or later.
Curl supports encrypted fetches when built to use a TLS library and it can be
built to use one out of a fairly large set of libraries - `curl -V` shows
- which one your curl was built to use (if any!). To get a page from an HTTPS
+ which one your curl was built to use (if any). To get a page from an HTTPS
server, simply run curl like:
curl https://secure.example.com
Due to the inherent differences between URL parser implementations, it is
considered a security risk to mix different implementations and assume the
-same behavior!
+same behavior.
For example, if you use one parser to check if a URL uses a good hostname or
the correct auth field, and then pass on that same URL to a *second* parser,
## 48
Unknown option specified to libcurl. This indicates that you passed a weird
option to curl that was passed on to libcurl and rejected. Read up in the
-manual!
+manual.
## 49
Malformed telnet option.
## 52
<!-- Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. -->
<!-- SPDX-License-Identifier: curl -->
# 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.
## 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!
+the other cases below.
## =content
URL-encode the content and pass that on. The preceding `=` symbol is not
# `--head`
-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,
+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 URL,
curl displays the file size and last modification time only.
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!
+what your command-line operation does.
##
(*) = 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
+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 'start' and 'stop' fields of the
options.
**WARNING**: On Windows, particular `file://` accesses can be converted to
-network accesses by the operating system. Beware!
+network accesses by the operating system. Beware.
## `Debug`
This curl uses a libcurl built with Debug. This enables more error-tracking
-and memory debugging etc. For curl-developers only!
+and memory debugging etc. For curl-developers only.
## `ECH`
ECH support is present.
Most examples should build fine using a command line like this:
- `curl-config --cc --cflags --libs` -o example example.c
+ `curl-config --cc --cflags --libs` -o example-my example.c
Some compilers do not like having the arguments in this order but instead
want you do reorganize them like:
- `curl-config --cc` -o example example.c `curl-config --cflags --libs`
+ `curl-config --cc` -o example-my example.c `curl-config --cflags --libs`
**Please** do not use the `curl.se` site as a test target for your libcurl
applications/experiments. Even if some of the examples use that site as a URL
Hyper is a separate HTTP library written in Rust. curl can be told to use this
library as a backend to deal with HTTP.
-## Experimental!
+## EXPERIMENTAL
Hyper support in curl is considered **EXPERIMENTAL** until further notice. It
needs to be explicitly enabled at build-time.
Maybe it even needs some internal documentation so that the developers who try
to debug something five years from now can figure out functionality a little
-easier!
+easier.
The protocol specification itself should be freely available without requiring
a non-disclosure agreement or similar.
## CURLINFO_TLS_SESSION
(**Deprecated**) TLS session info that can be used for further processing. See
-CURLINFO_TLS_SESSION(3). Use CURLINFO_TLS_SSL_PTR(3) instead!
+CURLINFO_TLS_SESSION(3). Use CURLINFO_TLS_SSL_PTR(3) instead.
## CURLINFO_TLS_SSL_PTR
options are set with an *option* followed by a *parameter*. That parameter can
be a **long**, a **function pointer**, an **object pointer** or a
**curl_off_t**, depending on what the specific option expects. Read this
-manual carefully as bad input values may cause libcurl to behave badly! You
+manual carefully as bad input values may cause libcurl to behave badly. You
can only set one option in each function call. A typical application uses many
curl_easy_setopt(3) calls in the setup phase.
int decodelen;
char *decoded = curl_easy_unescape(curl, "%63%75%72%6c", 12, &decodelen);
if(decoded) {
- /* do not assume printf() works on the decoded data! */
+ /* do not assume printf() works on the decoded data */
printf("Decoded: ");
/* ... */
curl_free(decoded);
# DESCRIPTION
-Obsolete function. Use curl_easy_escape(3) instead!
+Obsolete function. Use curl_easy_escape(3) instead.
This function converts the given input **string** to a URL encoded string
and return that as a new allocated string. All input characters that are not
## CURLFORM_CONTENTSLENGTH
-(This option is deprecated. Use *CURLFORM_CONTENTLEN* instead!)
+(This option is deprecated. Use *CURLFORM_CONTENTLEN* instead.)
followed by a long giving the length of the contents. Note that for
*CURLFORM_STREAM* contents, this option is mandatory.
# DESCRIPTION
-This function is deprecated. Do not use. See curl_mime_init(3) instead!
+This function is deprecated. Do not use. See curl_mime_init(3) instead.
curl_formfree() is used to clean up data previously built/appended with
curl_formadd(3). This must be called when the data has been used, which
If the **CURLFORM_STREAM** option is used in the formpost, it prevents
curl_formget(3) from working until you have performed the actual HTTP request.
-This, because first then does libcurl known which actual read callback to use!
+This, because first then does libcurl known which actual read callback to use.
# %PROTOCOLS%
{
char *width = curl_getenv("COLUMNS");
if(width) {
- /* it was set! */
+ /* it was set */
curl_free(width);
}
}
{
char *width = curl_getenv("COLUMNS");
if(width) {
- /* it was set! */
+ /* it was set */
curl_free(width);
}
}
# CAUTION
Manipulating these gives considerable powers to the application to severely
-screw things up for libcurl. Take care!
+screw things up for libcurl. Take care.
# %PROTOCOLS%
(ell-ell). A following integer conversion corresponds to a *long long* or
*unsigned long long* argument, or a following n conversion corresponds to
-a pointer to a long long argument.
+a pointer to a *long long* argument.
## q
break;
}
- /* if there are still transfers, loop! */
+ /* if there are still transfers, loop */
} while(still_running);
}
}
# DEPRECATED
-curl_multi_socket(3) is deprecated, use curl_multi_socket_action(3) instead!
+curl_multi_socket(3) is deprecated, use curl_multi_socket_action(3) instead.
# %AVAILABILITY%
# DESCRIPTION
-Frees all the resources associated with the given *CURLU* handle!
+Frees all the resources associated with the given *CURLU* handle.
Passing in a NULL pointer in *handle* makes this function return
immediately with no action.
CURLU *url2;
rc = curl_url_set(url, CURLUPART_URL, "https://example.com", 0);
if(!rc) {
- url2 = curl_url_dup(url); /* clone it! */
+ url2 = curl_url_dup(url); /* clone it */
curl_url_cleanup(url2);
}
curl_url_cleanup(url);
Returns a human readable string with the version number of libcurl and some of
its important components (like OpenSSL version).
-We recommend using curl_version_info(3) instead!
+We recommend using curl_version_info(3) instead.
# %PROTOCOLS%
## CURLE_NOT_BUILT_IN (4)
-A requested feature, protocol or option was not found built-in in this libcurl
+A requested feature, protocol or option was not found built into this libcurl
due to a build-time decision. This means that a feature or option was not
enabled or explicitly disabled when libcurl was built and in order to get it
to function you have to get a rebuilt libcurl.
## CURLM_INTERNAL_ERROR (4)
-This can only be returned if libcurl bugs. Please report it to us!
+This can only be returned if libcurl bugs. Please report it to us.
## CURLM_BAD_SOCKET (5)
libcurl itself uses *fork()* and *execl()* if told to use the
**CURLAUTH_NTLM_WB** authentication method which then invokes the helper
command in a child process with file descriptors duplicated. Make sure that
-only the trusted and reliable helper program is invoked!
+only the trusted and reliable helper program is invoked.
This feature was removed from curl in 8.8.0.
You can have multiple easy handles share data between them. Have them update
and use the **same** cookie database, DNS cache, TLS session cache and/or
-connection cache! This way, each single transfer takes advantage from data
+connection cache. This way, each single transfer takes advantage from data
updates made by the other transfer(s).
# SHARE OBJECT
*CURLU_URLDECODE* flag set in the fourth bitmask argument.
Remember to free the returned string with curl_free(3) when you are done
-with it!
+with it.
# SET PARTS
other prefixes indicate that the functions are private and may change without
further notice in the next release.
-Only use documented functions and functionality!
+Only use documented functions and functionality.
# PORTABILITY
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
- long sockfd; /* does not work on win64! */
+ long sockfd; /* does not work on win64 */
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Do not do the transfer - only connect to host */
This option is deprecated. We strongly recommend using
CURLINFO_SCHEME(3) instead, because this option cannot return all
-possible protocols!
+possible protocols.
Pass a pointer to a long to receive the version used in the last http
connection. The returned value is set to one of the CURLPROTO_* values:
Pass a pointer to a long to receive the next CSeq that is expected to be used
by the application.
-Listening for server initiated requests is not implemented!
+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.
struct curl_fileinfo {
char *filename;
curlfiletype filetype;
- time_t time; /* always zero! */
+ time_t time; /* always zero */
unsigned int perm;
int uid;
int gid;
curl_easy_setopt(curl, CURLOPT_CONNECT_ONLY, 1L);
ret = curl_easy_perform(curl);
if(ret == CURLE_OK) {
- /* only connected! */
+ /* only connected */
}
}
}
res = curl_easy_perform(curl);
- /* close the handle, write the cookies! */
+ /* close the handle, write the cookies */
curl_easy_cleanup(curl);
}
}
# DESCRIPTION
-Has no function since 7.62.0. Do not use!
+Has no function since 7.62.0. Do not use.
Pass a long. If the *enable* value is 1, it tells curl to use a global DNS
cache that survives between easy handle creations and deletions. This is not
not 1.
When the *verify* value is set to 0L, the connection succeeds regardless of
-the names used in the certificate. Use that ability with caution!
+the names used in the certificate. Use that ability with caution.
See also CURLOPT_DOH_SSL_VERIFYPEER(3) to verify the digital signature
of the DoH server certificate.
especially useful if you are doing many simultaneous connections against the
same server and they all have this option enabled, as then CWD may first fail
but then another connection does **MKD** before this connection and thus
-**MKD** fails but trying CWD works!
+**MKD** fails but trying CWD works.
# DEFAULT
curl_easy_setopt(curl, CURLOPT_URL,
"ftp://example.com/old-server/file.txt");
- /* a drftpd server, do it! */
+ /* a drftpd server, do it */
curl_easy_setopt(curl, CURLOPT_FTP_USE_PRET, 1L);
res = curl_easy_perform(curl);
data separately.
While named confusingly similar, CURLOPT_HTTPHEADER(3) is used to set
-custom HTTP headers!
+custom HTTP headers.
# DEFAULT
complete header lines are passed on to the callback. Parsing headers is easy
to do using this callback. *buffer* points to the delivered data, and the size
of that data is *nitems*; *size* is always 1. The provided header line is not
-null-terminated! Do not modify the passed in buffer.
+null-terminated. Do not modify the passed in buffer.
The pointer named *userdata* is the one you set with the CURLOPT_HEADERDATA(3)
option.
/* HTTPS over a proxy makes a separate CONNECT to the proxy, so tell
libcurl to not send the custom headers to the proxy. Keep them
- separate! */
+ separate. */
curl_easy_setopt(curl, CURLOPT_HEADEROPT, CURLHEADER_SEPARATE);
ret = curl_easy_perform(curl);
curl_slist_free_all(list);
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!
+that curl might consider to be HTTP/0.9.
# DEFAULT
Pass a pointer to a linked list of HTTP headers to pass to the server and/or
proxy in your HTTP request. The same list can be used for both host and proxy
-requests!
+requests.
When used within an IMAP or SMTP request to upload a MIME mail, the given
header list establishes the document-level MIME headers to prepend to the
CURLOPT_IOCTLDATA(3) option.
**This option is deprecated**. Do not use it. Use CURLOPT_SEEKFUNCTION(3)
-instead to provide seeking! If CURLOPT_SEEKFUNCTION(3) is set, this
+instead to provide seeking. If CURLOPT_SEEKFUNCTION(3) is set, this
parameter is ignored when seeking.
# DEFAULT
curl_easy_setopt(curl, CURLOPT_LOW_SPEED_LIMIT, 30L);
res = curl_easy_perform(curl);
if(CURLE_OPERATION_TIMEDOUT == res) {
- printf("Timeout!\n");
+ printf("Timeout.\n");
}
/* always cleanup */
curl_easy_cleanup(curl);
curl_easy_setopt(curl, CURLOPT_LOW_SPEED_LIMIT, 30L);
res = curl_easy_perform(curl);
if(CURLE_OPERATION_TIMEDOUT == res) {
- printf("Timeout!\n");
+ printf("Timeout.\n");
}
/* always cleanup */
curl_easy_cleanup(curl);
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
- /* refuse to download if larger than 1000 bytes! */
+ /* refuse to download if larger than 1000 bytes */
curl_easy_setopt(curl, CURLOPT_MAXFILESIZE, 1000L);
ret = curl_easy_perform(curl);
}
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* cap the upload speed to 1000 bytes/sec */
curl_easy_setopt(curl, CURLOPT_MAX_SEND_SPEED_LARGE, (curl_off_t)1000);
- /* (set some upload options as well!) */
+ /* (set some upload options as well) */
ret = curl_easy_perform(curl);
}
}
/* Set the form info */
curl_easy_setopt(curl, CURLOPT_MIMEPOST, multipart);
- curl_easy_perform(curl); /* post away! */
+ curl_easy_perform(curl); /* post away */
curl_mime_free(multipart); /* free the post data */
}
}
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
- /* get us the resource without a body - use HEAD! */
+ /* get us the resource without a body - use HEAD */
curl_easy_setopt(curl, CURLOPT_NOBODY, 1L);
/* Perform the request */
# NAME
-CURLOPT_PATH_AS_IS - do not handle dot dot sequences
+CURLOPT_PATH_AS_IS - do not handle dot-dot sequences
# SYNOPSIS
exist in the URL's path part and that is supposed to be removed according to
RFC 3986 section 5.2.4.
-Some server implementations are known to (erroneously) require the dot dot
+Some server implementations are known to (erroneously) require the dot-dot
sequences to remain in the path and some clients want to pass these on in
order to try out server implementations.
This option is deprecated. We strongly recommend using
CURLOPT_PROTOCOLS_STR(3) instead because this option cannot control all
-available protocols!
+available protocols.
Pass a long that holds a bitmask of CURLPROTO_* defines. If used, this bitmask
limits what protocols libcurl may use in the transfer. This allows you to have
From 7.66.0: treats 1 and 2 the same.
When the *verify* value is 0L, the connection succeeds regardless of the
-names used in the certificate. Use that ability with caution!
+names used in the certificate. Use that ability with caution.
See also CURLOPT_PROXY_SSL_VERIFYPEER(3) to verify the digital signature
of the proxy certificate.
curl_off_t nread;
/* copy as much data as possible into the 'ptr' buffer, but no more than
- 'size' * 'nmemb' bytes! */
+ 'size' * 'nmemb' bytes. */
size_t retcode = fread(ptr, size, nmemb, readhere);
nread = (curl_off_t)retcode;
This option is deprecated. We strongly recommend using
CURLOPT_REDIR_PROTOCOLS_STR(3) instead because this option cannot
-control all available protocols!
+control all available protocols.
Pass a long that holds a bitmask of CURLPROTO_* defines. If used, this bitmask
limits what protocols libcurl may use in a transfer that it follows to in a
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "rtsp://example.com/");
- /* ask for options! */
+ /* ask for options */
curl_easy_setopt(curl, CURLOPT_RTSP_REQUEST, CURL_RTSPREQ_OPTIONS);
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);
If you forward the input arguments directly to fseek(3) or lseek(3), note that
the data type for *offset* is not the same as defined for curl_off_t on
-many systems!
+many systems.
# DEFAULT
enum curl_khmatch {
CURLKHMATCH_OK, /* match */
- CURLKHMATCH_MISMATCH, /* host found, key mismatch! */
+ CURLKHMATCH_MISMATCH, /* host found, key mismatch */
CURLKHMATCH_MISSING, /* no matching host/key found */
};
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
- /* switch off session-id use! */
+ /* switch off session-id use */
curl_easy_setopt(curl, CURLOPT_SSL_SESSIONID_CACHE, 0L);
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
- /* ask for OCSP stapling! */
+ /* ask for OCSP stapling */
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYSTATUS, 1L);
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);
curl_easy_setopt(curl2, CURLOPT_URL, "https://example.com/two");
curl_easy_setopt(curl2, CURLOPT_STREAM_DEPENDS, curl);
- /* then add both to a multi handle and transfer them! */
+ /* then add both to a multi handle and transfer them */
}
}
~~~
curl_easy_setopt(curl2, CURLOPT_URL, "https://example.com/two");
curl_easy_setopt(curl2, CURLOPT_STREAM_DEPENDS_E, curl);
- /* then add both to a multi handle and transfer them! */
+ /* then add both to a multi handle and transfer them */
}
}
~~~
curl_easy_setopt(curl2, CURLOPT_URL, "https://example.com/two");
curl_easy_setopt(curl2, CURLOPT_STREAM_WEIGHT, 20L);
- /* then add both to a multi handle and transfer them! */
+ /* then add both to a multi handle and transfer them */
}
}
~~~
/* Set the size of the file to upload */
curl_easy_setopt(curl, CURLOPT_INFILESIZE_LARGE, (curl_off_t)fsize);
- /* Now run off and do what you have been told! */
+ /* Now run off and do what you have been told */
curl_easy_perform(curl);
}
}
char *ptr = realloc(mem->response, mem->size + realsize + 1);
if(!ptr)
- return 0; /* out of memory! */
+ return 0; /* out of memory */
mem->response = ptr;
memcpy(&(mem->response[mem->size]), data, realsize);
following the last dot in the given hostname (made so that a CONNECT can still
pass on test number) so that "foo.bar.123" gets treated as test case
123. Alternatively, if an IPv6 address is provided to CONNECT, the last
-hexadecimal group in the address is used as the test number! For example the
+hexadecimal group in the address is used as the test number. For example the
address "[1234::ff]" would be treated as test case 255.
Set `type="perl"` to write the test case as a perl script. It implies that
In `conftest.py` 3 "fixtures" are defined that are used by all test cases:
-1. `env`: the test environment. It is an instance of class `testenv/env.py:Env`. It holds all information about paths, availability of features (HTTP/3!), port numbers to use, domains and SSL certificates for those.
+1. `env`: the test environment. It is an instance of class `testenv/env.py:Env`. It holds all information about paths, availability of features (HTTP/3), port numbers to use, domains and SSL certificates for those.
2. `httpd`: the Apache httpd instance, configured and started, then stopped at the end of the test suite. It has sites configured for the domains from `env`. It also loads a local module `mod_curltest?` and makes it available in certain locations. (more on mod_curltest below).
3. `nghttpx`: an instance of nghttpx that provides HTTP/3 support. `nghttpx` proxies those requests to the `httpd` server. In a direct mapping, so you may access all the resources under the same path as with HTTP/2. Only the port number used for HTTP/3 requests will be different.
projects / thirdparty / curl.git / commitdiff
