GNURLOPT_ABSTRACT_UNIX_SOCKET(3)

🦋 NAME 🦋

okay bestie, welcome to the GNURLOPT_ABSTRACT_UNIX_SOCKET(3) page from the curl_easy_setopt options crew — it's giving “set an abstract Unix domain socket” energy, and we're gonna get you through it 💅✨

CURLOPT_ABSTRACT_UNIX_SOCKET — set an abstract Unix domain socket.

---

🌸 SYNOPSIS 🌸

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_ABSTRACT_UNIX_SOCKET,
       char *path);

---

🎀 DESCRIPTION 🎀

So this option enables the use of an abstract Unix domain socket instead of establishing a TCP connection to a host. Slay, no cap.

The parameter should be a char * to a null-terminated string holding the path of the socket. The path will be set to path prefixed by a NULL byte — that's literally the convention for abstract sockets — however, it should be stressed that the path passed to this function should not contain a leading NULL. Like, do not do that, bestie 😭

On non-supporting platforms, the abstract address will be interpreted as an empty string and fail gracefully, generating a run-time error. It's giving “we tried, we failed, but we did it cutely” 💀

This option shares the same semantics as CURLOPT_UNIX_SOCKET_PATH(3) — the documentation over there has more details if you wanna dig in. Internally, these two options share the same storage and therefore only one of them can be set per handle. One handle, one socket-path situation. Periodt 🫶

---

✨ DEFAULT ✨

Default is NULL. Yep, nothing set by default, no abstract-socket vibes until you say so 🎀

---

🌈 EXAMPLE 🌈

curl_easy_setopt(curl_handle, CURLOPT_ABSTRACT_UNIX_SOCKET, "/tmp/foo.sock");
curl_easy_setopt(curl_handle, CURLOPT_URL, "http://localhost/");

---

⭐ AVAILABILITY ⭐

Since 7.53.0. Iconic behavior has been available since then, iykyk 💖

---

🔥 RETURN VALUE 🔥

Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. That's the whole mood — supported? slay. not supported? unknown option, sadly 💅

---

👑 SEE ALSO 👑

• CURLOPT_UNIX_SOCKET_PATH(3), unix(7),

---

kisses from the libcurl 7.53.0 era, dated 08 Jan 2017 — this was the GNURLOPT_ABSTRACT_UNIX_SOCKET(3) page, mwah 💋✨