mirror of
https://github.com/curl/curl.git
synced 2026-04-18 00:41:41 +03:00
2c6f13093e
Reduce mentions of libcurl versions like "since 7.xx ..." in option descriptions to reduce clutter and make the texts easier to read. Keep them in, or move them to, the HISTORY or DEPRECATED sections The last version 7 release (7.88.1) shipped on Februrary 20, 2023. Closes #20369
88 lines
2 KiB
Markdown
88 lines
2 KiB
Markdown
---
|
|
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
SPDX-License-Identifier: curl
|
|
Title: CURLINFO_LASTSOCKET
|
|
Section: 3
|
|
Source: libcurl
|
|
See-also:
|
|
- CURLINFO_ACTIVESOCKET (3)
|
|
- CURLOPT_CONNECT_ONLY (3)
|
|
- curl_easy_getinfo (3)
|
|
- curl_easy_setopt (3)
|
|
Protocol:
|
|
- All
|
|
Added-in: 7.15.2
|
|
---
|
|
|
|
# NAME
|
|
|
|
CURLINFO_LASTSOCKET - last socket used
|
|
|
|
# SYNOPSIS
|
|
|
|
~~~c
|
|
#include <curl/curl.h>
|
|
|
|
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_LASTSOCKET, long *socket);
|
|
~~~
|
|
|
|
# DESCRIPTION
|
|
|
|
Deprecated. Use CURLINFO_ACTIVESOCKET(3) instead.
|
|
|
|
Pass a pointer to a long to receive the last socket used by this curl
|
|
session. If the socket is no longer valid, -1 is returned. When you finish
|
|
working with the socket, you must call curl_easy_cleanup(3) as usual and
|
|
let libcurl close the socket and cleanup other resources associated with the
|
|
handle. This is typically used in combination with
|
|
CURLOPT_CONNECT_ONLY(3).
|
|
|
|
NOTE: this API is deprecated since it is not working on win64 where the SOCKET
|
|
type is 64 bits large while its 'long' is 32 bits. Use the
|
|
CURLINFO_ACTIVESOCKET(3) instead, if possible.
|
|
|
|
# %PROTOCOLS%
|
|
|
|
# EXAMPLE
|
|
|
|
~~~c
|
|
int main(void)
|
|
{
|
|
CURL *curl = curl_easy_init();
|
|
if(curl) {
|
|
CURLcode result;
|
|
long sockfd; /* does not work on win64 */
|
|
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);
|
|
result = curl_easy_perform(curl);
|
|
if(result != CURLE_OK) {
|
|
printf("Error: %s\n", curl_easy_strerror(result));
|
|
curl_easy_cleanup(curl);
|
|
return 1;
|
|
}
|
|
|
|
/* Extract the socket from the curl handle */
|
|
result = curl_easy_getinfo(curl, CURLINFO_LASTSOCKET, &sockfd);
|
|
if(!result && sockfd != -1) {
|
|
/* operate on sockfd */
|
|
}
|
|
|
|
curl_easy_cleanup(curl);
|
|
}
|
|
}
|
|
~~~
|
|
|
|
# DEPRECATED
|
|
|
|
Deprecated since 7.45.0.
|
|
|
|
# %AVAILABILITY%
|
|
|
|
# RETURN VALUE
|
|
|
|
curl_easy_getinfo(3) returns a CURLcode indicating success or error.
|
|
|
|
CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
|
|
libcurl-errors(3).
|