CURLINFO_PRIMARY_PORT.md (1521B)
1 --- 2 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 3 SPDX-License-Identifier: curl 4 Title: CURLINFO_PRIMARY_PORT 5 Section: 3 6 Source: libcurl 7 See-also: 8 - CURLINFO_LOCAL_PORT (3) 9 - CURLINFO_PRIMARY_IP (3) 10 - curl_easy_getinfo (3) 11 - curl_easy_setopt (3) 12 Protocol: 13 - All 14 Added-in: 7.21.0 15 --- 16 17 # NAME 18 19 CURLINFO_PRIMARY_PORT - get the latest destination port number 20 21 # SYNOPSIS 22 23 ~~~c 24 #include <curl/curl.h> 25 26 CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_PRIMARY_PORT, long *portp); 27 ~~~ 28 29 # DESCRIPTION 30 31 Pass a pointer to a long to receive the destination port of the most recent 32 connection done with this **curl** handle. 33 34 This is the destination port of the actual TCP or UDP connection libcurl used. 35 If a proxy was used for the most recent transfer, this is the port number of 36 the proxy, if no proxy was used it is the port number of the most recently 37 accessed URL. 38 39 # %PROTOCOLS% 40 41 # EXAMPLE 42 43 ~~~c 44 int main(void) 45 { 46 CURL *curl = curl_easy_init(); 47 if(curl) { 48 CURLcode res; 49 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com"); 50 res = curl_easy_perform(curl); 51 if(res == CURLE_OK) { 52 long port; 53 res = curl_easy_getinfo(curl, CURLINFO_PRIMARY_PORT, &port); 54 if(!res) 55 printf("Connected to remote port: %ld\n", port); 56 } 57 curl_easy_cleanup(curl); 58 } 59 } 60 ~~~ 61 62 # %AVAILABILITY% 63 64 # RETURN VALUE 65 66 curl_easy_getinfo(3) returns a CURLcode indicating success or error. 67 68 CURLE_OK (0) means everything was OK, non-zero means an error occurred, see 69 libcurl-errors(3).