GNURLINFO_PRIMARY_IP(3)

💅 GNURLINFO_PRIMARY_IP(3) 💅

okay so welcome to the curl_easy_getinfo options corner of the manual, bestie — this page is all about GNURLINFO_PRIMARY_IP(3) and it's lowkey iconic. vibe check: passed.

---

🌸 NAME 🌸

CURLINFO_PRIMARY_IP — get IP address of last connection. that's the name section, short and slay.

✨ SYNOPSIS ✨

include the header, call the function, and the vibes are literally:

#include <gnurl/curl.h>

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

🦋 DESCRIPTION 🦋

okay bestie, here's the tea: you pass a pointer to a char pointer to receive the pointer to a null-terminated string holding the IP address of the most recent connection done with this curl handle. this string may be IPv6 when that is enabled.

note that you get a pointer to a memory area that will be re-used at next request so you need to copy the string if you want to keep the information. highkey important, fr fr.

⚠️ important, bestie: the ip pointer will be NULL or pointing to private memory you MUST NOT free — it gets freed when you call curl_easy_cleanup(3) on the corresponding CURL handle. do not do it.

🌈 PROTOCOLS 🌈

All network based ones — every network-based protocol, periodt.

🎀 EXAMPLE 🎀

here's the example, and yes, copy it exactly — no creative rewrites, bestie:

{
  char *ip;

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

  /* Perform the request, res will get the return code */
  res = curl_easy_perform(curl);
  /* Check for errors */
  if((res == CURLE_OK) &&
     !curl_easy_getinfo(curl, CURLINFO_PRIMARY_IP, &ip) && ip) {
    printf("IP: %s\n", ip);
  }

  /* always cleanup */
  curl_easy_cleanup(curl);
}

⭐ AVAILABILITY ⭐

Added in 7.19.0 — vintage but still iconic.

💜 RETURN VALUE 💜

Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. that's it, no cap.

🔥 SEE ALSO 🔥

go check out these besties: curl_easy_getinfo(3), curl_easy_setopt(3), CURLINFO_PRIMARY_PORT(3), CURLINFO_LOCAL_IP(3), <-- yes, the original list had a lil trailing comma, so iconic.

---

xoxo, your Unix bestie 💖 this is GNURLINFO_PRIMARY_IP(3) from libcurl 7.44.0, dated 12 Sep 2015 — mwah 💋