mirror of https://github.com/moparisthebest/curl
docs: unified man page references to use \fI
This commit is contained in:
parent
7e5f3c3781
commit
dac8ce9558
|
@ -5,7 +5,7 @@
|
||||||
.\" * | (__| |_| | _ <| |___
|
.\" * | (__| |_| | _ <| |___
|
||||||
.\" * \___|\___/|_| \_\_____|
|
.\" * \___|\___/|_| \_\_____|
|
||||||
.\" *
|
.\" *
|
||||||
.\" * Copyright (C) 1998 - 2015, Daniel Stenberg, <daniel@haxx.se>, et al.
|
.\" * Copyright (C) 1998 - 2016, 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
|
||||||
|
@ -55,7 +55,7 @@ While the \fBeasy_handle\fP is added to a multi handle, it cannot be used by
|
||||||
.SH RETURN VALUE
|
.SH RETURN VALUE
|
||||||
CURLE_OK (0) means everything was ok, non-zero means an error occurred as
|
CURLE_OK (0) means everything was ok, non-zero means an error occurred as
|
||||||
.I <curl/curl.h>
|
.I <curl/curl.h>
|
||||||
defines - see \fIlibcurl-errors(3)\fP. If the \fBCURLOPT_ERRORBUFFER(3)\fP was
|
defines - see \fIlibcurl-errors(3)\fP. If the \fICURLOPT_ERRORBUFFER(3)\fP was
|
||||||
set with \fIcurl_easy_setopt(3)\fP there will be a readable error message in
|
set with \fIcurl_easy_setopt(3)\fP there will be a readable error message in
|
||||||
the error buffer when non-zero is returned.
|
the error buffer when non-zero is returned.
|
||||||
.SH EXAMPLE
|
.SH EXAMPLE
|
||||||
|
|
|
@ -5,7 +5,7 @@
|
||||||
.\" * | (__| |_| | _ <| |___
|
.\" * | (__| |_| | _ <| |___
|
||||||
.\" * \___|\___/|_| \_\_____|
|
.\" * \___|\___/|_| \_\_____|
|
||||||
.\" *
|
.\" *
|
||||||
.\" * Copyright (C) 1998 - 2015, Daniel Stenberg, <daniel@haxx.se>, et al.
|
.\" * Copyright (C) 1998 - 2016, 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
|
||||||
|
@ -41,7 +41,7 @@ data. \fBbuflen\fP is the maximum amount of data you can get in that
|
||||||
buffer. The variable \fBn\fP points to will receive the number of received
|
buffer. The variable \fBn\fP points to will receive the number of received
|
||||||
bytes.
|
bytes.
|
||||||
|
|
||||||
To establish the connection, set \fBCURLOPT_CONNECT_ONLY(3)\fP option before
|
To establish the connection, set \fICURLOPT_CONNECT_ONLY(3)\fP option before
|
||||||
calling \fIcurl_easy_perform(3)\fP or \fIcurl_multi_perform(3)\fP. Note that
|
calling \fIcurl_easy_perform(3)\fP or \fIcurl_multi_perform(3)\fP. Note that
|
||||||
\fIcurl_easy_recv(3)\fP does not work on connections that were created without
|
\fIcurl_easy_recv(3)\fP does not work on connections that were created without
|
||||||
this option.
|
this option.
|
||||||
|
@ -49,7 +49,7 @@ this option.
|
||||||
You must ensure that the socket has data to read before calling
|
You must ensure that the socket has data to read before calling
|
||||||
\fIcurl_easy_recv(3)\fP, otherwise the call will return \fBCURLE_AGAIN\fP -
|
\fIcurl_easy_recv(3)\fP, otherwise the call will return \fBCURLE_AGAIN\fP -
|
||||||
the socket is used in non-blocking mode internally. Use
|
the socket is used in non-blocking mode internally. Use
|
||||||
\fIcurl_easy_getinfo(3)\fP with \fBCURLINFO_ACTIVESOCKET(3)\fP to obtain the
|
\fIcurl_easy_getinfo(3)\fP with \fICURLINFO_ACTIVESOCKET(3)\fP to obtain the
|
||||||
socket; use your operating system facilities like \fIselect(2)\fP to check if
|
socket; use your operating system facilities like \fIselect(2)\fP to check if
|
||||||
it has any data you can read.
|
it has any data you can read.
|
||||||
.SH AVAILABILITY
|
.SH AVAILABILITY
|
||||||
|
|
|
@ -5,7 +5,7 @@
|
||||||
.\" * | (__| |_| | _ <| |___
|
.\" * | (__| |_| | _ <| |___
|
||||||
.\" * \___|\___/|_| \_\_____|
|
.\" * \___|\___/|_| \_\_____|
|
||||||
.\" *
|
.\" *
|
||||||
.\" * Copyright (C) 1998 - 2015, Daniel Stenberg, <daniel@haxx.se>, et al.
|
.\" * Copyright (C) 1998 - 2016, 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 @@ connection set-up.
|
||||||
\fBbuffer\fP is a pointer to the data of length \fBbuflen\fP that you want sent.
|
\fBbuffer\fP is a pointer to the data of length \fBbuflen\fP that you want sent.
|
||||||
The variable \fBn\fP points to will receive the number of sent bytes.
|
The variable \fBn\fP points to will receive the number of sent bytes.
|
||||||
|
|
||||||
To establish the connection, set \fBCURLOPT_CONNECT_ONLY(3)\fP option before
|
To establish the connection, set \fICURLOPT_CONNECT_ONLY(3)\fP option before
|
||||||
calling \fIcurl_easy_perform(3)\fP or \fIcurl_multi_perform()\fP. Note that
|
calling \fIcurl_easy_perform(3)\fP or \fIcurl_multi_perform()\fP. Note that
|
||||||
\fIcurl_easy_send(3)\fP will not work on connections that were created without
|
\fIcurl_easy_send(3)\fP will not work on connections that were created without
|
||||||
this option.
|
this option.
|
||||||
|
@ -47,7 +47,7 @@ this option.
|
||||||
You must ensure that the socket is writable before calling
|
You must ensure that the socket is writable before calling
|
||||||
\fIcurl_easy_send(3)\fP, otherwise the call will return \fBCURLE_AGAIN\fP -
|
\fIcurl_easy_send(3)\fP, otherwise the call will return \fBCURLE_AGAIN\fP -
|
||||||
the socket is used in non-blocking mode internally. Use
|
the socket is used in non-blocking mode internally. Use
|
||||||
\fIcurl_easy_getinfo(3)\fP with \fBCURLINFO_ACTIVESOCKET(3)\fP to obtain the
|
\fIcurl_easy_getinfo(3)\fP with \fICURLINFO_ACTIVESOCKET(3)\fP to obtain the
|
||||||
socket; use your operating system facilities like \fIselect(2)\fP to check if
|
socket; use your operating system facilities like \fIselect(2)\fP to check if
|
||||||
it can be written to.
|
it can be written to.
|
||||||
.SH AVAILABILITY
|
.SH AVAILABILITY
|
||||||
|
|
|
@ -5,7 +5,7 @@
|
||||||
.\" * | (__| |_| | _ <| |___
|
.\" * | (__| |_| | _ <| |___
|
||||||
.\" * \___|\___/|_| \_\_____|
|
.\" * \___|\___/|_| \_\_____|
|
||||||
.\" *
|
.\" *
|
||||||
.\" * Copyright (C) 1998 - 2015, Daniel Stenberg, <daniel@haxx.se>, et al.
|
.\" * Copyright (C) 1998 - 2016, 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
|
||||||
|
@ -32,7 +32,7 @@ curl_formadd - add a section to a multipart/formdata HTTP POST
|
||||||
curl_formadd() is used to append sections when building a multipart/formdata
|
curl_formadd() is used to append sections when building a multipart/formdata
|
||||||
HTTP POST (sometimes referred to as RFC2388-style posts). Append one section
|
HTTP POST (sometimes referred to as RFC2388-style posts). Append one section
|
||||||
at a time until you've added all the sections you want included and then you
|
at a time until you've added all the sections you want included and then you
|
||||||
pass the \fIfirstitem\fP pointer as parameter to \fBCURLOPT_HTTPPOST(3)\fP.
|
pass the \fIfirstitem\fP pointer as parameter to \fICURLOPT_HTTPPOST(3)\fP.
|
||||||
\fIlastitem\fP is set after each \fIcurl_formadd(3)\fP call and on repeated
|
\fIlastitem\fP is set after each \fIcurl_formadd(3)\fP call and on repeated
|
||||||
invokes it should be left as set to allow repeated invokes to find the end of
|
invokes it should be left as set to allow repeated invokes to find the end of
|
||||||
the list faster.
|
the list faster.
|
||||||
|
|
|
@ -5,7 +5,7 @@
|
||||||
.\" * | (__| |_| | _ <| |___
|
.\" * | (__| |_| | _ <| |___
|
||||||
.\" * \___|\___/|_| \_\_____|
|
.\" * \___|\___/|_| \_\_____|
|
||||||
.\" *
|
.\" *
|
||||||
.\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.
|
.\" * Copyright (C) 1998 - 2016, 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_formfree() is used to clean up data previously built/appended with
|
||||||
typically means after \fIcurl_easy_perform(3)\fP has been called.
|
typically means after \fIcurl_easy_perform(3)\fP has been called.
|
||||||
|
|
||||||
The pointer to free is the same pointer you passed to the
|
The pointer to free is the same pointer you passed to the
|
||||||
\fBCURLOPT_HTTPPOST(3)\fP option, which is the \fIfirstitem\fP pointer from
|
\fICURLOPT_HTTPPOST(3)\fP option, which is the \fIfirstitem\fP pointer from
|
||||||
the \fIcurl_formadd(3)\fP invoke(s).
|
the \fIcurl_formadd(3)\fP invoke(s).
|
||||||
|
|
||||||
\fBform\fP is the pointer as returned from a previous call to
|
\fBform\fP is the pointer as returned from a previous call to
|
||||||
|
|
|
@ -5,7 +5,7 @@
|
||||||
.\" * | (__| |_| | _ <| |___
|
.\" * | (__| |_| | _ <| |___
|
||||||
.\" * \___|\___/|_| \_\_____|
|
.\" * \___|\___/|_| \_\_____|
|
||||||
.\" *
|
.\" *
|
||||||
.\" * Copyright (C) 1998 - 2011, Daniel Stenberg, <daniel@haxx.se>, et al.
|
.\" * Copyright (C) 1998 - 2016, 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
|
||||||
|
@ -28,7 +28,7 @@ curl_global_cleanup - global libcurl cleanup
|
||||||
.BI "void curl_global_cleanup(void);"
|
.BI "void curl_global_cleanup(void);"
|
||||||
.ad
|
.ad
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
This function releases resources acquired by \fBcurl_global_init(3)\fP.
|
This function releases resources acquired by \fIcurl_global_init(3)\fP.
|
||||||
|
|
||||||
You should call \fIcurl_global_cleanup(3)\fP once for each call you make to
|
You should call \fIcurl_global_cleanup(3)\fP once for each call you make to
|
||||||
\fIcurl_global_init(3)\fP, after you are done using libcurl.
|
\fIcurl_global_init(3)\fP, after you are done using libcurl.
|
||||||
|
@ -36,11 +36,11 @@ You should call \fIcurl_global_cleanup(3)\fP once for each call you make to
|
||||||
\fBThis function is not thread safe.\fP You must not call it when any other
|
\fBThis function is not thread safe.\fP You must not call it when any other
|
||||||
thread in the program (i.e. a thread sharing the same memory) is running.
|
thread in the program (i.e. a thread sharing the same memory) is running.
|
||||||
This doesn't just mean no other thread that is using libcurl. Because
|
This doesn't just mean no other thread that is using libcurl. Because
|
||||||
\fBcurl_global_cleanup(3)\fP calls functions of other libraries that are
|
\fIcurl_global_cleanup(3)\fP calls functions of other libraries that are
|
||||||
similarly thread unsafe, it could conflict with any other thread that uses
|
similarly thread unsafe, it could conflict with any other thread that uses
|
||||||
these other libraries.
|
these other libraries.
|
||||||
|
|
||||||
See the description in \fBlibcurl(3)\fP of global environment requirements for
|
See the description in \fIlibcurl(3)\fP of global environment requirements for
|
||||||
details of how to use this function.
|
details of how to use this function.
|
||||||
|
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
|
|
|
@ -5,7 +5,7 @@
|
||||||
.\" * | (__| |_| | _ <| |___
|
.\" * | (__| |_| | _ <| |___
|
||||||
.\" * \___|\___/|_| \_\_____|
|
.\" * \___|\___/|_| \_\_____|
|
||||||
.\" *
|
.\" *
|
||||||
.\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.
|
.\" * Copyright (C) 1998 - 2016, 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
|
||||||
|
@ -54,7 +54,7 @@ If you are initializing libcurl from a Windows DLL you should not initialize it
|
||||||
from DllMain or a static initializer because Windows holds the loader lock
|
from DllMain or a static initializer because Windows holds the loader lock
|
||||||
during that time and it could cause a deadlock.
|
during that time and it could cause a deadlock.
|
||||||
|
|
||||||
See the description in \fBlibcurl(3)\fP of global environment requirements for
|
See the description in \fIlibcurl(3)\fP of global environment requirements for
|
||||||
details of how to use this function.
|
details of how to use this function.
|
||||||
|
|
||||||
.SH FLAGS
|
.SH FLAGS
|
||||||
|
|
|
@ -5,7 +5,7 @@
|
||||||
.\" * | (__| |_| | _ <| |___
|
.\" * | (__| |_| | _ <| |___
|
||||||
.\" * \___|\___/|_| \_\_____|
|
.\" * \___|\___/|_| \_\_____|
|
||||||
.\" *
|
.\" *
|
||||||
.\" * Copyright (C) 1998 - 2011, Daniel Stenberg, <daniel@haxx.se>, et al.
|
.\" * Copyright (C) 1998 - 2016, 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
|
||||||
|
@ -43,7 +43,7 @@ decreases by one, it DOES NOT necessarily mean that this exact socket/transfer
|
||||||
is the one that completed. Use \fIcurl_multi_info_read(3)\fP to figure out
|
is the one that completed. Use \fIcurl_multi_info_read(3)\fP to figure out
|
||||||
which easy handle that completed.
|
which easy handle that completed.
|
||||||
|
|
||||||
The \fBcurl_multi_socket_action(3)\fP functions inform the application about
|
The \fIcurl_multi_socket_action(3)\fP functions inform the application about
|
||||||
updates in the socket (file descriptor) status by doing none, one, or multiple
|
updates in the socket (file descriptor) status by doing none, one, or multiple
|
||||||
calls to the socket callback function set with the CURLMOPT_SOCKETFUNCTION
|
calls to the socket callback function set with the CURLMOPT_SOCKETFUNCTION
|
||||||
option to \fIcurl_multi_setopt(3)\fP. They update the status with changes
|
option to \fIcurl_multi_setopt(3)\fP. They update the status with changes
|
||||||
|
@ -52,7 +52,7 @@ since the previous time the callback was called.
|
||||||
Get the timeout time by setting the \fICURLMOPT_TIMERFUNCTION\fP option with
|
Get the timeout time by setting the \fICURLMOPT_TIMERFUNCTION\fP option with
|
||||||
\fIcurl_multi_setopt(3)\fP. Your application will then get called with
|
\fIcurl_multi_setopt(3)\fP. Your application will then get called with
|
||||||
information on how long to wait for socket actions at most before doing the
|
information on how long to wait for socket actions at most before doing the
|
||||||
timeout action: call the \fBcurl_multi_socket_action(3)\fP function with the
|
timeout action: call the \fIcurl_multi_socket_action(3)\fP function with the
|
||||||
\fBsockfd\fP argument set to CURL_SOCKET_TIMEOUT. You can also use the
|
\fBsockfd\fP argument set to CURL_SOCKET_TIMEOUT. You can also use the
|
||||||
\fIcurl_multi_timeout(3)\fP function to poll the value at any given time, but
|
\fIcurl_multi_timeout(3)\fP function to poll the value at any given time, but
|
||||||
for an event-based system using the callback is far better than relying on
|
for an event-based system using the callback is far better than relying on
|
||||||
|
@ -63,7 +63,7 @@ equivalent to \fIcurl_multi_socket_action(3)\fP with \fBev_bitmask\fP set to
|
||||||
0.
|
0.
|
||||||
|
|
||||||
Force libcurl to (re-)check all its internal sockets and transfers instead of
|
Force libcurl to (re-)check all its internal sockets and transfers instead of
|
||||||
just a single one by calling \fBcurl_multi_socket_all(3)\fP. Note that there
|
just a single one by calling \fIcurl_multi_socket_all(3)\fP. Note that there
|
||||||
should not be any reason to use this function!
|
should not be any reason to use this function!
|
||||||
.SH "CALLBACK DETAILS"
|
.SH "CALLBACK DETAILS"
|
||||||
|
|
||||||
|
|
|
@ -61,7 +61,7 @@ called.
|
||||||
Get the timeout time by setting the \fICURLMOPT_TIMERFUNCTION(3)\fP option
|
Get the timeout time by setting the \fICURLMOPT_TIMERFUNCTION(3)\fP option
|
||||||
with \fIcurl_multi_setopt(3)\fP. Your application will then get called with
|
with \fIcurl_multi_setopt(3)\fP. Your application will then get called with
|
||||||
information on how long to wait for socket actions at most before doing the
|
information on how long to wait for socket actions at most before doing the
|
||||||
timeout action: call the \fBcurl_multi_socket_action(3)\fP function with the
|
timeout action: call the \fIcurl_multi_socket_action(3)\fP function with the
|
||||||
\fBsockfd\fP argument set to CURL_SOCKET_TIMEOUT. You can also use the
|
\fBsockfd\fP argument set to CURL_SOCKET_TIMEOUT. You can also use the
|
||||||
\fIcurl_multi_timeout(3)\fP function to poll the value at any given time, but
|
\fIcurl_multi_timeout(3)\fP function to poll the value at any given time, but
|
||||||
for an event-based system using the callback is far better than relying on
|
for an event-based system using the callback is far better than relying on
|
||||||
|
@ -78,7 +78,7 @@ The socket \fBcallback\fP function uses a prototype like this
|
||||||
void *socketp); /* private socket pointer,
|
void *socketp); /* private socket pointer,
|
||||||
\fBNULL\fP if not
|
\fBNULL\fP if not
|
||||||
previously assigned with
|
previously assigned with
|
||||||
\fBcurl_multi_assign(3)\fP */
|
\fIcurl_multi_assign(3)\fP */
|
||||||
|
|
||||||
.fi
|
.fi
|
||||||
The callback MUST return 0.
|
The callback MUST return 0.
|
||||||
|
|
|
@ -5,7 +5,7 @@
|
||||||
.\" * | (__| |_| | _ <| |___
|
.\" * | (__| |_| | _ <| |___
|
||||||
.\" * \___|\___/|_| \_\_____|
|
.\" * \___|\___/|_| \_\_____|
|
||||||
.\" *
|
.\" *
|
||||||
.\" * Copyright (C) 1998 - 2015, Daniel Stenberg, <daniel@haxx.se>, et al.
|
.\" * Copyright (C) 1998 - 2016, 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
|
||||||
|
@ -29,12 +29,12 @@ CURLMcode curl_multi_timeout(CURLM *multi_handle, long *timeout);
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
|
|
||||||
An application using the libcurl multi interface should call
|
An application using the libcurl multi interface should call
|
||||||
\fBcurl_multi_timeout(3)\fP to figure out how long it should wait for socket
|
\fIcurl_multi_timeout(3)\fP to figure out how long it should wait for socket
|
||||||
actions \- at most \- before proceeding.
|
actions \- at most \- before proceeding.
|
||||||
|
|
||||||
Proceeding means either doing the socket-style timeout action: call the
|
Proceeding means either doing the socket-style timeout action: call the
|
||||||
\fBcurl_multi_socket_action(3)\fP function with the \fBsockfd\fP argument set
|
\fIcurl_multi_socket_action(3)\fP function with the \fBsockfd\fP argument set
|
||||||
to CURL_SOCKET_TIMEOUT, or call \fBcurl_multi_perform(3)\fP if you're using
|
to CURL_SOCKET_TIMEOUT, or call \fIcurl_multi_perform(3)\fP if you're using
|
||||||
the simpler and older multi interface approach.
|
the simpler and older multi interface approach.
|
||||||
|
|
||||||
The timeout value returned in the long \fBtimeout\fP points to, is in number
|
The timeout value returned in the long \fBtimeout\fP points to, is in number
|
||||||
|
@ -68,9 +68,9 @@ select(maxfd+1, &fdread, &fdwrite, &fdexcep, &timeout);
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
The standard CURLMcode for multi interface error codes.
|
The standard CURLMcode for multi interface error codes.
|
||||||
.SH "TYPICAL USAGE"
|
.SH "TYPICAL USAGE"
|
||||||
Call \fBcurl_multi_timeout(3)\fP, then wait for action on the sockets. You
|
Call \fIcurl_multi_timeout(3)\fP, then wait for action on the sockets. You
|
||||||
figure out which sockets to wait for by calling \fBcurl_multi_fdset(3)\fP or
|
figure out which sockets to wait for by calling \fIcurl_multi_fdset(3)\fP or
|
||||||
by a previous call to \fBcurl_multi_socket(3)\fP.
|
by a previous call to \fIcurl_multi_socket(3)\fP.
|
||||||
.SH AVAILABILITY
|
.SH AVAILABILITY
|
||||||
This function was added in libcurl 7.15.4.
|
This function was added in libcurl 7.15.4.
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
|
|
|
@ -5,7 +5,7 @@
|
||||||
.\" * | (__| |_| | _ <| |___
|
.\" * | (__| |_| | _ <| |___
|
||||||
.\" * \___|\___/|_| \_\_____|
|
.\" * \___|\___/|_| \_\_____|
|
||||||
.\" *
|
.\" *
|
||||||
.\" * Copyright (C) 1998 - 2015, Daniel Stenberg, <daniel@haxx.se>, et al.
|
.\" * Copyright (C) 1998 - 2016, 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,7 +36,7 @@ been appended when this function returns. curl_slist_append() copies the
|
||||||
string.
|
string.
|
||||||
|
|
||||||
The list should be freed again (after usage) with
|
The list should be freed again (after usage) with
|
||||||
\fBcurl_slist_free_all(3)\fP.
|
\fIcurl_slist_free_all(3)\fP.
|
||||||
.SH RETURN VALUE
|
.SH RETURN VALUE
|
||||||
A null pointer is returned if anything went wrong, otherwise the new list
|
A null pointer is returned if anything went wrong, otherwise the new list
|
||||||
pointer is returned.
|
pointer is returned.
|
||||||
|
|
|
@ -5,7 +5,7 @@
|
||||||
.\" * | (__| |_| | _ <| |___
|
.\" * | (__| |_| | _ <| |___
|
||||||
.\" * \___|\___/|_| \_\_____|
|
.\" * \___|\___/|_| \_\_____|
|
||||||
.\" *
|
.\" *
|
||||||
.\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.
|
.\" * Copyright (C) 1998 - 2016, 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
|
||||||
|
@ -30,7 +30,7 @@ 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 zero terminated string as parameter.
|
||||||
|
|
||||||
When you change the request method by setting \fBCURLOPT_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
|
||||||
to the particular request method, it will only change the actual string sent
|
to the particular request method, it will only change the actual string sent
|
||||||
in the request.
|
in the request.
|
||||||
|
|
|
@ -5,7 +5,7 @@
|
||||||
.\" * | (__| |_| | _ <| |___
|
.\" * | (__| |_| | _ <| |___
|
||||||
.\" * \___|\___/|_| \_\_____|
|
.\" * \___|\___/|_| \_\_____|
|
||||||
.\" *
|
.\" *
|
||||||
.\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.
|
.\" * Copyright (C) 1998 - 2016, 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 @@ Pass a char * as parameter, which should be pointing to the zero terminated
|
||||||
For more information about the login options please see RFC2384, RFC5092 and
|
For more information about the login options please see RFC2384, RFC5092 and
|
||||||
IETF draft draft-earhart-url-smtp-00.txt
|
IETF draft draft-earhart-url-smtp-00.txt
|
||||||
|
|
||||||
\fBCURLOPT_LOGIN_OPTIONS(3)\fP can be used to set protocol specific login
|
\fICURLOPT_LOGIN_OPTIONS(3)\fP can be used to set protocol specific login
|
||||||
options, such as the preferred authentication mechanism via "AUTH=NTLM" or
|
options, such as the preferred authentication mechanism via "AUTH=NTLM" or
|
||||||
"AUTH=*", and should be used in conjunction with the \fICURLOPT_USERNAME(3)\fP
|
"AUTH=*", and should be used in conjunction with the \fICURLOPT_USERNAME(3)\fP
|
||||||
option.
|
option.
|
||||||
|
|
|
@ -5,7 +5,7 @@
|
||||||
.\" * | (__| |_| | _ <| |___
|
.\" * | (__| |_| | _ <| |___
|
||||||
.\" * \___|\___/|_| \_\_____|
|
.\" * \___|\___/|_| \_\_____|
|
||||||
.\" *
|
.\" *
|
||||||
.\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.
|
.\" * Copyright (C) 1998 - 2016, 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 @@ this are \fICURLPROXY_HTTP\fP, \fICURLPROXY_HTTP_1_0\fP
|
||||||
\fICURLPROXY_SOCKS4\fP, \fICURLPROXY_SOCKS5\fP, \fICURLPROXY_SOCKS4A\fP and
|
\fICURLPROXY_SOCKS4\fP, \fICURLPROXY_SOCKS5\fP, \fICURLPROXY_SOCKS4A\fP and
|
||||||
\fICURLPROXY_SOCKS5_HOSTNAME\fP. The HTTP type is default.
|
\fICURLPROXY_SOCKS5_HOSTNAME\fP. The HTTP type is default.
|
||||||
|
|
||||||
If you set \fBCURLOPT_PROXYTYPE(3)\fP to \fICURLPROXY_HTTP_1_0\fP, it will
|
If you set \fICURLOPT_PROXYTYPE(3)\fP to \fICURLPROXY_HTTP_1_0\fP, it will
|
||||||
only affect how libcurl speaks to a proxy when CONNECT is used. The HTTP
|
only affect how libcurl speaks to a proxy when CONNECT is used. The HTTP
|
||||||
version used for "regular" HTTP requests is instead controlled with
|
version used for "regular" HTTP requests is instead controlled with
|
||||||
\fICURLOPT_HTTP_VERSION(3)\fP.
|
\fICURLOPT_HTTP_VERSION(3)\fP.
|
||||||
|
|
|
@ -5,7 +5,7 @@
|
||||||
.\" * | (__| |_| | _ <| |___
|
.\" * | (__| |_| | _ <| |___
|
||||||
.\" * \___|\___/|_| \_\_____|
|
.\" * \___|\___/|_| \_\_____|
|
||||||
.\" *
|
.\" *
|
||||||
.\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.
|
.\" * Copyright (C) 1998 - 2016, 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 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXYUSERNAME,
|
||||||
Pass a char * as parameter, which should be pointing to the zero terminated
|
Pass a char * as parameter, which should be pointing to the zero terminated
|
||||||
user name to use for the transfer.
|
user name to use for the transfer.
|
||||||
|
|
||||||
\fBCURLOPT_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
|
||||||
authentication with the proxy.
|
authentication with the proxy.
|
||||||
|
|
||||||
To specify the proxy password use the \fICURLOPT_PROXYPASSWORD(3)\fP.
|
To specify the proxy password use the \fICURLOPT_PROXYPASSWORD(3)\fP.
|
||||||
|
|
|
@ -5,7 +5,7 @@
|
||||||
.\" * | (__| |_| | _ <| |___
|
.\" * | (__| |_| | _ <| |___
|
||||||
.\" * \___|\___/|_| \_\_____|
|
.\" * \___|\___/|_| \_\_____|
|
||||||
.\" *
|
.\" *
|
||||||
.\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.
|
.\" * Copyright (C) 1998 - 2016, 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,7 +36,7 @@ HTTP response sent using a compressed Transfer-Encoding that will be
|
||||||
automatically uncompressed by libcurl on reception.
|
automatically uncompressed by libcurl on reception.
|
||||||
|
|
||||||
Transfer-Encoding differs slightly from the Content-Encoding you ask for with
|
Transfer-Encoding differs slightly from the Content-Encoding you ask for with
|
||||||
\fBCURLOPT_ACCEPT_ENCODING(3)\fP in that a Transfer-Encoding is strictly meant
|
\fICURLOPT_ACCEPT_ENCODING(3)\fP in that a Transfer-Encoding is strictly meant
|
||||||
to be for the transfer and thus MUST be decoded before the data arrives in the
|
to be for the transfer and thus MUST be decoded before the data arrives in the
|
||||||
client. Traditionally, Transfer-Encoding has been much less used and supported
|
client. Traditionally, Transfer-Encoding has been much less used and supported
|
||||||
by both HTTP clients and HTTP servers.
|
by both HTTP clients and HTTP servers.
|
||||||
|
|
|
@ -5,7 +5,7 @@
|
||||||
.\" * | (__| |_| | _ <| |___
|
.\" * | (__| |_| | _ <| |___
|
||||||
.\" * \___|\___/|_| \_\_____|
|
.\" * \___|\___/|_| \_\_____|
|
||||||
.\" *
|
.\" *
|
||||||
.\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.
|
.\" * Copyright (C) 1998 - 2016, 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 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_USERNAME,
|
||||||
Pass a char * as parameter, which should be pointing to the zero terminated
|
Pass a char * as parameter, which should be pointing to the zero terminated
|
||||||
user name to use for the transfer.
|
user name to use for the transfer.
|
||||||
|
|
||||||
\fBCURLOPT_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
|
||||||
authentication. You should not use this option together with the (older)
|
authentication. You should not use this option together with the (older)
|
||||||
\fICURLOPT_USERPWD(3)\fP option.
|
\fICURLOPT_USERPWD(3)\fP option.
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue