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

FreeBSD Manual Pages

  
 
  

home | help
CURLINFO_LOCAL_IP(3)	    Library Functions Manual	    CURLINFO_LOCAL_IP(3)

NAME
     CURLINFO_LOCAL_IP - local IP address of last connection

SYNOPSIS
     #include <curl/curl.h>

     CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_LOCAL_IP, char **ip);

DESCRIPTION
     Pass  a  pointer  to a char pointer to receive the pointer to a null-termi-
     nated string holding the IP address of the local end of most recent connec-
     tion done with this curl handle. This string may be IPv6 when that  is  en-
     abled.  Note that you get a pointer to a memory area that is reused at next
     request so you need to copy the string if you want to keep the information.

     The ip pointer is NULL or points to private memory. You must not  free  it.
     The  memory  gets freed automatically when you call curl_easy_cleanup(3) on
     the corresponding curl handle.

PROTOCOLS
     This functionality affects quic and tcp

EXAMPLE
     int main(void)
     {
       char *ip;
       CURLcode result;
       CURL *curl = curl_easy_init();

       curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");

       /* Perform the transfer */
       result = curl_easy_perform(curl);
       /* Check for errors */
       if((result == CURLE_OK) &&
	  !curl_easy_getinfo(curl, CURLINFO_LOCAL_IP, &ip) && ip) {
	 printf("Local IP: %s\n", ip);
       }

       /* always cleanup */
       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-06-11		    CURLINFO_LOCAL_IP(3)

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

home | help