1
0
mirror of https://github.com/moparisthebest/curl synced 2024-11-15 22:15:13 -05:00

terminology: call them null-terminated strings

Updated terminology in docs, comments and phrases to refer to C strings
as "null-terminated". Done to unify with how most other C oriented docs
refer of them and what users in general seem to prefer (based on a
single highly unscientific poll on twitter).

Reported-by: coinhubs on github
Fixes #5598
Closes #5608
This commit is contained in:
Daniel Stenberg 2020-06-25 11:38:25 +02:00
parent ff43fb6dec
commit 032e838b73
No known key found for this signature in database
GPG Key ID: 5CC908FDB71E12C2
107 changed files with 139 additions and 139 deletions

View File

@ -5,7 +5,7 @@
.\" * | (__| |_| | _ <| |___ .\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____| .\" * \___|\___/|_| \_\_____|
.\" * .\" *
.\" * Copyright (C) 1998 - 2017, Daniel Stenberg, <daniel@haxx.se>, et al. .\" * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al.
.\" * .\" *
.\" * This software is licensed as described in the file COPYING, which .\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms .\" * you should have received as part of this distribution. The terms
@ -51,7 +51,7 @@ to the function is encoded correctly.
.SH AVAILABILITY .SH AVAILABILITY
Added in 7.15.4 and replaces the old \fIcurl_escape(3)\fP function. Added in 7.15.4 and replaces the old \fIcurl_escape(3)\fP function.
.SH RETURN VALUE .SH RETURN VALUE
A pointer to a zero terminated string or NULL if it failed. A pointer to a null-terminated string or NULL if it failed.
.SH EXAMPLE .SH EXAMPLE
.nf .nf
CURL *curl = curl_easy_init(); CURL *curl = curl_easy_init();

View File

@ -35,6 +35,6 @@ specific error descriptions generated at run-time.
.SH AVAILABILITY .SH AVAILABILITY
This function was added in libcurl 7.12.0 This function was added in libcurl 7.12.0
.SH RETURN VALUE .SH RETURN VALUE
A pointer to a zero terminated string. A pointer to a null-terminated string.
.SH "SEE ALSO" .SH "SEE ALSO"
.BR libcurl-errors "(3), " curl_multi_strerror "(3), " curl_share_strerror "(3)" .BR libcurl-errors "(3), " curl_multi_strerror "(3), " curl_share_strerror "(3)"

View File

@ -5,7 +5,7 @@
.\" * | (__| |_| | _ <| |___ .\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____| .\" * \___|\___/|_| \_\_____|
.\" * .\" *
.\" * Copyright (C) 1998 - 2016, Daniel Stenberg, <daniel@haxx.se>, et al. .\" * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al.
.\" * .\" *
.\" * This software is licensed as described in the file COPYING, which .\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms .\" * you should have received as part of this distribution. The terms
@ -49,6 +49,6 @@ You must \fIcurl_free(3)\fP the returned string when you're done with it.
.SH AVAILABILITY .SH AVAILABILITY
Added in 7.15.4 and replaces the old \fIcurl_unescape(3)\fP function. Added in 7.15.4 and replaces the old \fIcurl_unescape(3)\fP function.
.SH RETURN VALUE .SH RETURN VALUE
A pointer to a zero terminated string or NULL if it failed. A pointer to a null-terminated string or NULL if it failed.
.SH "SEE ALSO" .SH "SEE ALSO"
.BR curl_easy_escape "(3), " curl_free "(3)," RFC 3986 .BR curl_easy_escape "(3), " curl_free "(3)," RFC 3986

View File

@ -43,6 +43,6 @@ You must \fIcurl_free(3)\fP the returned string when you're done with it.
Since 7.15.4, \fIcurl_easy_escape(3)\fP should be used. This function will Since 7.15.4, \fIcurl_easy_escape(3)\fP should be used. This function will
be removed in a future release. be removed in a future release.
.SH RETURN VALUE .SH RETURN VALUE
A pointer to a zero terminated string or NULL if it failed. A pointer to a null-terminated string or NULL if it failed.
.SH "SEE ALSO" .SH "SEE ALSO"
.BR curl_unescape "(3), " curl_free "(3), " RFC 2396 .BR curl_unescape "(3), " curl_free "(3), " RFC 2396

View File

@ -38,7 +38,7 @@ This function will be removed from the public libcurl API in a near future. It
will instead be made "available" by source code access only, and then as will instead be made "available" by source code access only, and then as
curlx_getenv(). curlx_getenv().
.SH RETURN VALUE .SH RETURN VALUE
A pointer to a zero terminated string or NULL if it failed to find the A pointer to a null-terminated string or NULL if it failed to find the
specified name. specified name.
.SH NOTE .SH NOTE
Under unix operating systems, there isn't any point in returning an allocated Under unix operating systems, there isn't any point in returning an allocated

View File

@ -5,7 +5,7 @@
.\" * | (__| |_| | _ <| |___ .\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____| .\" * \___|\___/|_| \_\_____|
.\" * .\" *
.\" * Copyright (C) 1998 - 2017, Daniel Stenberg, <daniel@haxx.se>, et al. .\" * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al.
.\" * .\" *
.\" * This software is licensed as described in the file COPYING, which .\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms .\" * you should have received as part of this distribution. The terms
@ -34,7 +34,7 @@ curl_mime_data - set a mime part's body data from memory
\fIdata\fP points to the data bytes: those are copied to the part and their \fIdata\fP points to the data bytes: those are copied to the part and their
storage may safely be reused after call. storage may safely be reused after call.
\fIdatasize\fP is the number of data bytes: it can be set to \fIdatasize\fP is the number of data bytes: it can be set to
\fICURL_ZERO_TERMINATED\fP to indicate \fIdata\fP is a nul-terminated \fICURL_ZERO_TERMINATED\fP to indicate \fIdata\fP is a null-terminated
character string. character string.
\fIpart\fP is the part's to assign contents to. \fIpart\fP is the part's to assign contents to.

View File

@ -5,7 +5,7 @@
.\" * | (__| |_| | _ <| |___ .\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____| .\" * \___|\___/|_| \_\_____|
.\" * .\" *
.\" * Copyright (C) 1998 - 2017, Daniel Stenberg, <daniel@haxx.se>, et al. .\" * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al.
.\" * .\" *
.\" * This software is licensed as described in the file COPYING, which .\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms .\" * you should have received as part of this distribution. The terms
@ -33,7 +33,7 @@ curl_mime_encoder() requests a mime part's content to be encoded before being
transmitted. transmitted.
\fIpart\fP is the part's handle to assign an encoder. \fIpart\fP is the part's handle to assign an encoder.
\fIencoding\fP is a pointer to a zero-terminated encoding scheme. It may be \fIencoding\fP is a pointer to a null-terminated encoding scheme. It may be
set to NULL to disable an encoder previously attached to the part. The encoding set to NULL to disable an encoder previously attached to the part. The encoding
scheme storage may safely be reused after this function returns. scheme storage may safely be reused after this function returns.

View File

@ -5,7 +5,7 @@
.\" * | (__| |_| | _ <| |___ .\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____| .\" * \___|\___/|_| \_\_____|
.\" * .\" *
.\" * Copyright (C) 1998 - 2018, Daniel Stenberg, <daniel@haxx.se>, et al. .\" * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al.
.\" * .\" *
.\" * This software is licensed as described in the file COPYING, which .\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms .\" * you should have received as part of this distribution. The terms
@ -35,9 +35,9 @@ data to a mime part.
\fIpart\fP is the part's to assign contents to. \fIpart\fP is the part's to assign contents to.
\fIfilename\fP points to the nul-terminated file's path name. The pointer can \fIfilename\fP points to the null-terminated file's path name. The pointer can
be NULL to detach the previous part contents settings. Filename storage can be be NULL to detach the previous part contents settings. Filename storage can
safely be reused after this call. be safely be reused after this call.
As a side effect, the part's remote file name is set to the base name of the As a side effect, the part's remote file name is set to the base name of the
given \fIfilename\fP if it is a valid named file. This can be undone or given \fIfilename\fP if it is a valid named file. This can be undone or

View File

@ -5,7 +5,7 @@
.\" * | (__| |_| | _ <| |___ .\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____| .\" * \___|\___/|_| \_\_____|
.\" * .\" *
.\" * Copyright (C) 1998 - 2017, Daniel Stenberg, <daniel@haxx.se>, et al. .\" * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al.
.\" * .\" *
.\" * This software is licensed as described in the file COPYING, which .\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms .\" * you should have received as part of this distribution. The terms
@ -36,8 +36,8 @@ associated Content-Disposition generated header.
\fIpart\fP is the part's handle to assign the remote file name to. \fIpart\fP is the part's handle to assign the remote file name to.
\fIfilename\fP points to the nul-terminated file name string; it may be set to \fIfilename\fP points to the null-terminated file name string; it may be set
NULL to remove a previously attached remote file name. to NULL to remove a previously attached remote file name.
The remote file name string is copied into the part, thus the associated The remote file name string is copied into the part, thus the associated
storage may safely be released or reused after call. Setting a part's file storage may safely be released or reused after call. Setting a part's file

