generic-library/curl
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

changed wording slightly, and added standard boiler-plate header

Browse Source
This commit is contained in:
Daniel Stenberg 2006-06-26 06:43:45 +00:00
parent eb6d404753
commit 01f5f0be5a
1 changed files with 26 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
docs/libcurl/libcurl-multi.3
View File

@ -1,6 +1,25 @@
.\" You can view this file with: .\" **************************************************************************
.\" nroff -man [file] .\" * _ _ ____ _
.\" $Id$ .\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) 1998 - 2006, 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
.\" * are also available at http://curl.haxx.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * $Id$
.\" **************************************************************************
.\" .\"
.TH libcurl-multi 3 "13 Oct 2001" "libcurl 7.10.1" "libcurl multi interface" .TH libcurl-multi 3 "13 Oct 2001" "libcurl 7.10.1" "libcurl multi interface"
.SH NAME .SH NAME
@ -14,8 +33,8 @@ for an overview of the libcurl easy interface.
All functions in the multi interface are prefixed with curl_multi. All functions in the multi interface are prefixed with curl_multi.
.SH "OBJECTIVES" .SH "OBJECTIVES"
The multi interface introduces several new abilities that the easy interface The multi interface offers several abilities that the easy interface doesn't.
refuses to offer. They are mainly: They are mainly:
1. Enable a "pull" interface. The application that uses libcurl decides where 1. Enable a "pull" interface. The application that uses libcurl decides where
and when to ask libcurl to get/send data. and when to ask libcurl to get/send data.
@ -23,8 +42,8 @@ and when to ask libcurl to get/send data.
2. Enable multiple simultaneous transfers in the same thread without making it 2. Enable multiple simultaneous transfers in the same thread without making it
complicated for the application. complicated for the application.
3. Enable the application to select() on its own file descriptors and curl's 3. Enable the application to wait for action on its own file descriptors and
file descriptors simultaneous easily. curl's file descriptors simultaneous easily.
.SH "ONE MULTI HANDLE MANY EASY HANDLES" .SH "ONE MULTI HANDLE MANY EASY HANDLES"
To use the multi interface, you must first create a 'multi handle' with To use the multi interface, you must first create a 'multi handle' with
\fIcurl_multi_init(3)\fP. This handle is then used as input to all further \fIcurl_multi_init(3)\fP. This handle is then used as input to all further