lib man pages: update easy setopt option references

-1, it can be because of many reasons (unknown, the server hides it or the

server doesn't support the command that tells document time etc) and the time

of the document is unknown. Note that you must tell the server to collect this

information before the transfer is made, by using the CURLOPT_FILETIME option

to \fIcurl_easy_setopt(3)\fP or you will unconditionally get a -1 back. (Added

in 7.5)

information before the transfer is made, by using the

\fICURLOPT_FILETIME(3)\fP option to \fIcurl_easy_setopt(3)\fP or you will

unconditionally get a -1 back. (Added in 7.5)

.IP CURLINFO_TOTAL_TIME

Pass a pointer to a double to receive the total time in seconds for the

previous transfer, including name resolving, TCP connect etc.

actually followed.  (Added in 7.9.7)

.IP CURLINFO_REDIRECT_URL

Pass a pointer to a char pointer to receive the URL a redirect \fIwould\fP

take you to if you would enable CURLOPT_FOLLOWLOCATION. This can come very

handy if you think using the built-in libcurl redirect logic isn't good enough

for you but you would still prefer to avoid implementing all the magic of

figuring out the new URL. (Added in 7.18.2)

take you to if you would enable \fICURLOPT_FOLLOWLOCATION(3)\fP. This can come

very handy if you think using the built-in libcurl redirect logic isn't good

enough for you but you would still prefer to avoid implementing all the magic

of figuring out the new URL. (Added in 7.18.2)

.IP CURLINFO_SIZE_UPLOAD

Pass a pointer to a double to receive the total amount of bytes that were

uploaded.

than one request if FOLLOWLOCATION is true.

.IP CURLINFO_SSL_VERIFYRESULT

Pass a pointer to a long to receive the result of the certification

verification that was requested (using the CURLOPT_SSL_VERIFYPEER option to

\fIcurl_easy_setopt(3)\fP).

verification that was requested (using the \fICURLOPT_SSL_VERIFYPEER(3)\fP

option to \fIcurl_easy_setopt(3)\fP).

.IP CURLINFO_SSL_ENGINES

Pass the address of a 'struct curl_slist *' to receive a linked-list of

OpenSSL crypto-engines supported. Note that engines are normally implemented

protocol used doesn't support this.

.IP CURLINFO_PRIVATE

Pass a pointer to a char pointer to receive the pointer to the private data

associated with the curl handle (set with the CURLOPT_PRIVATE option to

\fIcurl_easy_setopt(3)\fP). Please note that for internal reasons, the

associated with the curl handle (set with the \fICURLOPT_PRIVATE(3)\fP option

to \fIcurl_easy_setopt(3)\fP). Please note that for internal reasons, the

value is returned as a char pointer, although effectively being a 'void *'.

(Added in 7.10.3)

.IP CURLINFO_HTTPAUTH_AVAIL

Pass a pointer to a long to receive a bitmask indicating the authentication

method(s) available. The meaning of the bits is explained in the

CURLOPT_HTTPAUTH option for \fIcurl_easy_setopt(3)\fP.  (Added in 7.10.8)

\fICURLOPT_HTTPAUTH(3)\fP option for \fIcurl_easy_setopt(3)\fP.  (Added in

7.10.8)

.IP CURLINFO_PROXYAUTH_AVAIL

Pass a pointer to a long to receive a bitmask indicating the authentication

method(s) available for your proxy authentication.  (Added in 7.10.8)

session. If the socket is no longer valid, -1 is returned. When you finish

working with the socket, you must call curl_easy_cleanup() as usual and let

libcurl close the socket and cleanup other resources associated with the

handle. This is typically used in combination with \fICURLOPT_CONNECT_ONLY\fP.

(Added in 7.15.2)

handle. This is typically used in combination with

\fICURLOPT_CONNECT_ONLY(3)\fP.  (Added in 7.15.2)

NOTE: this API is not really working on win64, since the SOCKET type on win64

is 64 bit large while its 'long' is only 32 bits.

.IP CURLINFO_CERTINFO

Pass a pointer to a 'struct curl_certinfo *' and you'll get it set to point to

struct that holds a number of linked lists with info about the certificate

chain, assuming you had CURLOPT_CERTINFO enabled when the previous request was

done. The struct reports how many certs it found and then you can extract info

for each of those certs by following the linked lists. The info chain is

provided in a series of data in the format "name:content" where the content is

for the specific named data. See also the certinfo.c example. NOTE: this

option is only available in libcurl built with OpenSSL, NSS, GSKit or QsoSSL

support. (Added in 7.19.1)

chain, assuming you had \fICURLOPT_CERTINFO(3)\fP enabled when the previous

request was done. The struct reports how many certs it found and then you can

extract info for each of those certs by following the linked lists. The info

chain is provided in a series of data in the format "name:content" where the

content is for the specific named data. See also the certinfo.c example. NOTE:

this option is only available in libcurl built with OpenSSL, NSS, GSKit or

QsoSSL support. (Added in 7.19.1)

.IP CURLINFO_TLS_SESSION

Pass a pointer to a 'struct curl_tlsinfo *'.  The pointer will be initialized

to refer to a 'struct curl_tlsinfo *' that will contain an enum indicating the

.IP CURLINFO_CONDITION_UNMET

Pass a pointer to a long to receive the number 1 if the condition provided in

the previous request didn't match (see \fICURLOPT_TIMECONDITION\fP). Alas, if

this returns a 1 you know that the reason you didn't get data in return is

the previous request didn't match (see \fICURLOPT_TIMECONDITION(3)\fP). Alas,

if this returns a 1 you know that the reason you didn't get data in return is

because it didn't fulfill the condition. The long ths argument points to will

get a zero stored if the condition instead was met. (Added in 7.19.4)

.IP CURLINFO_RTSP_SESSION_ID

.\" *                            | (__| |_| |  _ <| |___

.\" *                             \___|\___/|_| \_\_____|

.\" *

.\" * Copyright (C) 1998 - 2013, Daniel Stenberg, <daniel@haxx.se>, et al.

.\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.

.\" *

.\" * This software is licensed as described in the file COPYING, which

.\" * you should have received as part of this distribution. The terms

While it may feel tempting, take care and notice that you cannot call this

function from another thread. To unpause, you may for example call it from the

progress callback (see \fIcurl_easy_setopt(3)\fP's

\fICURLOPT_PROGRESSFUNCTION\fP), which gets called at least once per second,

even if the connection is paused.

\fICURLOPT_PROGRESSFUNCTION(3)\fP), which gets called at least once per