View File

@ -5,7 +5,7 @@
.\" * | (__| |_| | _ <| |___ .\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____| .\" * \___|\___/|_| \_\_____|
.\" * .\" *
.\" * Copyright (C) 1998 - 2017, Daniel Stenberg, <daniel@haxx.se>, et al. .\" * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al.
.\" * .\" *
.\" * This software is licensed as described in the file COPYING, which .\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms .\" * you should have received as part of this distribution. The terms
@ -33,7 +33,7 @@ fields are named.
\fIpart\fP is the part's handle to assign a name to. \fIpart\fP is the part's handle to assign a name to.
\fIname\fP points to the zero-terminated name string. \fIname\fP points to the null-terminated name string.
The name string is copied into the part, thus the associated storage may The name string is copied into the part, thus the associated storage may
safely be released or reused after call. Setting a part's name twice is valid: safely be released or reused after call. Setting a part's name twice is valid:

View File

@ -33,7 +33,7 @@ curl_mime_type - set a mime part's content type
\fIpart\fP is the part's handle to assign the content type to. \fIpart\fP is the part's handle to assign the content type to.
\fImimetype\fP points to the nul-terminated file mime type string; it may be \fImimetype\fP points to the null-terminated file mime type string; it may be
set to NULL to remove a previously attached mime type. set to NULL to remove a previously attached mime type.
The mime type string is copied into the part, thus the associated storage may The mime type string is copied into the part, thus the associated storage may

View File

@ -32,6 +32,6 @@ error code passed in the argument \fIerrornum\fP.
.SH AVAILABILITY .SH AVAILABILITY
This function was added in libcurl 7.12.0 This function was added in libcurl 7.12.0
.SH RETURN VALUE .SH RETURN VALUE
A pointer to a zero terminated string. A pointer to a null-terminated string.
.SH "SEE ALSO" .SH "SEE ALSO"
.BR libcurl-errors "(3), " curl_easy_strerror "(3), " curl_share_strerror "(3)" .BR libcurl-errors "(3), " curl_easy_strerror "(3), " curl_share_strerror "(3)"

View File

@ -32,6 +32,6 @@ error code passed in the argument \fIerrornum\fP.
.SH AVAILABILITY .SH AVAILABILITY
This function was added in libcurl 7.12.0 This function was added in libcurl 7.12.0
.SH RETURN VALUE .SH RETURN VALUE
A pointer to a zero terminated string. A pointer to a null-terminated string.
.SH "SEE ALSO" .SH "SEE ALSO"
.BR libcurl-errors "(3), " curl_multi_strerror "(3), " curl_easy_strerror "(3)" .BR libcurl-errors "(3), " curl_multi_strerror "(3), " curl_easy_strerror "(3)"

View File

@ -43,6 +43,6 @@ You must \fIcurl_free(3)\fP the returned string when you're done with it.
Since 7.15.4, \fIcurl_easy_unescape(3)\fP should be used. This function will Since 7.15.4, \fIcurl_easy_unescape(3)\fP should be used. This function will
be removed in a future release. be removed in a future release.
.SH RETURN VALUE .SH RETURN VALUE
A pointer to a zero terminated string or NULL if it failed. A pointer to a null-terminated string or NULL if it failed.
.SH "SEE ALSO" .SH "SEE ALSO"
.br curl_easy_escape "(3)," curl_easy_unescape "(3)," curl_free "(3)," RFC 2396 .br curl_easy_escape "(3)," curl_easy_unescape "(3)," curl_free "(3)," RFC 2396

View File

@ -35,7 +35,7 @@ Given the \fIurl\fP handle of an already parsed URL, this function lets the
user set/update individual pieces of it. user set/update individual pieces of it.
The \fIpart\fP argument should identify the particular URL part (see list The \fIpart\fP argument should identify the particular URL part (see list
below) to set or change, with \fIcontent\fP pointing to a zero terminated below) to set or change, with \fIcontent\fP pointing to a null-terminated
string with the new contents for that URL part. The contents should be in the string with the new contents for that URL part. The contents should be in the
form and encoding they'd use in a URL: URL encoded. form and encoding they'd use in a URL: URL encoded.
@ -51,7 +51,7 @@ populated with a URL, the new URL can be relative to the previous.
When successfully setting a new URL, relative or absolute, the handle contents When successfully setting a new URL, relative or absolute, the handle contents
will be replaced with the information of the newly set URL. will be replaced with the information of the newly set URL.
Pass a pointer to a zero terminated string to the \fIurl\fP parameter. The Pass a pointer to a null-terminated string to the \fIurl\fP parameter. The
string must point to a correctly formatted "RFC 3986+" URL or be a NULL string must point to a correctly formatted "RFC 3986+" URL or be a NULL
pointer. pointer.
.IP CURLUPART_SCHEME .IP CURLUPART_SCHEME

View File

@ -33,7 +33,7 @@ its important components (like OpenSSL version).
We recommend using \fIcurl_version_info(3)\fP instead! We recommend using \fIcurl_version_info(3)\fP instead!
.SH RETURN VALUE .SH RETURN VALUE
A pointer to a zero terminated string. The string resides in a statically A pointer to a null-terminated string. The string resides in a statically
allocated buffer and must not be freed by the caller. allocated buffer and must not be freed by the caller.
.SH "SEE ALSO" .SH "SEE ALSO"
.BR curl_version_info "(3)" .BR curl_version_info "(3)"

View File

@ -28,7 +28,7 @@ CURLINFO_LOCAL_IP \- get local IP address of last connection
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_LOCAL_IP, char **ip); CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_LOCAL_IP, char **ip);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a char pointer to receive the pointer to a zero-terminated Pass a pointer to a char pointer to receive the pointer to a null-terminated
string holding the IP address of the local end of most recent connection done string holding the IP address of the local end of most recent connection done
with this \fBcurl\fP handle. This string may be IPv6 when that is with this \fBcurl\fP handle. This string may be IPv6 when that is
enabled. Note that you get a pointer to a memory area that will be re-used at enabled. Note that you get a pointer to a memory area that will be re-used at

View File

@ -28,7 +28,7 @@ CURLINFO_PRIMARY_IP \- get IP address of last connection
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_PRIMARY_IP, char **ip); CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_PRIMARY_IP, char **ip);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a char pointer to receive the pointer to a zero-terminated Pass a pointer to a char pointer to receive the pointer to a null-terminated
string holding the IP address of the most recent connection done with this string holding the IP address of the most recent connection done with this
\fBcurl\fP handle. This string may be IPv6 when that is enabled. Note that you \fBcurl\fP handle. This string may be IPv6 when that is enabled. Note that you
get a pointer to a memory area that will be re-used at next request so you get a pointer to a memory area that will be re-used at next request so you

View File

@ -28,7 +28,7 @@ CURLINFO_SCHEME \- get the URL scheme (sometimes called protocol) used in the co
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SCHEME, char **scheme); CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SCHEME, char **scheme);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a char pointer to receive the pointer to a zero-terminated Pass a pointer to a char pointer to receive the pointer to a null-terminated
string holding the URL scheme used for the most recent connection done with string holding the URL scheme used for the most recent connection done with
this CURL \fBhandle\fP. this CURL \fBhandle\fP.

View File

@ -29,7 +29,7 @@ CURLOPT_ABSTRACT_UNIX_SOCKET \- set an abstract Unix domain socket
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_ABSTRACT_UNIX_SOCKET, char *path); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_ABSTRACT_UNIX_SOCKET, char *path);
.SH DESCRIPTION .SH DESCRIPTION
Enables the use of an abstract Unix domain socket instead of establishing a TCP Enables the use of an abstract Unix domain socket instead of establishing a TCP
connection to a host. The parameter should be a char * to a zero terminated string connection to a host. The parameter should be a char * to a null-terminated string
holding the path of the socket. The path will be set to \fIpath\fP prefixed by a holding the path of the socket. The path will be set to \fIpath\fP prefixed by a
NULL byte (this is the convention for abstract sockets, however it should be stressed NULL byte (this is the convention for abstract sockets, however it should be stressed
that the path passed to this function should not contain a leading NULL). that the path passed to this function should not contain a leading NULL).

View File

@ -28,7 +28,7 @@ CURLOPT_CAINFO \- path to Certificate Authority (CA) bundle
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CAINFO, char *path); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CAINFO, char *path);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char * to a zero terminated string naming a file holding one or more Pass a char * to a null-terminated string naming a file holding one or more
certificates to verify the peer with. certificates to verify the peer with.
If \fICURLOPT_SSL_VERIFYPEER(3)\fP is zero and you avoid verifying the If \fICURLOPT_SSL_VERIFYPEER(3)\fP is zero and you avoid verifying the

View File

