table of contents
- bookworm 7.88.1-10+deb12u8
- bookworm-backports 8.12.1-3~bpo12+1
- testing 8.12.1-3
- unstable 8.12.1-3
CURLINFO_PRIMARY_PORT(3) | Library Functions Manual | CURLINFO_PRIMARY_PORT(3) |
NAME¶
CURLINFO_PRIMARY_PORT - get the latest destination port number
SYNOPSIS¶
#include <curl/curl.h> CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_PRIMARY_PORT, long *portp);
DESCRIPTION¶
Pass a pointer to a long to receive the destination port of the most recent connection done with this curl handle.
This is the destination port of the actual TCP or UDP connection libcurl used. If a proxy was used for the most recent transfer, this is the port number of the proxy, if no proxy was used it is the port number of the most recently accessed URL.
PROTOCOLS¶
This functionality affects all supported protocols
EXAMPLE¶
int main(void) {
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
res = curl_easy_perform(curl);
if(res == CURLE_OK) {
long port;
res = curl_easy_getinfo(curl, CURLINFO_PRIMARY_PORT, &port);
if(!res)
printf("Connected to remote port: %ld\n", port);
}
curl_easy_cleanup(curl);
} }
AVAILABILITY¶
Added in curl 7.21.0
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).
SEE ALSO¶
CURLINFO_LOCAL_PORT(3), CURLINFO_PRIMARY_IP(3), curl_easy_getinfo(3), curl_easy_setopt(3)
2025-02-25 | libcurl |