Top |
Description
GSocketAddress is the equivalent of struct sockaddr in the BSD sockets API. This is an abstract class; use GInetSocketAddress for internet sockets, or GUnixSocketAddress for UNIX domain sockets.
Functions
g_socket_address_new_from_native ()
GSocketAddress * g_socket_address_new_from_native (gpointer native
,gsize len
);
Creates a GSocketAddress subclass corresponding to the native
struct sockaddr native
.
Parameters
native |
a pointer to a struct sockaddr |
|
len |
the size of the memory location pointed to by |
Since 2.22
g_socket_address_get_family ()
GSocketFamily
g_socket_address_get_family (GSocketAddress *address
);
Gets the socket family type of address
.
Since 2.22
g_socket_address_to_native ()
gboolean g_socket_address_to_native (GSocketAddress *address
,gpointer dest
,gsize destlen
,GError **error
);
Converts a GSocketAddress to a native struct sockaddr, which can
be passed to low-level functions like connect()
or bind()
.
If not enough space is available, a G_IO_ERROR_NO_SPACE
error
is returned. If the address type is not known on the system
then a G_IO_ERROR_NOT_SUPPORTED
error is returned.
Parameters
address |
||
dest |
a pointer to a memory location that will contain the native struct sockaddr |
|
destlen |
the size of |
|
error |
Since 2.22
g_socket_address_get_native_size ()
gssize
g_socket_address_get_native_size (GSocketAddress *address
);
Gets the size of address
's native struct sockaddr.
You can use this to allocate memory to pass to
g_socket_address_to_native()
.
Since 2.22
Types and Values
GSocketAddress
typedef struct _GSocketAddress GSocketAddress;
A socket endpoint address, corresponding to struct sockaddr or one of its subtypes.
enum GSocketFamily
The protocol family of a GSocketAddress. (These values are
identical to the system defines AF_INET
, AF_INET6
and AF_UNIX
,
if available.)
Since 2.22
Property Details
The “family”
property
“family” GSocketFamily
The family of the socket address.
Flags: Read
Default value: G_SOCKET_FAMILY_INVALID