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 re-
cent 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)
libcurl 2026-07-12 CURLINFO_PRIMARY_PORT(3)
Generated by dwww version 1.16 on Sat Oct 3 05:20:01 CEST 2026.