@ -28,7 +28,7 @@ CURLOPT_CAPATH \- specify directory holding CA certificates
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CAPATH, char *capath); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CAPATH, char *capath);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char * to a zero terminated string naming a directory holding multiple Pass a char * to a null-terminated string naming a directory holding multiple
CA certificates to verify the peer with. If libcurl is built against OpenSSL, CA certificates to verify the peer with. If libcurl is built against OpenSSL,
the certificate directory must be prepared using the openssl c_rehash utility. the certificate directory must be prepared using the openssl c_rehash utility.
This makes sense only when used in combination with the This makes sense only when used in combination with the

View File

@ -28,7 +28,7 @@ CURLOPT_COOKIE \- set contents of HTTP Cookie header
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_COOKIE, char *cookie); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_COOKIE, char *cookie);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string as parameter. It will be used to Pass a pointer to a null-terminated string as parameter. It will be used to
set a cookie in the HTTP request. The format of the string should be set a cookie in the HTTP request. The format of the string should be
NAME=CONTENTS, where NAME is the cookie name and CONTENTS is what the cookie NAME=CONTENTS, where NAME is the cookie name and CONTENTS is what the cookie
should contain. should contain.

View File

@ -28,7 +28,7 @@ CURLOPT_COOKIEFILE \- file name to read cookies from
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_COOKIEFILE, char *filename); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_COOKIEFILE, char *filename);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string as parameter. It should point to Pass a pointer to a null-terminated string as parameter. It should point to
the file name of your file holding cookie data to read. The cookie data can be the file name of your file holding cookie data to read. The cookie data can be
in either the old Netscape / Mozilla cookie data format or just regular HTTP in either the old Netscape / Mozilla cookie data format or just regular HTTP
headers (Set-Cookie style) dumped to a file. headers (Set-Cookie style) dumped to a file.

View File

@ -28,7 +28,7 @@ CURLOPT_COOKIEJAR \- file name to store cookies to
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_COOKIEJAR, char *filename); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_COOKIEJAR, char *filename);
.SH DESCRIPTION .SH DESCRIPTION
Pass a \fIfilename\fP as char *, zero terminated. This will make libcurl write Pass a \fIfilename\fP as char *, null-terminated. This will make libcurl write
all internally known cookies to the specified file when all internally known cookies to the specified file when
\fIcurl_easy_cleanup(3)\fP is called. If no cookies are known, no file will be \fIcurl_easy_cleanup(3)\fP is called. If no cookies are known, no file will be
created. Specify "-" as filename to instead have the cookies written to created. Specify "-" as filename to instead have the cookies written to

View File

@ -36,7 +36,7 @@ to overwrite the original data after setting this option.
Because data are copied, care must be taken when using this option in Because data are copied, care must be taken when using this option in
conjunction with \fICURLOPT_POSTFIELDSIZE(3)\fP or conjunction with \fICURLOPT_POSTFIELDSIZE(3)\fP or
\fICURLOPT_POSTFIELDSIZE_LARGE(3)\fP: If the size has not been set prior to \fICURLOPT_POSTFIELDSIZE_LARGE(3)\fP: If the size has not been set prior to
\fICURLOPT_COPYPOSTFIELDS(3)\fP, the data is assumed to be a zero terminated \fICURLOPT_COPYPOSTFIELDS(3)\fP, the data is assumed to be a null-terminated
string; else the stored size informs the library about the byte count to string; else the stored size informs the library about the byte count to
copy. In any case, the size must not be changed after copy. In any case, the size must not be changed after
\fICURLOPT_COPYPOSTFIELDS(3)\fP, unless another \fICURLOPT_POSTFIELDS(3)\fP or \fICURLOPT_COPYPOSTFIELDS(3)\fP, unless another \fICURLOPT_POSTFIELDS(3)\fP or

View File

@ -28,7 +28,7 @@ CURLOPT_CRLFILE \- specify a Certificate Revocation List file
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CRLFILE, char *file); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CRLFILE, char *file);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char * to a zero terminated string naming a \fIfile\fP with the Pass a char * to a null-terminated string naming a \fIfile\fP with the
concatenation of CRL (in PEM format) to use in the certificate validation that concatenation of CRL (in PEM format) to use in the certificate validation that
occurs during the SSL exchange. occurs during the SSL exchange.

View File

@ -28,7 +28,7 @@ CURLOPT_CUSTOMREQUEST \- custom string for request
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CUSTOMREQUEST, char *request); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CUSTOMREQUEST, char *request);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string as parameter. Pass a pointer to a null-terminated string as parameter.
When you change the request method by setting \fICURLOPT_CUSTOMREQUEST(3)\fP When you change the request method by setting \fICURLOPT_CUSTOMREQUEST(3)\fP
to something, you don't actually change how libcurl behaves or acts in regards to something, you don't actually change how libcurl behaves or acts in regards

View File

@ -54,7 +54,7 @@ shown above.
\fICURLOPT_VERBOSE(3)\fP is in effect. This callback receives debug \fICURLOPT_VERBOSE(3)\fP is in effect. This callback receives debug
information, as specified in the \fItype\fP argument. This function must information, as specified in the \fItype\fP argument. This function must
return 0. The \fIdata\fP pointed to by the char * passed to this function WILL return 0. The \fIdata\fP pointed to by the char * passed to this function WILL
NOT be zero terminated, but will be exactly of the \fIsize\fP as told by the NOT be null-terminated, but will be exactly of the \fIsize\fP as told by the
\fIsize\fP argument. \fIsize\fP argument.
The \fIuserptr\fP argument is the pointer set with \fICURLOPT_DEBUGDATA(3)\fP. The \fIuserptr\fP argument is the pointer set with \fICURLOPT_DEBUGDATA(3)\fP.

View File

@ -29,7 +29,7 @@ CURLOPT_DOH_URL \- provide the DNS-over-HTTPS URL
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DOH_URL, char *URL); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DOH_URL, char *URL);
.SH DESCRIPTION .SH DESCRIPTION
Pass in a pointer to a \fIURL\fP for the DOH server to use for name Pass in a pointer to a \fIURL\fP for the DOH server to use for name
resolving. The parameter should be a char * to a zero terminated string which resolving. The parameter should be a char * to a null-terminated string which
must be URL-encoded in the following format: "https://host:port/path". It MUST must be URL-encoded in the following format: "https://host:port/path". It MUST
specify a HTTPS URL. specify a HTTPS URL.

View File

@ -28,7 +28,7 @@ CURLOPT_EGDSOCKET \- set EGD socket path
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_EGDSOCKET, char *path); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_EGDSOCKET, char *path);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char * to the zero terminated path name to the Entropy Gathering Daemon Pass a char * to the null-terminated path name to the Entropy Gathering Daemon
socket. It will be used to seed the random engine for SSL. socket. It will be used to seed the random engine for SSL.
The application does not have to keep the string around after setting this The application does not have to keep the string around after setting this

View File

@ -28,7 +28,7 @@ CURLOPT_FTPPORT \- make FTP transfer active
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTPPORT, char *spec); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTPPORT, char *spec);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string as parameter. It specifies that the Pass a pointer to a null-terminated string as parameter. It specifies that the
FTP transfer will be made actively and the given string will be used to get FTP transfer will be made actively and the given string will be used to get
the IP address to use for the FTP PORT instruction. the IP address to use for the FTP PORT instruction.

View File

@ -28,7 +28,7 @@ CURLOPT_FTP_ACCOUNT \- set account info for FTP
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTP_ACCOUNT, char *account); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTP_ACCOUNT, char *account);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string (or NULL to disable). When an FTP Pass a pointer to a null-terminated string (or NULL to disable). When an FTP
server asks for "account data" after user name and password has been provided, server asks for "account data" after user name and password has been provided,
this data is sent off using the ACCT command. this data is sent off using the ACCT command.

View File

@ -41,7 +41,7 @@ data. The header callback will be called once for each header and only
complete header lines are passed on to the callback. Parsing headers is very complete header lines are passed on to the callback. Parsing headers is very
easy using this. \fIbuffer\fP points to the delivered data, and the size of easy using this. \fIbuffer\fP points to the delivered data, and the size of
that data is \fInitems\fP; \fIsize\fP is always 1. Do not assume that the that data is \fInitems\fP; \fIsize\fP is always 1. Do not assume that the
header line is zero terminated! header line is null-terminated!
The pointer named \fIuserdata\fP is the one you set with the The pointer named \fIuserdata\fP is the one you set with the
\fICURLOPT_HEADERDATA(3)\fP option. \fICURLOPT_HEADERDATA(3)\fP option.

View File

@ -28,7 +28,7 @@ CURLOPT_ISSUERCERT \- issuer SSL certificate filename
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_ISSUERCERT, char *file); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_ISSUERCERT, char *file);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char * to a zero terminated string naming a \fIfile\fP holding a CA Pass a char * to a null-terminated string naming a \fIfile\fP holding a CA
certificate in PEM format. If the option is set, an additional check against certificate in PEM format. If the option is set, an additional check against
the peer certificate is performed to verify the issuer is indeed the one the peer certificate is performed to verify the issuer is indeed the one
associated with the certificate provided by the option. This additional check associated with the certificate provided by the option. This additional check

