fwupd-error

fwupd-error — an error domain shared by the daemon and library

Synopsis

#define             FWUPD_ERROR
enum                FwupdError;
GQuark              fwupd_error_quark                   (void);
const gchar *       fwupd_error_to_string               (FwupdError error);
FwupdError          fwupd_error_from_string             (const gchar *error);

Description

This file also provides helper functions to map errors to strings and back again.

See also: fwupd-enums

Details

FWUPD_ERROR

#define FWUPD_ERROR			fwupd_error_quark()

enum FwupdError

typedef enum {
	FWUPD_ERROR_INTERNAL,			/* Since: 0.1.1 */
	FWUPD_ERROR_VERSION_NEWER,		/* Since: 0.1.1 */
	FWUPD_ERROR_VERSION_SAME,		/* Since: 0.1.1 */
	FWUPD_ERROR_ALREADY_PENDING,		/* Since: 0.1.1 */
	FWUPD_ERROR_AUTH_FAILED,		/* Since: 0.1.1 */
	FWUPD_ERROR_READ,			/* Since: 0.1.1 */
	FWUPD_ERROR_WRITE,			/* Since: 0.1.1 */
	FWUPD_ERROR_INVALID_FILE,		/* Since: 0.1.1 */
	FWUPD_ERROR_NOT_FOUND,			/* Since: 0.1.1 */
	FWUPD_ERROR_NOTHING_TO_DO,		/* Since: 0.1.1 */
	FWUPD_ERROR_NOT_SUPPORTED,		/* Since: 0.1.1 */
	FWUPD_ERROR_SIGNATURE_INVALID,		/* Since: 0.1.2 */
	FWUPD_ERROR_AC_POWER_REQUIRED,		/* Since: 0.8.0 */
	FWUPD_ERROR_PERMISSION_DENIED,		/* Since: 0.9.8 */
} FwupdError;

The error code.

FWUPD_ERROR_INTERNAL

Internal error

FWUPD_ERROR_VERSION_NEWER

Installed newer firmware version

FWUPD_ERROR_VERSION_SAME

Installed same firmware version

FWUPD_ERROR_ALREADY_PENDING

Already set be be installed offline

FWUPD_ERROR_AUTH_FAILED

Failed to get authentication

FWUPD_ERROR_READ

Failed to read from device

FWUPD_ERROR_WRITE

Failed to write to the device

FWUPD_ERROR_INVALID_FILE

Invalid file format

FWUPD_ERROR_NOT_FOUND

No matching device exists

FWUPD_ERROR_NOTHING_TO_DO

Nothing to do

FWUPD_ERROR_NOT_SUPPORTED

Action was not possible

FWUPD_ERROR_SIGNATURE_INVALID

Signature was invalid

FWUPD_ERROR_AC_POWER_REQUIRED

AC power was required

FWUPD_ERROR_PERMISSION_DENIED

Permission was denied

fwupd_error_quark ()

GQuark              fwupd_error_quark                   (void);

Returns :

An error quark.

Since 0.1.1


fwupd_error_to_string ()

const gchar *       fwupd_error_to_string               (FwupdError error);

Converts a FwupdError to a string.

error :

A FwupdError, e.g. FWUPD_ERROR_VERSION_NEWER

Returns :

identifier string

Since 0.7.0


fwupd_error_from_string ()

FwupdError          fwupd_error_from_string             (const gchar *error);

Converts a string to a FwupdError.

error :

A string, e.g. `org.freedesktop.fwupd.VersionNewer`

Returns :

enumerated value

Since 0.7.0