Tiny Login Manager Reference Manual: Errors

Functions

#define	TLM_ERROR
#define	TLM_GET_ERROR_FOR_ID()
GQuark	tlm_error_quark ()
GError *	tlm_error_new_from_variant ()
GVariant *	tlm_error_to_variant ()

Types and Values

enum

TlmError

Object Hierarchy

Description

This file provides Tlm error definitions and utilities. When creating an error, use TLM_ERROR for the error domain and errors from TlmError for the error code.

    GError* err = g_error_new(TLM_ERROR, TLM_ERROR_INVALID_INPUT,
    "Invalid input");

Functions

TLM_ERROR

#define TLM_ERROR   (tlm_error_quark())

This macro should be used when creating a GError (for example with g_error_new()).

TLM_GET_ERROR_FOR_ID()

#define             TLM_GET_ERROR_FOR_ID(code, message, args...)

A helper macro that creates a GError with the proper tlm domain

Parameters

code	A TlmError specifying the error
message	Format string for the error message
...	parameters for the error string

tlm_error_quark ()

GQuark
tlm_error_quark (void);

Creates and returns a domain for Tlm errors.

Returns

GQuark for Tlm errors

tlm_error_new_from_variant ()

GError *
tlm_error_new_from_variant (GVariant *var);

Converts the GVariant to GError.

Parameters

var

instance of GVariant.

[transfer none]

Returns

GError object if successful, NULL otherwise.

[transfer full]

tlm_error_to_variant ()

GVariant *
tlm_error_to_variant (GError *error);

Converts the GError to GVariant.

Parameters

error

instance of GError.

[transfer none]

Returns

(transfer full) GVariant object if successful, NULL otherwise.

Types and Values

enum TlmError

This enumeration provides a list of errors

Members

TLM_ERROR_NONE	No error
TLM_ERROR_UNKNOWN	Catch-all for errors not distinguished by another error code
TLM_ERROR_INTERNAL_SERVER	Server internal error
TLM_ERROR_PERMISSION_DENIED	Permission denied
TLM_ERROR_INVALID_INPUT	Invalid input
TLM_ERROR_SEAT_NOT_FOUND	Seat not found
TLM_ERROR_SESSION_CREATION_FAILURE	Session creation failed
TLM_ERROR_SESSION_ALREADY_EXISTS	Session already exists
TLM_ERROR_SESSION_NOT_VALID	session is not valid anymore
TLM_ERROR_SESSION_TERMINATION_FAILURE	Session termination failed
TLM_ERROR_DBUS_SERVER_START_FAILURE	dbus-server startup failed
TLM_ERROR_PAM_AUTH_FAILURE	PAM authentication failed
TLM_ERROR_DBUS_REQ_ABORTED	Dbus request aborted
TLM_ERROR_DBUS_REQ_NOT_SUPPORTED	Dbus request not supported
TLM_ERROR_DBUS_REQ_UNKNOWN	Dbus request failed with unknown error
TLM_ERROR_LAST_ERR	Placeholder to rearrange enumeration