Class
GioCredentials
since: 2.26
Description
final class Gio.Credentials : GObject.Object
{
/* No available fields */
}The GCredentials type is a reference-counted wrapper for native
credentials. This information is typically used for identifying,
authenticating and authorizing other processes.
Some operating systems supports looking up the credentials of the remote peer of a communication endpoint - see e.g. g_socket_get_credentials().
Some operating systems supports securely sending and receiving
credentials over a Unix Domain Socket, see
GUnixCredentialsMessage, g_unix_connection_send_credentials() and
g_unix_connection_receive_credentials() for details.
On Linux, the native credential type is a struct ucred - see the
unix(7) man page for details. This corresponds to
G_CREDENTIALS_TYPE_LINUX_UCRED.
On Apple operating systems (including iOS, tvOS, and macOS),
the native credential type is a struct xucred.
This corresponds to G_CREDENTIALS_TYPE_APPLE_XUCRED.
On FreeBSD, Debian GNU/kFreeBSD, and GNU/Hurd, the native
credential type is a struct cmsgcred. This corresponds
to G_CREDENTIALS_TYPE_FREEBSD_CMSGCRED.
On NetBSD, the native credential type is a struct unpcbid.
This corresponds to G_CREDENTIALS_TYPE_NETBSD_UNPCBID.
On OpenBSD, the native credential type is a struct sockpeercred.
This corresponds to G_CREDENTIALS_TYPE_OPENBSD_SOCKPEERCRED.
On Solaris (including OpenSolaris and its derivatives), the native
credential type is a ucred_t. This corresponds to
G_CREDENTIALS_TYPE_SOLARIS_UCRED.
Since GLib 2.72, on Windows, the native credentials may contain the PID of a
process. This corresponds to G_CREDENTIALS_TYPE_WIN32_PID.
Available since: 2.26
Constructors
g_credentials_new
Creates a new GCredentials object with credentials matching the
the current process.
since: 2.26
Instance methods
g_credentials_get_native
Gets a pointer to native credentials of type native_type from
credentials.
since: 2.26
g_credentials_get_unix_pid
Tries to get the UNIX process identifier from credentials. This
method is only available on UNIX platforms.
since: 2.36
g_credentials_get_unix_user
Tries to get the UNIX user identifier from credentials. This
method is only available on UNIX platforms.
since: 2.26
g_credentials_is_same_user
Checks if credentials and other_credentials is the same user.
since: 2.26
g_credentials_set_native
Copies the native credentials of type native_type from native
into credentials.
since: 2.26
g_credentials_set_unix_user
Tries to set the UNIX user identifier on credentials. This method
is only available on UNIX platforms.
since: 2.26
g_credentials_to_string
Creates a human-readable textual representation of credentials
that can be used in logging and debug messages. The format of the
returned string may change in future GLib release.
since: 2.26
Signals
Signals inherited from GObject (1)
GObject::notify
The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.