gi-gio-2.0.28: Gio bindings
CopyrightWill Thompson Iñaki García Etxebarria and Jonas Platte
LicenseLGPL-2.1
MaintainerIñaki García Etxebarria
Safe HaskellSafe-Inferred
LanguageHaskell2010

GI.Gio.Objects.UnixCredentialsMessage

Description

This SocketControlMessage contains a Credentials instance. It may be sent using socketSendMessage and received using socketReceiveMessage over UNIX sockets (ie: sockets in the SocketFamilyUnix family).

For an easier way to send and receive credentials over stream-oriented UNIX sockets, see unixConnectionSendCredentials and unixConnectionReceiveCredentials. To receive credentials of a foreign process connected to a socket, use socketGetCredentials.

Since: 2.26

Synopsis

Exported types

newtype UnixCredentialsMessage Source #

Memory-managed wrapper type.

class (GObject o, IsDescendantOf UnixCredentialsMessage o) => IsUnixCredentialsMessage o Source #

Type class for types which can be safely cast to UnixCredentialsMessage, for instance with toUnixCredentialsMessage.

Instances

Instances details
(GObject o, IsDescendantOf UnixCredentialsMessage o) => IsUnixCredentialsMessage o Source # 
Instance details

Defined in GI.Gio.Objects.UnixCredentialsMessage

toUnixCredentialsMessage :: (MonadIO m, IsUnixCredentialsMessage o) => o -> m UnixCredentialsMessage Source #

Cast to UnixCredentialsMessage, for types for which this is known to be safe. For general casts, use castTo.

Methods

getCredentials

unixCredentialsMessageGetCredentials Source #

Arguments

:: (HasCallStack, MonadIO m, IsUnixCredentialsMessage a) 
=> a

message: A UnixCredentialsMessage.

-> m Credentials

Returns: A Credentials instance. Do not free, it is owned by message.

Gets the credentials stored in message.

Since: 2.26

isSupported

unixCredentialsMessageIsSupported Source #

Arguments

:: (HasCallStack, MonadIO m) 
=> m Bool

Returns: True if supported, False otherwise

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

Since: 2.26

new

unixCredentialsMessageNew Source #

Creates a new UnixCredentialsMessage with credentials matching the current processes.

Since: 2.26

newWithCredentials

unixCredentialsMessageNewWithCredentials Source #

Arguments

:: (HasCallStack, MonadIO m, IsCredentials a) 
=> a

credentials: A Credentials object.

-> m UnixCredentialsMessage

Returns: a new UnixCredentialsMessage

Creates a new UnixCredentialsMessage holding credentials.

Since: 2.26

Properties

credentials

The credentials stored in the message.

Since: 2.26

constructUnixCredentialsMessageCredentials :: (IsUnixCredentialsMessage o, MonadIO m, IsCredentials a) => a -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “credentials” property. This is rarely needed directly, but it is used by new.

getUnixCredentialsMessageCredentials :: (MonadIO m, IsUnixCredentialsMessage o) => o -> m Credentials Source #

Get the value of the “credentials” property. When overloading is enabled, this is equivalent to

get unixCredentialsMessage #credentials