View File

@ -28,7 +28,7 @@ CURLOPT_KEYPASSWD \- set passphrase to private key
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_KEYPASSWD, char *pwd); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_KEYPASSWD, char *pwd);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string as parameter. It will be used as Pass a pointer to a null-terminated string as parameter. It will be used as
the password required to use the \fICURLOPT_SSLKEY(3)\fP or the password required to use the \fICURLOPT_SSLKEY(3)\fP or
\fICURLOPT_SSH_PRIVATE_KEYFILE(3)\fP private key. You never needed a pass \fICURLOPT_SSH_PRIVATE_KEYFILE(3)\fP private key. You never needed a pass
phrase to load a certificate but you need one to load your private key. phrase to load a certificate but you need one to load your private key.

View File

@ -28,7 +28,7 @@ CURLOPT_LOGIN_OPTIONS \- set login options
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_LOGIN_OPTIONS, char *options); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_LOGIN_OPTIONS, char *options);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char * as parameter, which should be pointing to the zero terminated Pass a char * as parameter, which should be pointing to the null-terminated
\fIoptions\fP string to use for the transfer. \fIoptions\fP string to use for the transfer.
For more information about the login options please see RFC2384, RFC5092 and For more information about the login options please see RFC2384, RFC5092 and

View File

@ -28,7 +28,7 @@ CURLOPT_MAIL_AUTH \- SMTP authentication address
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAIL_AUTH, char *auth); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAIL_AUTH, char *auth);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string as parameter. This will be used to Pass a pointer to a null-terminated string as parameter. This will be used to
specify the authentication address (identity) of a submitted message that is specify the authentication address (identity) of a submitted message that is
being relayed to another server. being relayed to another server.

View File

@ -28,7 +28,7 @@ CURLOPT_MAIL_FROM \- SMTP sender address
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAIL_FROM, char *from); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAIL_FROM, char *from);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string as parameter. This should be used Pass a pointer to a null-terminated string as parameter. This should be used
to specify the sender's email address when sending SMTP mail with libcurl. to specify the sender's email address when sending SMTP mail with libcurl.
An originator email address should be specified with angled brackets (<>) An originator email address should be specified with angled brackets (<>)

View File

@ -28,7 +28,7 @@ CURLOPT_NETRC_FILE \- file name to read .netrc info from
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_NETRC_FILE, char *file); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_NETRC_FILE, char *file);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char * as parameter, pointing to a zero terminated string containing Pass a char * as parameter, pointing to a null-terminated string containing
the full path name to the \fIfile\fP you want libcurl to use as .netrc the full path name to the \fIfile\fP you want libcurl to use as .netrc
file. If this option is omitted, and \fICURLOPT_NETRC(3)\fP is set, libcurl file. If this option is omitted, and \fICURLOPT_NETRC(3)\fP is set, libcurl
will attempt to find a .netrc file in the current user's home will attempt to find a .netrc file in the current user's home

View File

@ -28,7 +28,7 @@ CURLOPT_NOPROXY \- disable proxy use for specific hosts
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_NOPROXY, char *noproxy); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_NOPROXY, char *noproxy);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string. The string consists of a comma Pass a pointer to a null-terminated string. The string consists of a comma
separated list of host names that do not require a proxy to get reached, even separated list of host names that do not require a proxy to get reached, even
if one is specified. The only wildcard available is a single * character, if one is specified. The only wildcard available is a single * character,
which matches all hosts, and effectively disables the proxy. Each name in this which matches all hosts, and effectively disables the proxy. Each name in this

View File

@ -28,7 +28,7 @@ CURLOPT_PASSWORD \- password to use in authentication
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PASSWORD, char *pwd); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PASSWORD, char *pwd);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char * as parameter, which should be pointing to the zero terminated Pass a char * as parameter, which should be pointing to the null-terminated
password to use for the transfer. password to use for the transfer.
The \fICURLOPT_PASSWORD(3)\fP option should be used in conjunction with the The \fICURLOPT_PASSWORD(3)\fP option should be used in conjunction with the

View File

@ -28,7 +28,7 @@ CURLOPT_PINNEDPUBLICKEY \- set pinned public key
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PINNEDPUBLICKEY, char *pinnedpubkey); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PINNEDPUBLICKEY, char *pinnedpubkey);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string as parameter. The string can be the Pass a pointer to a null-terminated string as parameter. The string can be the
file name of your pinned public key. The file format expected is "PEM" or "DER". file name of your pinned public key. The file format expected is "PEM" or "DER".
The string can also be any number of base64 encoded sha256 hashes preceded by The string can also be any number of base64 encoded sha256 hashes preceded by
"sha256//" and separated by ";" "sha256//" and separated by ";"

View File

@ -29,7 +29,7 @@ CURLOPT_PRE_PROXY \- set pre-proxy to use
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PRE_PROXY, char *preproxy); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PRE_PROXY, char *preproxy);
.SH DESCRIPTION .SH DESCRIPTION
Set the \fIpreproxy\fP to use for the upcoming request. The parameter Set the \fIpreproxy\fP to use for the upcoming request. The parameter
should be a char * to a zero terminated string holding the host name or dotted should be a char * to a null-terminated string holding the host name or dotted
numerical IP address. A numerical IPv6 address must be written within numerical IP address. A numerical IPv6 address must be written within
[brackets]. [brackets].

View File

@ -29,7 +29,7 @@ CURLOPT_PROXY \- set proxy to use
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY, char *proxy); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY, char *proxy);
.SH DESCRIPTION .SH DESCRIPTION
Set the \fIproxy\fP to use for the upcoming request. The parameter should be a Set the \fIproxy\fP to use for the upcoming request. The parameter should be a
char * to a zero terminated string holding the host name or dotted numerical char * to a null-terminated string holding the host name or dotted numerical
IP address. A numerical IPv6 address must be written within [brackets]. IP address. A numerical IPv6 address must be written within [brackets].
To specify port number in this string, append :[port] to the end of the host To specify port number in this string, append :[port] to the end of the host

View File

@ -28,7 +28,7 @@ CURLOPT_PROXYPASSWORD \- password to use with proxy authentication
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXYPASSWORD, char *pwd); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXYPASSWORD, char *pwd);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char * as parameter, which should be pointing to the zero terminated Pass a char * as parameter, which should be pointing to the null-terminated
password to use for authentication with the proxy. password to use for authentication with the proxy.
The \fICURLOPT_PROXYPASSWORD(3)\fP option should be used in conjunction with The \fICURLOPT_PROXYPASSWORD(3)\fP option should be used in conjunction with

View File

@ -30,7 +30,7 @@ CURLOPT_PROXYUSERNAME \- user name to use for proxy authentication
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXYUSERNAME, CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXYUSERNAME,
char *username); char *username);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char * as parameter, which should be pointing to the zero terminated Pass a char * as parameter, which should be pointing to the null-terminated
user name to use for the transfer. user name to use for the transfer.
\fICURLOPT_PROXYUSERNAME(3)\fP sets the user name to be used in protocol \fICURLOPT_PROXYUSERNAME(3)\fP sets the user name to be used in protocol

View File

@ -30,7 +30,7 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_CAINFO, char *path);
.SH DESCRIPTION .SH DESCRIPTION
This option is for connecting to an HTTPS proxy, not an HTTPS server. This option is for connecting to an HTTPS proxy, not an HTTPS server.
Pass a char * to a zero terminated string naming a file holding one or more Pass a char * to a null-terminated string naming a file holding one or more
certificates to verify the HTTPS proxy with. certificates to verify the HTTPS proxy with.
If \fICURLOPT_PROXY_SSL_VERIFYPEER(3)\fP is zero and you avoid verifying the If \fICURLOPT_PROXY_SSL_VERIFYPEER(3)\fP is zero and you avoid verifying the

View File

@ -28,7 +28,7 @@ CURLOPT_PROXY_CAPATH \- specify directory holding proxy CA certificates
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_CAPATH, char *capath); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_CAPATH, char *capath);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char * to a zero terminated string naming a directory holding multiple Pass a char * to a null-terminated string naming a directory holding multiple
CA certificates to verify the HTTPS proxy with. If libcurl is built against CA certificates to verify the HTTPS proxy with. If libcurl is built against
OpenSSL, the certificate directory must be prepared using the openssl c_rehash OpenSSL, the certificate directory must be prepared using the openssl c_rehash
utility. This makes sense only when \fICURLOPT_PROXY_SSL_VERIFYPEER(3)\fP is utility. This makes sense only when \fICURLOPT_PROXY_SSL_VERIFYPEER(3)\fP is

View File

@ -30,7 +30,7 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_CRLFILE, char *file);
.SH DESCRIPTION .SH DESCRIPTION
This option is for connecting to an HTTPS proxy, not an HTTPS server. This option is for connecting to an HTTPS proxy, not an HTTPS server.
Pass a char * to a zero terminated string naming a \fIfile\fP with the Pass a char * to a null-terminated string naming a \fIfile\fP with the
concatenation of CRL (in PEM format) to use in the certificate validation that concatenation of CRL (in PEM format) to use in the certificate validation that
occurs during the SSL exchange. occurs during the SSL exchange.

