Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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)

libcurl				  2025-06-03	      CURLINFO_PRIMARY_PORT(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=CURLINFO_PRIMARY_PORT&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help