Credentials

Credentials

Object Hierarchy:

Description:

public class Credentials : Object

The Credentials 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. 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 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.

Namespace: GLib

Package: gio-2.0

Content:

Creation methods:

public Credentials ()
Creates a new Credentials object with credentials matching the the current process.

Methods:

public void* get_native (CredentialsType native_type)
Gets a pointer to native credentials of type native_type from this.
public int get_unix_pid () throws Error
Tries to get the UNIX process identifier from this.
public uint get_unix_user () throws Error
Tries to get the UNIX user identifier from this.
public bool is_same_user (Credentials other_credentials) throws Error
Checks if this and other_credentials is the same user.
public void set_native (CredentialsType native_type, void* native)
Copies the native credentials of type native_type from native into this.
public bool set_unix_user (uint uid) throws Error
Tries to set the UNIX user identifier on this.
public string to_string ()
Creates a human-readable textual representation of this that can be used in logging and debug messages.

Inherited Members:

All known members inherited from class GLib.Object