View File

@ -28,7 +28,7 @@ CURLOPT_PROXY_ISSUERCERT \- proxy issuer SSL certificate filename
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_ISSUERCERT, char *file); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_ISSUERCERT, char *file);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char * to a zero terminated string naming a \fIfile\fP holding a CA Pass a char * to a null-terminated string naming a \fIfile\fP holding a CA
certificate in PEM format. If the option is set, an additional check against certificate in PEM format. If the option is set, an additional check against
the peer certificate is performed to verify the issuer of the the HTTPS proxy the peer certificate is performed to verify the issuer of the the HTTPS proxy
is indeed the one associated with the certificate provided by the option. is indeed the one associated with the certificate provided by the option.

View File

@ -30,7 +30,7 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_KEYPASSWD, char *pwd);
.SH DESCRIPTION .SH DESCRIPTION
This option is for connecting to an HTTPS proxy, not an HTTPS server. This option is for connecting to an HTTPS proxy, not an HTTPS server.
Pass a pointer to a zero terminated string as parameter. It will be used as Pass a pointer to a null-terminated string as parameter. It will be used as
the password required to use the \fICURLOPT_PROXY_SSLKEY(3)\fP private key. the password required to use the \fICURLOPT_PROXY_SSLKEY(3)\fP private key.
You never needed a pass phrase to load a certificate but you need one to load You never needed a pass phrase to load a certificate but you need one to load
your private key. your private key.

View File

@ -28,7 +28,7 @@ CURLOPT_PROXY_PINNEDPUBLICKEY \- set pinned public key for https proxy
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_PINNEDPUBLICKEY, char *pinnedpubkey); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_PINNEDPUBLICKEY, char *pinnedpubkey);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string as parameter. The string can be the Pass a pointer to a null-terminated string as parameter. The string can be the
file name of your pinned public key. The file format expected is "PEM" or "DER". file name of your pinned public key. The file format expected is "PEM" or "DER".
The string can also be any number of base64 encoded sha256 hashes preceded by The string can also be any number of base64 encoded sha256 hashes preceded by
"sha256//" and separated by ";" "sha256//" and separated by ";"

View File

@ -30,7 +30,7 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSLCERT, char *cert);
.SH DESCRIPTION .SH DESCRIPTION
This option is for connecting to an HTTPS proxy, not an HTTPS server. This option is for connecting to an HTTPS proxy, not an HTTPS server.
Pass a pointer to a zero terminated string as parameter. The string should be Pass a pointer to a null-terminated string as parameter. The string should be
the file name of your client certificate used to connect to the HTTPS proxy. the file name of your client certificate used to connect to the HTTPS proxy.
The default format is "P12" on Secure Transport and "PEM" on other engines, The default format is "P12" on Secure Transport and "PEM" on other engines,
and can be changed with \fICURLOPT_PROXY_SSLCERTTYPE(3)\fP. and can be changed with \fICURLOPT_PROXY_SSLCERTTYPE(3)\fP.

View File

@ -28,7 +28,7 @@ CURLOPT_PROXY_SSLCERTTYPE \- specify type of the proxy client SSL certificate
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSLCERTTYPE, char *type); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSLCERTTYPE, char *type);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string as parameter. The string should be Pass a pointer to a null-terminated string as parameter. The string should be
the format of your client certificate used when connecting to an HTTPS proxy. the format of your client certificate used when connecting to an HTTPS proxy.
Supported formats are "PEM" and "DER", except with Secure Transport. OpenSSL Supported formats are "PEM" and "DER", except with Secure Transport. OpenSSL

View File

@ -28,7 +28,7 @@ CURLOPT_PROXY_SSLKEY \- specify private keyfile for TLS and SSL proxy client cer
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSLKEY, char *keyfile); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSLKEY, char *keyfile);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string as parameter. The string should be Pass a pointer to a null-terminated string as parameter. The string should be
the file name of your private key used for connecting to the HTTPS proxy. The the file name of your private key used for connecting to the HTTPS proxy. The
default format is "PEM" and can be changed with default format is "PEM" and can be changed with
\fICURLOPT_PROXY_SSLKEYTYPE(3)\fP. \fICURLOPT_PROXY_SSLKEYTYPE(3)\fP.

View File

@ -30,7 +30,7 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSLKEYTYPE, char *type);
.SH DESCRIPTION .SH DESCRIPTION
This option is for connecting to an HTTPS proxy, not an HTTPS server. This option is for connecting to an HTTPS proxy, not an HTTPS server.
Pass a pointer to a zero terminated string as parameter. The string should be Pass a pointer to a null-terminated string as parameter. The string should be
the format of your private key. Supported formats are "PEM", "DER" and "ENG". 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 The application does not have to keep the string around after setting this

View File

@ -28,7 +28,7 @@ CURLOPT_PROXY_SSL_CIPHER_LIST \- specify ciphers to use for proxy TLS
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSL_CIPHER_LIST, char *list); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSL_CIPHER_LIST, char *list);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char *, pointing to a zero terminated string holding the list of Pass a char *, pointing to a null-terminated string holding the list of
ciphers to use for the connection to the HTTPS proxy. The list must be ciphers to use for the connection to the HTTPS proxy. The list must be
syntactically correct, it consists of one or more cipher strings separated by syntactically correct, it consists of one or more cipher strings separated by
colons. Commas or spaces are also acceptable separators but colons are colons. Commas or spaces are also acceptable separators but colons are

View File

@ -28,7 +28,7 @@ CURLOPT_PROXY_TLS13_CIPHERS \- ciphers suites for proxy TLS 1.3
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_TLS13_CIPHERS, char *list); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_TLS13_CIPHERS, char *list);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char *, pointing to a zero terminated string holding the list of cipher Pass a char *, pointing to a null-terminated string holding the list of cipher
suites to use for the TLS 1.3 connection to a proxy. The list must be suites to use for the TLS 1.3 connection to a proxy. The list must be
syntactically correct, it consists of one or more cipher suite strings syntactically correct, it consists of one or more cipher suite strings
separated by colons. separated by colons.

View File

@ -28,7 +28,7 @@ CURLOPT_PROXY_TLSAUTH_PASSWORD \- password to use for proxy TLS authentication
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_TLSAUTH_PASSWORD, char *pwd); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_TLSAUTH_PASSWORD, char *pwd);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char * as parameter, which should point to the zero terminated password Pass a char * as parameter, which should point to the null-terminated password
to use for the TLS authentication method specified with the to use for the TLS authentication method specified with the
\fICURLOPT_PROXY_TLSAUTH_TYPE(3)\fP option. Requires that the \fICURLOPT_PROXY_TLSAUTH_TYPE(3)\fP option. Requires that the
\fICURLOPT_PROXY_TLSAUTH_USERNAME(3)\fP option also be set. \fICURLOPT_PROXY_TLSAUTH_USERNAME(3)\fP option also be set.

View File

@ -28,7 +28,7 @@ CURLOPT_PROXY_TLSAUTH_TYPE \- set proxy TLS authentication methods
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_TLSAUTH_TYPE, char *type); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_TLSAUTH_TYPE, char *type);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string as parameter. The string should be Pass a pointer to a null-terminated string as parameter. The string should be
the method of the TLS authentication used for the HTTPS connection. Supported the method of the TLS authentication used for the HTTPS connection. Supported
method is "SRP". method is "SRP".

View File

@ -28,7 +28,7 @@ CURLOPT_PROXY_TLSAUTH_USERNAME \- user name to use for proxy TLS authentication
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_TLSAUTH_USERNAME, char *user); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_TLSAUTH_USERNAME, char *user);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char * as parameter, which should point to the zero terminated username Pass a char * as parameter, which should point to the null-terminated username
to use for the HTTPS proxy TLS authentication method specified with the to use for the HTTPS proxy TLS authentication method specified with the
\fICURLOPT_PROXY_TLSAUTH_TYPE(3)\fP option. Requires that the \fICURLOPT_PROXY_TLSAUTH_TYPE(3)\fP option. Requires that the
\fICURLOPT_PROXY_TLSAUTH_PASSWORD(3)\fP option also be set. \fICURLOPT_PROXY_TLSAUTH_PASSWORD(3)\fP option also be set.

View File

@ -28,7 +28,7 @@ CURLOPT_RANDOM_FILE \- specify a source for random data
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_RANDOM_FILE, char *path); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_RANDOM_FILE, char *path);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char * to a zero terminated file name. The file might be used to read Pass a char * to a null-terminated file name. The file might be used to read
from to seed the random engine for SSL and more. from to seed the random engine for SSL and more.
The application does not have to keep the string around after setting this The application does not have to keep the string around after setting this

View File

