formatting update to produce better links with the new roffit version

.SH DESCRIPTION

This function must be the last function to call for an easy session. It is the

opposite of the \fIcurl_easy_init\fP function and must be called with the same

\fIhandle\fP as input that the curl_easy_init call returned.

opposite of the \fIcurl_easy_init(3)\fP function and must be called with the

same \fIhandle\fP as input that the curl_easy_init call returned.

This will effectively close all connections this handle has used and possibly

has kept open until now. Don't call this function if you intend to transfer

This function will return a new curl handle, a duplicate, using all the

options previously set in the input curl \fIhandle\fP. Both handles can

subsequently be used independently and they must both be freed with

\fIcurl_easy_cleanup()\fP.

\fIcurl_easy_cleanup(3)\fP.

All strings that the input handle has been told to point to (as opposed to

copy) with previous calls to \fIcurl_easy_setopt\fP using char * inputs, will

be pointed to by the new handle as well. You must therefore make sure to keep

the data around until both handles have been cleaned up.

copy) with previous calls to \fIcurl_easy_setopt(3)\fP using char * inputs,

will be pointed to by the new handle as well. You must therefore make sure to

keep the data around until both handles have been cleaned up.

The new handle will \fBnot\fP inherit any state information, no connections,

no SSL sessions and no cookies.

\fBNote\fP that even in multi-threaded programs, this function must be called

in a synchronous way, the input handle may not be in use when cloned.

This function was added in libcurl 7.9.

.SH RETURN VALUE

If this function returns NULL, something went wrong and no valid handle was

returned.

.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

curl_easy_setopt). (Added in 7.4.2)

\fIcurl_easy_setopt(3)\fP).

.IP CURLINFO_CONTENT_LENGTH_DOWNLOAD

Pass a pointer to a double to receive the content-length of the download. This

is the value read from the Content-Length: field.  (Added in 7.6.1)

is the value read from the Content-Length: field.

.IP CURLINFO_CONTENT_LENGTH_UPLOAD

Pass a pointer to a double to receive the specified size of the upload.

.IP CURLINFO_CONTENT_TYPE

Pass a pointer to a 'char *' to receive the content-type of the downloaded

object. This is the value read from the Content-Type: field. If you get NULL,

it means that the server didn't send a valid Content-Type header or that the

protocol used doesn't support this.  (Added in 7.9.4)

protocol used doesn't support this.

.IP CURLINFO_PRIVATE

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

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

curl_easy_setopt). (Added in 7.10.3)

\fIcurl_easy_setopt(3)\fP). (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 curl_easy_setopt.  (Added in 7.10.8)

CURLOPT_HTTPAUTH 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 athentication.  (Added in 7.10.8)

appropriate error code will be returned.

.SH "SEE ALSO"

.BR curl_easy_setopt "(3)"

.SH BUGS

Surely there are some, you tell me!

.SH DESCRIPTION

This function must be the first function to call, and it returns a CURL easy

handle that you must use as input to other easy-functions. curl_easy_init

intializes curl and this call MUST have a corresponding call to

\fIcurl_easy_cleanup\fP when the operation is complete.

intializes curl and this call \fBMUST\fP have a corresponding call to

\fIcurl_easy_cleanup(3)\fP when the operation is complete.

.SH RETURN VALUE

If this function returns NULL, something went wrong and you cannot use the

.SH SYNOPSIS

.B #include <curl/curl.h>

.sp

.BI "CURLcode curl_easy_perform(CURL *" handle ");

.BI "CURLcode curl_easy_perform(CURL *" handle ");"

.ad

.SH DESCRIPTION

This function is called after the init and all the curl_easy_setopt() calls

are made, and will perform the transfer as described in the options.

It must be called with the same

This function is called after the init and all the \fIcurl_easy_setopt(3)\fP

calls are made, and will perform the transfer as described in the options.  It

must be called with the same

.I handle

as input as the curl_easy_init call returned.

libcurl version 7.7 or later (for older versions see below): You can do any

amount of calls to curl_easy_perform() while using the same handle. If you

intend to transfer more than one file, you are even encouraged to do

so. libcurl will then attempt to re-use the same connection for the following

transfers, thus making the operations faster, less CPU intense and using less

network resources. Just note that you will have to use

.I curl_easy_setopt

between the invokes to set options for the following curl_easy_perform.

You can do any amount of calls to \fIcurl_easy_perform(3)\fP while using the

same handle. If you intend to transfer more than one file, you are even

encouraged to do so. libcurl will then attempt to re-use the same connection

for the following transfers, thus making the operations faster, less CPU

intense and using less network resources. Just note that you will have to use

\fIcurl_easy_setopt(3)\fP between the invokes to set options for the following

curl_easy_perform.

You must never call this function simultaneously from two places using the

same handle. Let the function return first before invoking it another time. If

you want parallel transfers, you must use several curl handles.

Before libcurl version 7.7: You are only allowed to call this function once

using the same handle. If you want to do repeated calls, you must call

curl_easy_cleanup and curl_easy_init again first.

.SH RETURN VALUE

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

.I <curl/curl.h>

returned.

.SH "SEE ALSO"

.BR curl_easy_init "(3), " curl_easy_setopt "(3), "

.SH BUGS

Surely there are some, you tell me!