XfceSystemd: libxfce4util Reference Manual

XfceSystemd

XfceSystemd — Session management via systemd

Functions

XfceSystemd *	xfce_systemd_get ()
gboolean	xfce_systemd_reboot ()
gboolean	xfce_systemd_power_off ()
gboolean	xfce_systemd_suspend ()
gboolean	xfce_systemd_hibernate ()
gboolean	xfce_systemd_hybrid_sleep ()
gboolean	xfce_systemd_can_reboot ()
gboolean	xfce_systemd_can_power_off ()
gboolean	xfce_systemd_can_suspend ()
gboolean	xfce_systemd_can_hibernate ()
gboolean	xfce_systemd_can_hybrid_sleep ()

Types and Values

XfceSystemd

Object Hierarchy

    GObject
    ╰── XfceSystemd

Includes

#include <libxfce4util/libxfce4util.h>

Description

Functions

xfce_systemd_get ()

XfceSystemd *
xfce_systemd_get (void);

Create a new XfceSystemd instance or increase reference count.

Returns

A reference to the singleton object, to be released with g_object_unref().

[transfer full]

Since: 4.19.1

xfce_systemd_reboot ()

gboolean
xfce_systemd_reboot (XfceSystemd *systemd,
                     gboolean polkit_interactive,
                     GError **error);

Ask systemd to trigger Reboot.

Parameters

systemd	the XfceSystemd object
polkit_interactive	whether PolicyKit should ask the user to authenticate if needed
error	location to store error on failure or `NULL`.	[out][nullable]

Returns

TRUE if the D-Bus request was successful, FALSE otherwise and error is set.

Since: 4.19.1

xfce_systemd_power_off ()

gboolean
xfce_systemd_power_off (XfceSystemd *systemd,
                        gboolean polkit_interactive,
                        GError **error);

Ask systemd to trigger PowerOff.

Parameters

systemd	the XfceSystemd object
polkit_interactive	whether PolicyKit should ask the user to authenticate if needed
error	location to store error on failure or `NULL`.	[out][nullable]

Returns

TRUE if the D-Bus request was successful, FALSE otherwise and error is set.

Since: 4.19.1

xfce_systemd_suspend ()

gboolean
xfce_systemd_suspend (XfceSystemd *systemd,
                      gboolean polkit_interactive,
                      GError **error);

Ask systemd to trigger Suspend.

Parameters

systemd	the XfceSystemd object
polkit_interactive	whether PolicyKit should ask the user to authenticate if needed
error	location to store error on failure or `NULL`.	[out][nullable]

Returns

TRUE if the D-Bus request was successful, FALSE otherwise and error is set.

Since: 4.19.1

xfce_systemd_hibernate ()

gboolean
xfce_systemd_hibernate (XfceSystemd *systemd,
                        gboolean polkit_interactive,
                        GError **error);

Ask systemd to trigger Hibernate.

Parameters

systemd	the XfceSystemd object
polkit_interactive	whether PolicyKit should ask the user to authenticate if needed
error	location to store error on failure or `NULL`.	[out][nullable]

Returns

TRUE if the D-Bus request was successful, FALSE otherwise and error is set.

Since: 4.19.1

xfce_systemd_hybrid_sleep ()

gboolean
xfce_systemd_hybrid_sleep (XfceSystemd *systemd,
                           gboolean polkit_interactive,
                           GError **error);

Ask systemd to trigger HybridSleep.

Parameters

systemd	the XfceSystemd object
polkit_interactive	whether PolicyKit should ask the user to authenticate if needed
error	location to store error on failure or `NULL`.	[out][nullable]

Returns

TRUE if the D-Bus request was successful, FALSE otherwise and error is set.

Since: 4.19.1

xfce_systemd_can_reboot ()

gboolean
xfce_systemd_can_reboot (XfceSystemd *systemd,
                         gboolean *can_reboot,
                         gboolean *auth_reboot,
                         GError **error);

Check whether systemd can trigger Reboot.

Parameters

systemd	the XfceSystemd object
can_reboot	location to store capacity or `NULL`.	[out][nullable]
auth_reboot	location to store authorization or `NULL`.	[out][nullable]
error	location to store error on failure or `NULL`.	[out][nullable]

Returns

TRUE if the D-Bus request was successful, FALSE otherwise and error is set.

Since: 4.19.1

xfce_systemd_can_power_off ()

gboolean
xfce_systemd_can_power_off (XfceSystemd *systemd,
                            gboolean *can_power_off,
                            gboolean *auth_power_off,
                            GError **error);

Check whether systemd can trigger PowerOff.

Parameters

systemd	the XfceSystemd object
can_power_off	location to store capacity or `NULL`.	[out][nullable]
auth_power_off	location to store authorization or `NULL`.	[out][nullable]
error	location to store error on failure or `NULL`.	[out][nullable]

Returns

TRUE if the D-Bus request was successful, FALSE otherwise and error is set.

Since: 4.19.1

xfce_systemd_can_suspend ()

gboolean
xfce_systemd_can_suspend (XfceSystemd *systemd,
                          gboolean *can_suspend,
                          gboolean *auth_suspend,
                          GError **error);

Check whether systemd can trigger and has authorization for Suspend.

Parameters

systemd	the XfceSystemd object
can_suspend	location to store capacity or `NULL`.	[out][nullable]
auth_suspend	location to store authorization or `NULL`.	[out][nullable]
error	location to store error on failure or `NULL`.	[out][nullable]

Returns

TRUE if the D-Bus request was successful, FALSE otherwise and error is set.

Since: 4.19.1

xfce_systemd_can_hibernate ()

gboolean
xfce_systemd_can_hibernate (XfceSystemd *systemd,
                            gboolean *can_hibernate,
                            gboolean *auth_hibernate,
                            GError **error);

Check whether systemd can trigger and has authorization for Hibernate.

Parameters

systemd	the XfceSystemd object
can_hibernate	location to store capacity or `NULL`.	[out][nullable]
auth_hibernate	location to store authorization or `NULL`.	[out][nullable]
error	location to store error on failure or `NULL`.	[out][nullable]

Returns

TRUE if the D-Bus request was successful, FALSE otherwise and error is set.

Since: 4.19.1

xfce_systemd_can_hybrid_sleep ()

gboolean
xfce_systemd_can_hybrid_sleep (XfceSystemd *systemd,
                               gboolean *can_hybrid_sleep,
                               gboolean *auth_hybrid_sleep,
                               GError **error);

Check whether systemd can trigger and has authorization for HybridSleep.

Parameters

systemd	the XfceSystemd object
can_hybrid_sleep	location to store capacity or `NULL`.	[out][nullable]
auth_hybrid_sleep	location to store authorization or `NULL`.	[out][nullable]
error	location to store error on failure or `NULL`.	[out][nullable]

Returns

TRUE if the D-Bus request was successful, FALSE otherwise and error is set.

Since: 4.19.1

Types and Values

XfceSystemd

typedef struct _XfceSystemd XfceSystemd;