@ -28,7 +28,7 @@ CURLOPT_REFERER \- set the HTTP referer header
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_REFERER, char *where); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_REFERER, char *where);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string as parameter. It will be used to Pass a pointer to a null-terminated string as parameter. It will be used to
set the Referer: header in the http request sent to the remote server. This set the Referer: header in the http request sent to the remote server. This
can be used to fool servers or scripts. You can also set any custom header can be used to fool servers or scripts. You can also set any custom header
with \fICURLOPT_HTTPHEADER(3)\fP. with \fICURLOPT_HTTPHEADER(3)\fP.

View File

@ -28,7 +28,7 @@ CURLOPT_SASL_AUTHZID \- authorisation identity (identity to act as)
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SASL_AUTHZID, char *authzid); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SASL_AUTHZID, char *authzid);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char * as parameter, which should be pointing to the zero terminated Pass a char * as parameter, which should be pointing to the null-terminated
authorisation identity (authzid) for the transfer. Only applicable to the PLAIN authorisation identity (authzid) for the transfer. Only applicable to the PLAIN
SASL authentication mechanism where it is optional. SASL authentication mechanism where it is optional.

View File

@ -44,7 +44,7 @@ enum curl_khmatch {
}; };
struct curl_khkey { struct curl_khkey {
const char *key; /* points to a zero-terminated string encoded with const char *key; /* points to a null-terminated string encoded with
base64 if len is zero, otherwise to the "raw" base64 if len is zero, otherwise to the "raw"
data */ data */
size_t len; size_t len;

View File

@ -28,7 +28,7 @@ CURLOPT_SSH_KNOWNHOSTS \- file name holding the SSH known hosts
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSH_KNOWNHOSTS, char *fname); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSH_KNOWNHOSTS, char *fname);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string holding the file name of the Pass a pointer to a null-terminated string holding the file name of the
known_host file to use. The known_hosts file should use the OpenSSH file known_host file to use. The known_hosts file should use the OpenSSH file
format as supported by libssh2. If this file is specified, libcurl will only format as supported by libssh2. If this file is specified, libcurl will only
accept connections with hosts that are known and present in that file, with a accept connections with hosts that are known and present in that file, with a

View File

@ -28,7 +28,7 @@ CURLOPT_SSLCERT \- set SSL client certificate
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLCERT, char *cert); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLCERT, char *cert);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string as parameter. The string should be Pass a pointer to a null-terminated string as parameter. The string should be
the file name of your client certificate. The default format is "P12" on the file name of your client certificate. The default format is "P12" on
Secure Transport and "PEM" on other engines, and can be changed with Secure Transport and "PEM" on other engines, and can be changed with
\fICURLOPT_SSLCERTTYPE(3)\fP. \fICURLOPT_SSLCERTTYPE(3)\fP.

View File

@ -28,7 +28,7 @@ CURLOPT_SSLCERTTYPE \- specify type of the client SSL certificate
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLCERTTYPE, char *type); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLCERTTYPE, char *type);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string as parameter. The string should be Pass a pointer to a null-terminated string as parameter. The string should be
the format of your certificate. Supported formats are "PEM" and "DER", except the format of your certificate. Supported formats are "PEM" and "DER", except
with Secure Transport. OpenSSL (versions 0.9.3 and later) and Secure Transport with Secure Transport. OpenSSL (versions 0.9.3 and later) and Secure Transport
(on iOS 5 or later, or OS X 10.7 or later) also support "P12" for (on iOS 5 or later, or OS X 10.7 or later) also support "P12" for

View File

@ -28,7 +28,7 @@ CURLOPT_SSLENGINE \- set SSL engine identifier
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLENGINE, char *id); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLENGINE, char *id);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string as parameter. It will be used as Pass a pointer to a null-terminated string as parameter. It will be used as
the identifier for the crypto engine you want to use for your private key. the identifier for the crypto engine you want to use for your private key.
The application does not have to keep the string around after setting this The application does not have to keep the string around after setting this

View File

@ -28,7 +28,7 @@ CURLOPT_SSLKEY \- specify private keyfile for TLS and SSL client cert
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLKEY, char *keyfile); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLKEY, char *keyfile);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string as parameter. The string should be Pass a pointer to a null-terminated string as parameter. The string should be
the file name of your private key. The default format is "PEM" and can be the file name of your private key. The default format is "PEM" and can be
changed with \fICURLOPT_SSLKEYTYPE(3)\fP. changed with \fICURLOPT_SSLKEYTYPE(3)\fP.

View File

@ -28,7 +28,7 @@ CURLOPT_SSLKEYTYPE \- set type of the private key file
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLKEYTYPE, char *type); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLKEYTYPE, char *type);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string as parameter. The string should be Pass a pointer to a null-terminated string as parameter. The string should be
the format of your private key. Supported formats are "PEM", "DER" and "ENG". the format of your private key. Supported formats are "PEM", "DER" and "ENG".
The format "ENG" enables you to load the private key from a crypto engine. In The format "ENG" enables you to load the private key from a crypto engine. In

View File

@ -28,7 +28,7 @@ CURLOPT_SSL_CIPHER_LIST \- specify ciphers to use for TLS
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_CIPHER_LIST, char *list); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_CIPHER_LIST, char *list);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char *, pointing to a zero terminated string holding the list of Pass a char *, pointing to a null-terminated string holding the list of
ciphers to use for the SSL connection. The list must be syntactically correct, ciphers to use for the SSL connection. The list must be syntactically correct,
it consists of one or more cipher strings separated by colons. Commas or it consists of one or more cipher strings separated by colons. Commas or
spaces are also acceptable separators but colons are normally used, \&!, \&- spaces are also acceptable separators but colons are normally used, \&!, \&-

View File

@ -28,7 +28,7 @@ CURLOPT_TLS13_CIPHERS \- specify ciphers suites to use for TLS 1.3
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TLS13_CIPHERS, char *list); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TLS13_CIPHERS, char *list);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char *, pointing to a zero terminated string holding the list of cipher Pass a char *, pointing to a null-terminated string holding the list of cipher
suites to use for the TLS 1.3 connection. The list must be syntactically suites to use for the TLS 1.3 connection. The list must be syntactically
correct, it consists of one or more cipher suite strings separated by colons. correct, it consists of one or more cipher suite strings separated by colons.

View File

@ -28,7 +28,7 @@ CURLOPT_TLSAUTH_PASSWORD \- password to use for TLS authentication
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TLSAUTH_PASSWORD, char *pwd); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TLSAUTH_PASSWORD, char *pwd);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char * as parameter, which should point to the zero terminated password Pass a char * as parameter, which should point to the null-terminated password
to use for the TLS authentication method specified with the to use for the TLS authentication method specified with the
\fICURLOPT_TLSAUTH_TYPE(3)\fP option. Requires that the \fICURLOPT_TLSAUTH_TYPE(3)\fP option. Requires that the
\fICURLOPT_TLSAUTH_USERNAME(3)\fP option also be set. \fICURLOPT_TLSAUTH_USERNAME(3)\fP option also be set.

View File

@ -28,7 +28,7 @@ CURLOPT_TLSAUTH_TYPE \- set TLS authentication methods
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TLSAUTH_TYPE, char *type); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TLSAUTH_TYPE, char *type);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string as parameter. The string should be Pass a pointer to a null-terminated string as parameter. The string should be
the method of the TLS authentication. Supported method is "SRP". the method of the TLS authentication. Supported method is "SRP".
.IP SRP .IP SRP

View File

@ -28,7 +28,7 @@ CURLOPT_TLSAUTH_USERNAME \- user name to use for TLS authentication
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TLSAUTH_USERNAME, char *user); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TLSAUTH_USERNAME, char *user);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char * as parameter, which should point to the zero terminated username Pass a char * as parameter, which should point to the null-terminated username
to use for the TLS authentication method specified with the to use for the TLS authentication method specified with the
\fICURLOPT_TLSAUTH_TYPE(3)\fP option. Requires that the \fICURLOPT_TLSAUTH_TYPE(3)\fP option. Requires that the
\fICURLOPT_TLSAUTH_PASSWORD(3)\fP option also be set. \fICURLOPT_TLSAUTH_PASSWORD(3)\fP option also be set.

View File

@ -29,7 +29,7 @@ CURLOPT_URL \- provide the URL to use in the request
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_URL, char *URL); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_URL, char *URL);
.SH DESCRIPTION .SH DESCRIPTION
Pass in a pointer to the \fIURL\fP to work with. The parameter should be a Pass in a pointer to the \fIURL\fP to work with. The parameter should be a
char * to a zero terminated string which must be URL-encoded in the following char * to a null-terminated string which must be URL-encoded in the following
format: format:
scheme://host:port/path scheme://host:port/path

View File

@ -28,7 +28,7 @@ CURLOPT_USERAGENT \- set HTTP user-agent header
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_USERAGENT, char *ua); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_USERAGENT, char *ua);
.SH DESCRIPTION .SH DESCRIPTION
Pass a pointer to a zero terminated string as parameter. It will be used to Pass a pointer to a null-terminated string as parameter. It will be used to
set the User-Agent: header in the HTTP request sent to the remote server. This set the User-Agent: header in the HTTP request sent to the remote server. This
can be used to fool servers or scripts. You can also set any custom header can be used to fool servers or scripts. You can also set any custom header
with \fICURLOPT_HTTPHEADER(3)\fP. with \fICURLOPT_HTTPHEADER(3)\fP.

