UnixCredentialsMessage#

Added in version 2.26.

class UnixCredentialsMessage(**properties: Any)#

Superclasses: SocketControlMessage, Object

This SocketControlMessage contains a Credentials instance. It may be sent using send_message and received using 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 send_credentials and receive_credentials. To receive credentials of a foreign process connected to a socket, use 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.

Constructors#

class UnixCredentialsMessage
classmethod new() SocketControlMessage#

Creates a new UnixCredentialsMessage with credentials matching the current processes.

Added in version 2.26.

classmethod new_with_credentials(credentials: Credentials) SocketControlMessage#

Creates a new UnixCredentialsMessage holding credentials.

Added in version 2.26.

Parameters:

credentials – A Credentials object.

Methods#

class UnixCredentialsMessage
get_credentials() Credentials#

Gets the credentials stored in message.

Added in version 2.26.

is_supported() bool#

Checks if passing Credentials on a Socket is supported on this platform.

Added in version 2.26.

Properties#

class UnixCredentialsMessage
props.credentials: Credentials#

The type of the None singleton.

Added in version 2.26.

Fields#

class UnixCredentialsMessage
parent_instance#
priv#