g_unix_socket_address_new ()

GSocketAddress *
g_unix_socket_address_new (const gchar *path);

Creates a new GUnixSocketAddress for path .

To create abstract socket addresses, on systems that support that, use g_unix_socket_address_new_abstract().

Since: 2.22

g_unix_socket_address_new_abstract ()

GSocketAddress *
g_unix_socket_address_new_abstract (const gchar *path,
                                    gint path_len);

Creates a new G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED GUnixSocketAddress for path .

g_unix_socket_address_new_with_type ()

GSocketAddress *
g_unix_socket_address_new_with_type (const gchar *path,
                                     gint path_len,
                                     GUnixSocketAddressType type);

Creates a new GUnixSocketAddress of type type with name path .

If type is G_UNIX_SOCKET_ADDRESS_PATH, this is equivalent to calling g_unix_socket_address_new().

If type is G_UNIX_SOCKET_ADDRESS_ANONYMOUS, path and path_len will be ignored.

If path_type is G_UNIX_SOCKET_ADDRESS_ABSTRACT, then path_len bytes of path will be copied to the socket's path, and only those bytes will be considered part of the name. (If path_len is -1, then path is assumed to be NUL-terminated.) For example, if path was "test", then calling g_socket_address_get_native_size() on the returned socket would return 7 (2 bytes of overhead, 1 byte for the abstract-socket indicator byte, and 4 bytes for the name "test").

If path_type is G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED, then path_len bytes of path will be copied to the socket's path, the rest of the path will be padded with 0 bytes, and the entire zero-padded buffer will be considered the name. (As above, if path_len is -1, then path is assumed to be NUL-terminated.) In this case, g_socket_address_get_native_size() will always return the full size of a struct sockaddr_un, although g_unix_socket_address_get_path_len() will still return just the length of path .

G_UNIX_SOCKET_ADDRESS_ABSTRACT is preferred over G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED for new programs. Of course, when connecting to a server created by another process, you must use the appropriate type corresponding to how that process created its listening socket.

Since: 2.26

g_unix_socket_address_get_is_abstract ()

gboolean
g_unix_socket_address_get_is_abstract (GUnixSocketAddress *address);

Tests if address is abstract.

Since: 2.22

g_unix_socket_address_get_address_type ()

GUnixSocketAddressType
g_unix_socket_address_get_address_type
                               (GUnixSocketAddress *address);

Gets address 's type.

Since: 2.26

g_unix_socket_address_get_path ()

const char *
g_unix_socket_address_get_path (GUnixSocketAddress *address);

Gets address 's path, or for abstract sockets the "name".

Guaranteed to be zero-terminated, but an abstract socket may contain embedded zeros, and thus you should use g_unix_socket_address_get_path_len() to get the true length of this string.

Since: 2.22

g_unix_socket_address_get_path_len ()

gsize
g_unix_socket_address_get_path_len (GUnixSocketAddress *address);

Gets the length of address 's path.

For details, see g_unix_socket_address_get_path().

Since: 2.22

g_unix_socket_address_abstract_names_supported ()

gboolean
g_unix_socket_address_abstract_names_supported
                               (void);

Checks if abstract UNIX domain socket names are supported.

Since: 2.22

struct GUnixSocketAddress

struct GUnixSocketAddress;

A UNIX-domain (local) socket address, corresponding to a struct sockaddr_un.

enum GUnixSocketAddressType

The type of name used by a GUnixSocketAddress. G_UNIX_SOCKET_ADDRESS_PATH indicates a traditional unix domain socket bound to a filesystem path. G_UNIX_SOCKET_ADDRESS_ANONYMOUS indicates a socket not bound to any name (eg, a client-side socket, or a socket created with socketpair()).

For abstract sockets, there are two incompatible ways of naming them; the man pages suggest using the entire struct sockaddr_un as the name, padding the unused parts of the sun_path field with zeroes; this corresponds to G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED. However, many programs instead just use a portion of sun_path, and pass an appropriate smaller length to bind() or connect(). This is G_UNIX_SOCKET_ADDRESS_ABSTRACT.

Since: 2.26

The “abstract” property

  “abstract”                 gboolean

Whether or not this is an abstract address

Flags: Read / Write / Construct Only

Default value: FALSE

The “address-type” property

  “address-type”             GUnixSocketAddressType

The type of UNIX socket address.

Flags: Read / Write / Construct Only

Default value: G_UNIX_SOCKET_ADDRESS_PATH

The “path” property

  “path”                     gchar *

UNIX socket path.

Flags: Read / Write / Construct Only

Default value: NULL

The “path-as-array” property

  “path-as-array”            GByteArray *

UNIX socket path, as byte array.

Flags: Read / Write / Construct Only