up-client

up-client — Main client object for accessing the UPower daemon

Synopsis

#define             UP_CLIENT_ERROR
#define             UP_CLIENT_TYPE_ERROR
                    UpClientPrivate;
void                device_added                        (UpClient *client,
                                                         UpDevice *device);
void                device_changed                      (UpClient *client,
                                                         UpDevice *device);
void                device_removed                      (UpClient *client,
                                                         UpDevice *device);
void                changed                             (UpClient *client);
UpClient *          up_client_new                       (void);
gboolean            up_client_get_properties_sync       (UpClient *client,
                                                         GCancellable *cancellable,
                                                         GError **error);
gboolean            up_client_enumerate_devices_sync    (UpClient *client,
                                                         GCancellable *cancellable,
                                                         GError **error);
gboolean            up_client_suspend_sync              (UpClient *client,
                                                         GCancellable *cancellable,
                                                         GError **error);
gboolean            up_client_about_to_sleep_sync       (UpClient *client,
                                                         GCancellable *cancellable,
                                                         GError **error);
gboolean            up_client_hibernate_sync            (UpClient *client,
                                                         GCancellable *cancellable,
                                                         GError **error);
GPtrArray *         up_client_get_devices               (UpClient *client);
const gchar *       up_client_get_daemon_version        (UpClient *client);
gboolean            up_client_get_can_hibernate         (UpClient *client);
gboolean            up_client_get_lid_is_closed         (UpClient *client);
gboolean            up_client_get_can_suspend           (UpClient *client);
gboolean            up_client_get_on_battery            (UpClient *client);
gboolean            up_client_get_on_low_battery        (UpClient *client);

Description

A helper GObject to use for accessing UPower information, and to be notified when it is changed.

See also: UpDevice

Details

UP_CLIENT_ERROR

#define UP_CLIENT_ERROR			(up_client_error_quark ())

UP_CLIENT_TYPE_ERROR

#define UP_CLIENT_TYPE_ERROR		(up_client_error_get_type ())

UpClientPrivate

typedef struct _UpClientPrivate UpClientPrivate;

Private UpClient data


device_added ()

void                device_added                        (UpClient *client,
                                                         UpDevice *device);

device_changed ()

void                device_changed                      (UpClient *client,
                                                         UpDevice *device);

device_removed ()

void                device_removed                      (UpClient *client,
                                                         UpDevice *device);

changed ()

void                changed                             (UpClient *client);

up_client_new ()

UpClient *          up_client_new                       (void);

Creates a new UpClient object.

Returns :

a new UpClient object.

Since 0.9.0


up_client_get_properties_sync ()

gboolean            up_client_get_properties_sync       (UpClient *client,
                                                         GCancellable *cancellable,
                                                         GError **error);

Get all the properties from UPower daemon.

client :

a UpClient instance.

cancellable :

a GCancellable or NULL

error :

a GError, or NULL.

Returns :

TRUE for success, else FALSE.

Since 0.9.0


up_client_enumerate_devices_sync ()

gboolean            up_client_enumerate_devices_sync    (UpClient *client,
                                                         GCancellable *cancellable,
                                                         GError **error);

Enumerates all the devices from the daemon.

client :

a UpClient instance.

error :

a GError, or NULL.

Returns :

TRUE for success, else FALSE.

Since 0.9.0


up_client_suspend_sync ()

gboolean            up_client_suspend_sync              (UpClient *client,
                                                         GCancellable *cancellable,
                                                         GError **error);

Puts the computer into a low power state, but state is not preserved if the power is lost.

NOTE: The system is still consuming a small amount of power

client :

a UpClient instance.

cancellable :

a GCancellable or NULL

error :

a GError, or NULL.

Returns :

TRUE if system suspended okay, FALSE other wise.

Since 0.9.0


up_client_about_to_sleep_sync ()

gboolean            up_client_about_to_sleep_sync       (UpClient *client,
                                                         GCancellable *cancellable,
                                                         GError **error);

Tells UPower that we are soon to reqest either Suspend() or Hibernate() and that session and system components should be notified of this.

client :

a UpClient instance.

cancellable :

a GCancellable or NULL

error :

a GError, or NULL.

Returns :

TRUE if system suspended okay, FALSE other wise.

Since 0.9.1


up_client_hibernate_sync ()

gboolean            up_client_hibernate_sync            (UpClient *client,
                                                         GCancellable *cancellable,
                                                         GError **error);

Puts the computer into a low power state, where state is preserved if the power is lost.

client :

a UpClient instance.

cancellable :

a GCancellable or NULL

error :

a GError.

Returns :

TRUE if system suspended okay, FALSE other wise.

Since 0.9.0


up_client_get_devices ()

GPtrArray *         up_client_get_devices               (UpClient *client);

Get a copy of the device objects.

client :

a UpClient instance.

Returns :

an array of UpDevice objects, free with g_ptr_array_unref()

Since 0.9.0


up_client_get_daemon_version ()

const gchar *       up_client_get_daemon_version        (UpClient *client);

Get UPower daemon version.

client :

a UpClient instance.

Returns :

string containing the daemon version, e.g. 008

Since 0.9.0


up_client_get_can_hibernate ()

gboolean            up_client_get_can_hibernate         (UpClient *client);

Get whether the system is able to hibernate.

client :

a UpClient instance.

Returns :

TRUE if system can hibernate, FALSE other wise.

Since 0.9.0


up_client_get_lid_is_closed ()

gboolean            up_client_get_lid_is_closed         (UpClient *client);

Get whether the laptop lid is closed.

client :

a UpClient instance.

Returns :

TRUE if lid is closed or FALSE otherwise.

up_client_get_can_suspend ()

gboolean            up_client_get_can_suspend           (UpClient *client);

Get whether the system is able to suspend.

client :

a UpClient instance.

Returns :

TRUE if system can suspend, FALSE other wise.

Since 0.9.0


up_client_get_on_battery ()

gboolean            up_client_get_on_battery            (UpClient *client);

Get whether the system is running on battery power.

client :

a UpClient instance.

Returns :

TRUE if the system is currently running on battery, FALSE other wise.

Since 0.9.0


up_client_get_on_low_battery ()

gboolean            up_client_get_on_low_battery        (UpClient *client);

Get whether the system is running on low battery power.

client :

a UpClient instance.

Returns :

TRUE if the system is currently on low battery power, FALSE other wise.

Since 0.9.0