Top |
This GSocketControlMessage contains a GCredentials instance. It
may be sent using g_socket_send_message()
and received using
g_socket_receive_message()
over UNIX sockets (ie: sockets in the
G_SOCKET_FAMILY_UNIX
family).
For an easier way to send and receive credentials over
stream-oriented UNIX sockets, see
g_unix_connection_send_credentials()
and
g_unix_connection_receive_credentials()
. To receive credentials of
a foreign process connected to a socket, use
g_socket_get_credentials()
.
Since GLib 2.72, GUnixCredentialMessage is available on all platforms. It
requires underlying system support (such as Windows 10 with AF_UNIX
) at run
time.
Before GLib 2.72, <gio/gunixcredentialsmessage.h>
belonged to the UNIX-specific
GIO interfaces, thus you had to use the gio-unix-2.0.pc
pkg-config file
when using it. This is no longer necessary since GLib 2.72.
GSocketControlMessage *
g_unix_credentials_message_new (void
);
Creates a new GUnixCredentialsMessage with credentials matching the current processes.
Since: 2.26
GSocketControlMessage *
g_unix_credentials_message_new_with_credentials
(GCredentials *credentials
);
Creates a new GUnixCredentialsMessage holding credentials
.
Since: 2.26
GCredentials *
g_unix_credentials_message_get_credentials
(GUnixCredentialsMessage *message
);
Gets the credentials stored in message
.
Since: 2.26
gboolean
g_unix_credentials_message_is_supported
(void
);
Checks if passing GCredentials on a GSocket is supported on this platform.
Since: 2.26
typedef struct _GUnixCredentialsMessage GUnixCredentialsMessage;
The GUnixCredentialsMessage structure contains only private data and should only be accessed using the provided API.
Since: 2.26
struct GUnixCredentialsMessageClass { GSocketControlMessageClass parent_class; };
Class structure for GUnixCredentialsMessage.
Since: 2.26
“credentials”
property“credentials” GCredentials *
The credentials stored in the message.
Owner: GUnixCredentialsMessage
Flags: Read / Write / Construct Only
Since: 2.26