comparison mupdf-source/thirdparty/curl/docs/libcurl/opts/CURLMOPT_SOCKETDATA.3 @ 2:b50eed0cc0ef upstream

ADD: MuPDF v1.26.7: the MuPDF source as downloaded by a default build of PyMuPDF 1.26.4. The directory name has changed: no version number in the expanded directory now.
author Franz Glasner <fzglas.hg@dom66.de>
date Mon, 15 Sep 2025 11:43:07 +0200
parents
children
comparison
equal deleted inserted replaced
1:1d09e1dec1d9 2:b50eed0cc0ef
1 .\" **************************************************************************
2 .\" * _ _ ____ _
3 .\" * Project ___| | | | _ \| |
4 .\" * / __| | | | |_) | |
5 .\" * | (__| |_| | _ <| |___
6 .\" * \___|\___/|_| \_\_____|
7 .\" *
8 .\" * Copyright (C) 1998 - 2017, Daniel Stenberg, <daniel@haxx.se>, et al.
9 .\" *
10 .\" * This software is licensed as described in the file COPYING, which
11 .\" * you should have received as part of this distribution. The terms
12 .\" * are also available at https://curl.haxx.se/docs/copyright.html.
13 .\" *
14 .\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
15 .\" * copies of the Software, and permit persons to whom the Software is
16 .\" * furnished to do so, under the terms of the COPYING file.
17 .\" *
18 .\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
19 .\" * KIND, either express or implied.
20 .\" *
21 .\" **************************************************************************
22 .\"
23 .TH CURLMOPT_SOCKETDATA 3 "3 Nov 2014" "libcurl 7.39.0" "curl_multi_setopt options"
24 .SH NAME
25 CURLMOPT_SOCKETDATA \- custom pointer passed to the socket callback
26 .SH SYNOPSIS
27 .nf
28 #include <curl/curl.h>
29
30 CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_SOCKETDATA, void *pointer);
31 .SH DESCRIPTION
32 A data \fIpointer\fP to pass to the socket callback set with the
33 \fICURLMOPT_SOCKETFUNCTION(3)\fP option.
34
35 This pointer will not be touched by libcurl but will only be passed in to the
36 socket callbacks's \fBuserp\fP argument.
37 .SH DEFAULT
38 NULL
39 .SH PROTOCOLS
40 All
41 .SH EXAMPLE
42 .nf
43 static int sock_cb(CURL *e, curl_socket_t s, int what, void *cbp, void *sockp)
44 {
45 GlobalInfo *g = (GlobalInfo*) cbp;
46 SockInfo *fdp = (SockInfo*) sockp;
47
48 if(what == CURL_POLL_REMOVE) {
49 remsock(fdp);
50 }
51 else {
52 if(!fdp) {
53 addsock(s, e, what, g);
54 }
55 else {
56 setsock(fdp, s, e, what, g);
57 }
58 }
59 return 0;
60 }
61
62 main()
63 {
64 GlobalInfo setup;
65 /* ... use socket callback and custom pointer */
66 curl_multi_setopt(multi, CURLMOPT_SOCKETFUNCTION, sock_cb);
67 curl_multi_setopt(multi, CURLMOPT_SOCKETDATA, &setup);
68 }
69 .fi
70 .SH AVAILABILITY
71 Added in 7.15.4
72 .SH RETURN VALUE
73 Returns CURLM_OK.
74 .SH "SEE ALSO"
75 .BR CURLMOPT_SOCKETFUNCTION "(3), " curl_multi_socket_action "(3), "
76 .BR CURLMOPT_TIMERFUNCTION "(3) "