diff options
Diffstat (limited to 'docs/libcurl/opts/CURLINFO_ACTIVESOCKET.3')
-rw-r--r-- | docs/libcurl/opts/CURLINFO_ACTIVESOCKET.3 | 24 |
1 files changed, 13 insertions, 11 deletions
diff --git a/docs/libcurl/opts/CURLINFO_ACTIVESOCKET.3 b/docs/libcurl/opts/CURLINFO_ACTIVESOCKET.3 index f76c3746c..bd38d48c3 100644 --- a/docs/libcurl/opts/CURLINFO_ACTIVESOCKET.3 +++ b/docs/libcurl/opts/CURLINFO_ACTIVESOCKET.3 @@ -5,7 +5,7 @@ .\" * | (__| |_| | _ <| |___ .\" * \___|\___/|_| \_\_____| .\" * -.\" * Copyright (C) 1998 - 2017, Daniel Stenberg, <daniel@haxx.se>, et al. +.\" * Copyright (C) 1998 - 2020, 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 @@ -20,7 +20,7 @@ .\" * .\" ************************************************************************** .\" -.TH CURLINFO_ACTIVESOCKET 3 "May 06, 2017" "libcurl 7.67.0" "curl_easy_getinfo options" +.TH CURLINFO_ACTIVESOCKET 3 "September 16, 2020" "libcurl 7.73.0" "curl_easy_getinfo options" .SH NAME CURLINFO_ACTIVESOCKET \- get the active socket @@ -30,15 +30,17 @@ CURLINFO_ACTIVESOCKET \- get the active socket CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_ACTIVESOCKET, curl_socket_t *socket); .SH DESCRIPTION -Pass a pointer to a curl_socket_t to receive the active socket used by this -curl session. If the socket is no longer valid, \fICURL_SOCKET_BAD\fP is -returned. When you finish working with the socket, you must call -\fIcurl_easy_cleanup(3)\fP as usual on the easy handle and let libcurl close -the socket and cleanup other resources associated with the handle. This is -typically used in combination with \fICURLOPT_CONNECT_ONLY(3)\fP. +Pass a pointer to a curl_socket_t to receive the most recently active socket +used for the transfer connection by this curl session. If the socket is no +longer valid, \fICURL_SOCKET_BAD\fP is returned. When you are finished working +with the socket, you must call \fIcurl_easy_cleanup(3)\fP as usual on the easy +handle and let libcurl close the socket and cleanup other resources associated +with the handle. This option returns the active socket only after the transfer +is complete, and is typically used in combination with +\fICURLOPT_CONNECT_ONLY(3)\fP, which skips the transfer phase. -This option was added as a replacement for \fICURLINFO_LASTSOCKET(3)\fP since -that one isn't working on all platforms. +\fICURLINFO_ACTIVESOCKET(3)\fP was added as a replacement for +\fICURLINFO_LASTSOCKET(3)\fP since that one isn't working on all platforms. .SH PROTOCOLS All .SH EXAMPLE @@ -46,7 +48,7 @@ All CURL *curl = curl_easy_init(); if(curl) { curl_socket_t sockfd; - curl_easy_setopt(curl, CURLOPT_URL, "http://example.com"); + curl_easy_setopt(curl, CURLOPT_URL, "https://example.com"); /* Do not do the transfer - only connect to host */ curl_easy_setopt(curl, CURLOPT_CONNECT_ONLY, 1L); |