Manual Pages for UNIX Operating System command usage for man curl_multi_assign

libcurl Manual                               curl_multi_assign(3)



NAME
     curl_multi_assign - set data to association with an internal
     socket

SYNOPSIS
     #include 

     CURLMcode       curl_multi_assign(CURLM       *multi_handle,
     curl_socket_t sockfd,
                                 void *sockptr);

DESCRIPTION
     This function assigns an association  in  the  multi  handle
     between the given socket and a private pointer of the appli-
     cation. This is (only) useful for curl_multi_socket(3) uses.

     When set, the sockptr pointer will be passed to  all  future
     socket callbacks for the specific sockfd socket.

     If the given sockfd isn't already in use  by  libcurl,  this
     function will return an error.

     libcurl only keeps one  single  pointer  associated  with  a
     socket,  so calling this function several times for the same
     socket will make the last set pointer get used.

     The idea here being that this association (socket to private
     pointer) is something that just about every application that
     uses this API will need and then libcurl can just as well do
     it  since  it  already has an internal hash table lookup for
     this.

RETURN VALUE
     The standard CURLMcode for multi interface error codes.

TYPICAL USAGE
     In a typical application you allocate a struct or  at  least
     use  some  kind of semi-dynamic data for each socket that we
     must wait for action on when using the  curl_multi_socket(3)
     approach.

     When our socket-callback gets called by libcurl and  we  get
     to  know  about  yet  another socket to wait for, we can use
     curl_multi_assign(3) to point out  the  particular  data  so
     that  when  we  get updates about this same socket again, we
     don't have to find the struct associated with this socket by
     ourselves.

AVAILABILITY
     This function was added  in  libcurl  7.15.5,  although  not
     deemed stable yet.




libcurl 7.16.0       Last change: 9 Jul 2006                    1






libcurl Manual                               curl_multi_assign(3)



SEE ALSO
     curl_multi_setopt(3), curl_multi_socket(3)

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     _______________________________________
    |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|
    |____________________|__________________|_
    | Availability       |  web/curl       |
    |____________________|__________________|_
    | Interface Stability|  Uncommitted    |
    |____________________|_________________|

NOTES
     Source for C-URL is available on http://opensolaris.org.






































libcurl 7.16.0       Last change: 9 Jul 2006                    2