CURLOPT_ABSTRACT_UNIX_SOCKET - abstract Unix domain socket
Contents
Availability
Added in curl 7.53.0
Default
NULL
Description
Enables the use of an abstract Unix domain socket instead of establishing a TCP connection to a host. The
parameter should be a char * to a null-terminated string holding the path of the socket. The path is set
to path prefixed by a NULL byte. This is the convention for abstract sockets, however it should be
stressed that the path passed to this function should not contain a leading NULL byte.
On non-supporting platforms, the abstract address is interpreted as an empty string and fails gracefully,
generating a runtime error.
This option shares the same semantics as CURLOPT_UNIX_SOCKET_PATH(3) in which documentation more details
can be found. Internally, these two options share the same storage and therefore only one of them can be
set per handle.
Example
int main(void)
{
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_ABSTRACT_UNIX_SOCKET, "/tmp/foo.sock");
curl_easy_setopt(curl, CURLOPT_URL, "http://localhost/");
/* Perform the request */
curl_easy_perform(curl);
}
}
Name
CURLOPT_ABSTRACT_UNIX_SOCKET - abstract Unix domain socket
Protocols
This functionality affects all supported protocols
Return Value
curl_easy_setopt(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
CURLOPT_UNIX_SOCKET_PATH(3), unix(7)
libcurl 2025-06-16 CURLOPT_ABSTRACT_UNIX_SOCKET(3)
Synopsis
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_ABSTRACT_UNIX_SOCKET,
char *path);