View File

@ -30,7 +30,7 @@ CURLOPT_USERNAME \- user name to use in authentication
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_USERNAME, CURLcode curl_easy_setopt(CURL *handle, CURLOPT_USERNAME,
char *username); char *username);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char * as parameter, which should be pointing to the zero terminated Pass a char * as parameter, which should be pointing to the null-terminated
user name to use for the transfer. user name to use for the transfer.
\fICURLOPT_USERNAME(3)\fP sets the user name to be used in protocol \fICURLOPT_USERNAME(3)\fP sets the user name to be used in protocol

View File

@ -28,7 +28,7 @@ CURLOPT_USERPWD \- user name and password to use in authentication
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_USERPWD, char *userpwd); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_USERPWD, char *userpwd);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char * as parameter, pointing to a zero terminated login details string Pass a char * as parameter, pointing to a null-terminated login details string
for the connection. The format of which is: [user name]:[password]. for the connection. The format of which is: [user name]:[password].
When using Kerberos V5 authentication with a Windows based server, you should When using Kerberos V5 authentication with a Windows based server, you should

View File

@ -52,7 +52,7 @@ means 100K.
This function may be called with zero bytes data if the transferred file is This function may be called with zero bytes data if the transferred file is
empty. empty.
The data passed to this function will not be zero terminated! The data passed to this function will not be null-terminated!
Set the \fIuserdata\fP argument with the \fICURLOPT_WRITEDATA(3)\fP option. Set the \fIuserdata\fP argument with the \fICURLOPT_WRITEDATA(3)\fP option.

View File

@ -28,7 +28,7 @@ CURLOPT_XOAUTH2_BEARER \- specify OAuth 2.0 access token
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_XOAUTH2_BEARER, char *token); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_XOAUTH2_BEARER, char *token);
.SH DESCRIPTION .SH DESCRIPTION
Pass a char * as parameter, which should point to the zero terminated OAuth Pass a char * as parameter, which should point to the null-terminated OAuth
2.0 Bearer Access Token for use with HTTP, IMAP, POP3 and SMTP servers 2.0 Bearer Access Token for use with HTTP, IMAP, POP3 and SMTP servers
that support the OAuth 2.0 Authorization Framework. that support the OAuth 2.0 Authorization Framework.

View File

