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 credentials stored in the message.

Added in version 2.26.

Fields

class UnixCredentialsMessage

parent_instance

priv