second, even if the connection is paused.

When this function is called to unpause reading, the chance is high that you

will get your write callback called before this function returns.

.IP CURLPAUSE_RECV

Pause receiving data. There will be no data received on this connection until

this function is called again without this bit set. Thus, the write callback

(\fICURLOPT_WRITEFUNCTION\fP) won't be called.

(\fICURLOPT_WRITEFUNCTION(3)\fP) won't be called.

.IP CURLPAUSE_SEND

Pause sending data. There will be no data sent on this connection until this

function is called again without this bit set. Thus, the read callback

(\fICURLOPT_READFUNCTION\fP) won't be called.

(\fICURLOPT_READFUNCTION(3)\fP) won't be called.

.IP CURLPAUSE_ALL

Convenience define that pauses both directions.

.IP CURLPAUSE_CONT

.SH RETURN VALUE

CURLE_OK (0) means everything was ok, non-zero means an error occurred as

.I <curl/curl.h>

defines - see \fIlibcurl-errors(3)\fP. If the \fBCURLOPT_ERRORBUFFER\fP was

defines - see \fIlibcurl-errors(3)\fP. If the \fBCURLOPT_ERRORBUFFER(3)\fP was

set with \fIcurl_easy_setopt(3)\fP there will be a readable error message in

the error buffer when non-zero is returned.

.SH "SEE ALSO"

.\" *                            | (__| |_| |  _ <| |___

.\" *                             \___|\___/|_| \_\_____|

.\" *

.\" * Copyright (C) 1998 - 2013, Daniel Stenberg, <daniel@haxx.se>, et al.

.\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.

.\" *

.\" * This software is licensed as described in the file COPYING, which

.\" * you should have received as part of this distribution. The terms

buffer. The variable \fBn\fP points to will receive the number of received

bytes.

To establish the connection, set \fBCURLOPT_CONNECT_ONLY\fP option before

To establish the connection, set \fBCURLOPT_CONNECT_ONLY(3)\fP option before

calling \fIcurl_easy_perform(3)\fP. Note that \fIcurl_easy_recv(3)\fP does not

work on connections that were created without this option.

.\" *                            | (__| |_| |  _ <| |___

.\" *                             \___|\___/|_| \_\_____|

.\" *

.\" * Copyright (C) 1998 - 2013, Daniel Stenberg, <daniel@haxx.se>, et al.

.\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.

.\" *

.\" * This software is licensed as described in the file COPYING, which

.\" * you should have received as part of this distribution. The terms

\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.

To establish the connection, set \fBCURLOPT_CONNECT_ONLY\fP option before

To establish the connection, set \fBCURLOPT_CONNECT_ONLY(3)\fP option before

calling \fIcurl_easy_perform(3)\fP. Note that \fIcurl_easy_send(3)\fP will not

work on connections that were created without this option.