@ -774,7 +774,7 @@ enum curl_khtype {
}; };
struct curl_khkey { struct curl_khkey {
const char *key; /* points to a zero-terminated string encoded with base64 const char *key; /* points to a null-terminated string encoded with base64
if len is zero, otherwise to the "raw" data */ if len is zero, otherwise to the "raw" data */
size_t len; size_t len;
enum curl_khtype keytype; enum curl_khtype keytype;
@ -1446,7 +1446,7 @@ typedef enum {
/* 132 OBSOLETE. Gone in 7.16.0 */ /* 132 OBSOLETE. Gone in 7.16.0 */
/* 133 OBSOLETE. Gone in 7.16.0 */ /* 133 OBSOLETE. Gone in 7.16.0 */
/* zero terminated string for pass on to the FTP server when asked for /* null-terminated string for pass on to the FTP server when asked for
"account" info */ "account" info */
CURLOPT(CURLOPT_FTP_ACCOUNT, CURLOPTTYPE_STRINGPOINT, 134), CURLOPT(CURLOPT_FTP_ACCOUNT, CURLOPTTYPE_STRINGPOINT, 134),
@ -2118,7 +2118,7 @@ typedef enum {
CURL_TIMECOND_LAST CURL_TIMECOND_LAST
} curl_TimeCond; } curl_TimeCond;
/* Special size_t value signaling a zero-terminated string. */ /* Special size_t value signaling a null-terminated string. */
#define CURL_ZERO_TERMINATED ((size_t) -1) #define CURL_ZERO_TERMINATED ((size_t) -1)
/* curl_strequal() and curl_strnequal() are subject for removal in a future /* curl_strequal() and curl_strnequal() are subject for removal in a future

View File

@ -267,7 +267,7 @@ CURL_EXTERN CURLMsg *curl_multi_info_read(CURLM *multi_handle,
* value into the equivalent human readable error string. This is * value into the equivalent human readable error string. This is
* useful for printing meaningful error messages. * useful for printing meaningful error messages.
* *
* Returns: A pointer to a zero-terminated error message. * Returns: A pointer to a null-terminated error message.
*/ */
CURL_EXTERN const char *curl_multi_strerror(CURLMcode); CURL_EXTERN const char *curl_multi_strerror(CURLMcode);

View File

@ -755,7 +755,7 @@ Curl_cookie_add(struct Curl_easy *data,
co->path = malloc(pathlen + 1); /* one extra for the zero byte */ co->path = malloc(pathlen + 1); /* one extra for the zero byte */
if(co->path) { if(co->path) {
memcpy(co->path, path, pathlen); memcpy(co->path, path, pathlen);
co->path[pathlen] = 0; /* zero terminate */ co->path[pathlen] = 0; /* null-terminate */
co->spath = sanitize_cookie_path(co->path); co->spath = sanitize_cookie_path(co->path);
if(!co->spath) if(!co->spath)
badcookie = TRUE; /* out of memory bad */ badcookie = TRUE; /* out of memory bad */

View File

@ -5,7 +5,7 @@
* | (__| |_| | _ <| |___ * | (__| |_| | _ <| |___
* \___|\___/|_| \_\_____| * \___|\___/|_| \_\_____|
* *
* Copyright (C) 1998 - 2019, Daniel Stenberg, <daniel@haxx.se>, et al. * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al.
* *
* This software is licensed as described in the file COPYING, which * This software is licensed as described in the file COPYING, which
* you should have received as part of this distribution. The terms * you should have received as part of this distribution. The terms
@ -39,7 +39,7 @@
* Curl_dedotdotify() * Curl_dedotdotify()
* @unittest: 1395 * @unittest: 1395
* *
* This function gets a zero-terminated path with dot and dotdot sequences * This function gets a null-terminated path with dot and dotdot sequences
* passed in and strips them off according to the rules in RFC 3986 section * passed in and strips them off according to the rules in RFC 3986 section
* 5.2.4. * 5.2.4.
* *
@ -62,7 +62,7 @@ char *Curl_dedotdotify(const char *input)
if(!out) if(!out)
return NULL; /* out of memory */ return NULL; /* out of memory */
*out = 0; /* zero terminates, for inputs like "./" */ *out = 0; /* null-terminates, for inputs like "./" */
/* get a cloned copy of the input */ /* get a cloned copy of the input */
clone = strdup(input); clone = strdup(input);
@ -129,7 +129,7 @@ char *Curl_dedotdotify(const char *input)
if(*outptr == '/') if(*outptr == '/')
break; break;
} }
*outptr = 0; /* zero-terminate where it stops */ *outptr = 0; /* null-terminate where it stops */
} }
else if(!strcmp("/..", clone)) { else if(!strcmp("/..", clone)) {
clone[2]='/'; clone[2]='/';
@ -141,7 +141,7 @@ char *Curl_dedotdotify(const char *input)
if(*outptr == '/') if(*outptr == '/')
break; break;
} }
*outptr = 0; /* zero-terminate where it stops */ *outptr = 0; /* null-terminate where it stops */
} }
/* D. if the input buffer consists only of "." or "..", then remove /* D. if the input buffer consists only of "." or "..", then remove

View File

@ -161,7 +161,7 @@ CURLcode Curl_dyn_addn(struct dynbuf *s, const void *mem, size_t len)
} }
/* /*
* Append a zero terminated string at the end. * Append a null-terminated string at the end.
*/ */
CURLcode Curl_dyn_add(struct dynbuf *s, const char *str) CURLcode Curl_dyn_add(struct dynbuf *s, const char *str)
{ {

View File

@ -23,7 +23,7 @@
***************************************************************************/ ***************************************************************************/
struct dynbuf { struct dynbuf {
char *bufr; /* point to a zero terminated allocated buffer */ char *bufr; /* point to a null-terminated allocated buffer */
size_t leng; /* number of bytes *EXCLUDING* the zero terminator */ size_t leng; /* number of bytes *EXCLUDING* the zero terminator */
size_t allc; /* size of the current allocation */ size_t allc; /* size of the current allocation */
size_t toobig; /* size limit for the buffer */ size_t toobig; /* size limit for the buffer */

View File

@ -602,7 +602,7 @@ CURLFORMcode FormAdd(struct curl_httppost **httppost,
/* Note that there's small risk that form->name is NULL here if the /* Note that there's small risk that form->name is NULL here if the
app passed in a bad combo, so we better check for that first. */ app passed in a bad combo, so we better check for that first. */
if(form->name) { if(form->name) {
/* copy name (without strdup; possibly not nul-terminated) */ /* copy name (without strdup; possibly not null-terminated) */
form->name = Curl_memdup(form->name, form->namelength? form->name = Curl_memdup(form->name, form->namelength?
form->namelength: form->namelength:
strlen(form->name) + 1); strlen(form->name) + 1);
@ -771,7 +771,7 @@ void curl_formfree(struct curl_httppost *form)
} }
/* Set mime part name, taking care of non nul-terminated name string. */ /* Set mime part name, taking care of non null-terminated name string. */
static CURLcode setname(curl_mimepart *part, const char *name, size_t len) static CURLcode setname(curl_mimepart *part, const char *name, size_t len)
{ {
char *zname; char *zname;

View File

@ -2827,7 +2827,7 @@ static CURLcode ftp_statemach_act(struct connectdata *conn)
store++; store++;
ptr++; ptr++;
} }
*store = '\0'; /* zero terminate */ *store = '\0'; /* null-terminate */
} }
if(entry_extracted) { if(entry_extracted) {
/* If the path name does not look like an absolute path (i.e.: it /* If the path name does not look like an absolute path (i.e.: it
@ -2891,7 +2891,7 @@ static CURLcode ftp_statemach_act(struct connectdata *conn)
ptr++; ptr++;
for(store = os; *ptr && *ptr != ' ';) for(store = os; *ptr && *ptr != ' ';)
*store++ = *ptr++; *store++ = *ptr++;
*store = '\0'; /* zero terminate */ *store = '\0'; /* null-terminate */
/* Check for special servers here. */ /* Check for special servers here. */

View File

@ -270,7 +270,7 @@ char *Curl_copy_header_value(const char *header)
return NULL; return NULL;
memcpy(value, start, len); memcpy(value, start, len);
value[len] = 0; /* zero terminate */ value[len] = 0; /* null-terminate */
return value; return value;
} }

View File

@ -1419,7 +1419,7 @@ CURLcode curl_mime_data(curl_mimepart *part,
if(datasize) if(datasize)
memcpy(part->data, data, datasize); memcpy(part->data, data, datasize);
part->data[datasize] = '\0'; /* Set a nul terminator as sentinel. */ part->data[datasize] = '\0'; /* Set a null terminator as sentinel. */
part->readfunc = mime_mem_read; part->readfunc = mime_mem_read;
part->seekfunc = mime_mem_seek; part->seekfunc = mime_mem_seek;

View File

@ -384,10 +384,10 @@ CURLcode Curl_pp_readresp(curl_socket_t sockfd,
if(pp->endofresp(conn, pp->linestart_resp, perline, code)) { if(pp->endofresp(conn, pp->linestart_resp, perline, code)) {
/* This is the end of the last line, copy the last line to the /* This is the end of the last line, copy the last line to the
start of the buffer and zero terminate, for old times sake */ start of the buffer and null-terminate, for old times sake */
size_t n = ptr - pp->linestart_resp; size_t n = ptr - pp->linestart_resp;
memmove(buf, pp->linestart_resp, n); memmove(buf, pp->linestart_resp, n);
buf[n] = 0; /* zero terminate */ buf[n] = 0; /* null-terminate */
keepon = FALSE; keepon = FALSE;
pp->linestart_resp = ptr + 1; /* advance pointer */ pp->linestart_resp = ptr + 1; /* advance pointer */
i++; /* skip this before getting out */ i++; /* skip this before getting out */

View File

@ -795,7 +795,7 @@ const char *Curl_strerror(int err, char *buf, size_t buflen)
#endif /* end of not Windows */ #endif /* end of not Windows */
buf[max] = '\0'; /* make sure the string is zero terminated */ buf[max] = '\0'; /* make sure the string is null-terminated */
/* strip trailing '\r\n' or '\n'. */ /* strip trailing '\r\n' or '\n'. */
p = strrchr(buf, '\n'); p = strrchr(buf, '\n');

View File

@ -5,7 +5,7 @@
* | (__| |_| | _ <| |___ * | (__| |_| | _ <| |___
* \___|\___/|_| \_\_____| * \___|\___/|_| \_\_____|
* *
* Copyright (C) 1998 - 2019, Daniel Stenberg, <daniel@haxx.se>, et al. * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al.
* *
* This software is licensed as described in the file COPYING, which * This software is licensed as described in the file COPYING, which
* you should have received as part of this distribution. The terms * you should have received as part of this distribution. The terms
@ -52,7 +52,7 @@ Curl_strtok_r(char *ptr, const char *sep, char **end)
if(**end) { if(**end) {
/* the end is not a null byte */ /* the end is not a null byte */
**end = '\0'; /* zero terminate it! */ **end = '\0'; /* null-terminate it! */
++*end; /* advance the last pointer to beyond the null byte */ ++*end; /* advance the last pointer to beyond the null byte */
} }

View File

@ -225,7 +225,7 @@ static void strcpy_url(char *output, const char *url, bool relative)
break; break;
} }
} }
*optr = 0; /* zero terminate output buffer */ *optr = 0; /* null-terminate output buffer */
} }
@ -584,7 +584,7 @@ static CURLUcode junkscan(const char *part)
0x10, 0x11, 0x12, 0x13, 0x14, 0x15, 0x16, 0x17, 0x10, 0x11, 0x12, 0x13, 0x14, 0x15, 0x16, 0x17,
0x18, 0x19, 0x1a, 0x1b, 0x1c, 0x1d, 0x1e, 0x1f, 0x18, 0x19, 0x1a, 0x1b, 0x1c, 0x1d, 0x1e, 0x1f,
0x7f, 0x7f,
0x00 /* zero terminate */ 0x00 /* null-terminate */
}; };
size_t n = strlen(part); size_t n = strlen(part);
size_t nfine = strcspn(part, badbytes); size_t nfine = strcspn(part, badbytes);
@ -1398,7 +1398,7 @@ CURLUcode curl_url_set(CURLU *u, CURLUPart what,
i = (const unsigned char *)part; i = (const unsigned char *)part;
for(o = enc; *i; ++o, ++i) for(o = enc; *i; ++o, ++i)
*o = (*i == ' ') ? '+' : *i; *o = (*i == ' ') ? '+' : *i;
*o = 0; /* zero terminate */ *o = 0; /* null-terminate */
part = strdup(enc); part = strdup(enc);
if(!part) { if(!part) {
free(enc); free(enc);
@ -1422,7 +1422,7 @@ CURLUcode curl_url_set(CURLU *u, CURLUPart what,
o += 3; o += 3;
} }
} }
*o = 0; /* zero terminate */ *o = 0; /* null-terminate */
newp = enc; newp = enc;
if(free_part) if(free_part)
free((char *)part); free((char *)part);

View File

@ -1564,7 +1564,7 @@ enum dupstring {
STRING_DNS_LOCAL_IP4, STRING_DNS_LOCAL_IP4,
STRING_DNS_LOCAL_IP6, STRING_DNS_LOCAL_IP6,
/* -- end of zero-terminated strings -- */ /* -- end of null-terminated strings -- */
STRING_LASTZEROTERMINATED, STRING_LASTZEROTERMINATED,

View File

@ -1636,7 +1636,7 @@ static CURLcode verifyhost(struct connectdata *conn, X509 *server_cert)
type itself: for example for an IA5String the data will be ASCII" type itself: for example for an IA5String the data will be ASCII"
It has been however verified that in 0.9.6 and 0.9.7, IA5String It has been however verified that in 0.9.6 and 0.9.7, IA5String
is always zero-terminated. is always null-terminated.
*/ */
if((altlen == strlen(altptr)) && if((altlen == strlen(altptr)) &&
/* if this isn't true, there was an embedded zero in the name /* if this isn't true, there was an embedded zero in the name

View File

@ -706,7 +706,7 @@ CURLcode Curl_ssl_init_certinfo(struct Curl_easy *data, int num)
} }
/* /*
* 'value' is NOT a zero terminated string * 'value' is NOT a null-terminated string
*/ */
CURLcode Curl_ssl_push_certinfo_len(struct Curl_easy *data, CURLcode Curl_ssl_push_certinfo_len(struct Curl_easy *data,
int certnum, int certnum,
@ -728,10 +728,10 @@ CURLcode Curl_ssl_push_certinfo_len(struct Curl_easy *data,
/* sprintf the label and colon */ /* sprintf the label and colon */
msnprintf(output, outlen, "%s:", label); msnprintf(output, outlen, "%s:", label);
/* memcpy the value (it might not be zero terminated) */ /* memcpy the value (it might not be null-terminated) */
memcpy(&output[labellen + 1], value, valuelen); memcpy(&output[labellen + 1], value, valuelen);
/* zero terminate the output */ /* null-terminate the output */
output[labellen + 1 + valuelen] = 0; output[labellen + 1 + valuelen] = 0;
nl = Curl_slist_append_nodup(ci->certinfo[certnum], output); nl = Curl_slist_append_nodup(ci->certinfo[certnum], output);

Some files were not shown because too many files have changed in this diff Show More