fwupd-enums

fwupd-enums — enumerated values shared by the daemon and library

Functions

Types and Values

enum FwupdStatus
enum FwupdTrustFlags
enum FwupdFeatureFlags
#define FWUPD_DEVICE_FLAG_NONE
#define FWUPD_DEVICE_FLAG_INTERNAL
#define FWUPD_DEVICE_FLAG_UPDATABLE
#define FWUPD_DEVICE_FLAG_ONLY_OFFLINE
#define FWUPD_DEVICE_FLAG_REQUIRE_AC
#define FWUPD_DEVICE_FLAG_LOCKED
#define FWUPD_DEVICE_FLAG_SUPPORTED
#define FWUPD_DEVICE_FLAG_REGISTERED
#define FWUPD_DEVICE_FLAG_NEEDS_REBOOT
#define FWUPD_DEVICE_FLAG_REPORTED
#define FWUPD_DEVICE_FLAG_NOTIFIED
#define FWUPD_DEVICE_FLAG_USE_RUNTIME_VERSION
#define FWUPD_DEVICE_FLAG_INSTALL_PARENT_FIRST
#define FWUPD_DEVICE_FLAG_WAIT_FOR_REPLUG
#define FWUPD_DEVICE_FLAG_IGNORE_VALIDATION
#define FWUPD_DEVICE_FLAG_TRUSTED
#define FWUPD_DEVICE_FLAG_NEEDS_SHUTDOWN
#define FWUPD_DEVICE_FLAG_ANOTHER_WRITE_REQUIRED
#define FWUPD_DEVICE_FLAG_NO_AUTO_INSTANCE_IDS
#define FWUPD_DEVICE_FLAG_NEEDS_ACTIVATION
#define FWUPD_DEVICE_FLAG_ENSURE_SEMVER
#define FWUPD_DEVICE_FLAG_HISTORICAL
#define FWUPD_DEVICE_FLAG_ONLY_SUPPORTED
#define FWUPD_DEVICE_FLAG_WILL_DISAPPEAR
#define FWUPD_DEVICE_FLAG_CAN_VERIFY
#define FWUPD_DEVICE_FLAG_CAN_VERIFY_IMAGE
#define FWUPD_DEVICE_FLAG_DUAL_IMAGE
#define FWUPD_DEVICE_FLAG_SELF_RECOVERY
#define FWUPD_DEVICE_FLAG_USABLE_DURING_UPDATE
#define FWUPD_DEVICE_FLAG_VERSION_CHECK_REQUIRED
#define FWUPD_DEVICE_FLAG_INSTALL_ALL_RELEASES
#define FWUPD_DEVICE_FLAG_MD_SET_NAME
#define FWUPD_DEVICE_FLAG_MD_SET_NAME_CATEGORY
#define FWUPD_DEVICE_FLAG_MD_SET_VERFMT
#define FWUPD_DEVICE_FLAG_ADD_COUNTERPART_GUIDS
#define FWUPD_DEVICE_FLAG_NO_GUID_MATCHING
#define FWUPD_DEVICE_FLAG_UPDATABLE_HIDDEN
#define FWUPD_DEVICE_FLAG_SKIPS_RESTART
#define FWUPD_DEVICE_FLAG_HAS_MULTIPLE_BRANCHES
#define FWUPD_DEVICE_FLAG_BACKUP_BEFORE_INSTALL
#define FWUPD_DEVICE_FLAG_MD_SET_ICON
#define FWUPD_DEVICE_FLAG_UNKNOWN
typedef FwupdDeviceFlags
#define FWUPD_RELEASE_FLAG_NONE
#define FWUPD_RELEASE_FLAG_TRUSTED_PAYLOAD
#define FWUPD_RELEASE_FLAG_TRUSTED_METADATA
#define FWUPD_RELEASE_FLAG_BLOCKED_VERSION
#define FWUPD_RELEASE_FLAG_BLOCKED_APPROVAL
#define FWUPD_RELEASE_FLAG_UNKNOWN
typedef FwupdReleaseFlags
enum FwupdReleaseUrgency
#define FWUPD_PLUGIN_FLAG_NONE
#define FWUPD_PLUGIN_FLAG_DISABLED
#define FWUPD_PLUGIN_FLAG_USER_WARNING
#define FWUPD_PLUGIN_FLAG_CLEAR_UPDATABLE
#define FWUPD_PLUGIN_FLAG_NO_HARDWARE
#define FWUPD_PLUGIN_FLAG_CAPSULES_UNSUPPORTED
#define FWUPD_PLUGIN_FLAG_UNLOCK_REQUIRED
#define FWUPD_PLUGIN_FLAG_EFIVAR_NOT_MOUNTED
#define FWUPD_PLUGIN_FLAG_ESP_NOT_FOUND
#define FWUPD_PLUGIN_FLAG_LEGACY_BIOS
#define FWUPD_PLUGIN_FLAG_FAILED_OPEN
#define FWUPD_PLUGIN_FLAG_REQUIRE_HWID
#define FWUPD_PLUGIN_FLAG_UNKNOWN
typedef FwupdPluginFlags
enum FwupdInstallFlags
enum FwupdSelfSignFlags
enum FwupdUpdateState
enum FwupdKeyringKind
enum FwupdVersionFormat

Description

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

See also: fwupd-error

Functions

fwupd_status_to_string ()

const gchar *
fwupd_status_to_string (FwupdStatus status);

Converts a FwupdStatus to a string.

Parameters

Returns

identifier string

Since: 0.1.1


fwupd_status_from_string ()

FwupdStatus
fwupd_status_from_string (const gchar *status);

Converts a string to a FwupdStatus.

Parameters

status

A string, e.g. decompressing

 

Returns

enumerated value

Since: 0.1.1


fwupd_device_flag_to_string ()

const gchar *
fwupd_device_flag_to_string (FwupdDeviceFlags device_flag);

Converts a FwupdDeviceFlags to a string.

Parameters

Returns

identifier string

Since: 0.7.0


fwupd_device_flag_from_string ()

FwupdDeviceFlags
fwupd_device_flag_from_string (const gchar *device_flag);

Converts a string to a FwupdDeviceFlags.

Parameters

device_flag

A string, e.g. require-ac

 

Returns

enumerated value

Since: 0.7.0


fwupd_plugin_flag_to_string ()

const gchar *
fwupd_plugin_flag_to_string (FwupdPluginFlags plugin_flag);

Converts a FwupdDeviceFlags to a string.

Parameters

Returns

identifier string

Since: 1.5.0


fwupd_plugin_flag_from_string ()

FwupdPluginFlags
fwupd_plugin_flag_from_string (const gchar *plugin_flag);

Converts a string to a FwupdPluginFlags.

Parameters

plugin_flag

A string, e.g. require-ac

 

Returns

enumerated value

Since: 1.5.0


fwupd_release_flag_to_string ()

const gchar *
fwupd_release_flag_to_string (FwupdReleaseFlags release_flag);

Converts a FwupdReleaseFlags to a string.

Parameters

Returns

identifier string

Since: 1.2.6


fwupd_release_flag_from_string ()

FwupdReleaseFlags
fwupd_release_flag_from_string (const gchar *release_flag);

Converts a string to a FwupdReleaseFlags.

Parameters

release_flag

A string, e.g. trusted-payload

 

Returns

enumerated value

Since: 1.2.6


fwupd_release_urgency_to_string ()

const gchar *
fwupd_release_urgency_to_string (FwupdReleaseUrgency release_urgency);

Converts an enumerated value to a string.

Parameters

release_urgency

A FwupdReleaseUrgency, e.g. FWUPD_RELEASE_URGENCY_HIGH

 

Returns

identifier string

Since: 1.4.0


fwupd_release_urgency_from_string ()

FwupdReleaseUrgency
fwupd_release_urgency_from_string (const gchar *release_urgency);

Converts a string to an enumerated value.

Parameters

release_urgency

A string, e.g. low

 

Returns

enumerated value

Since: 1.4.0


fwupd_update_state_to_string ()

const gchar *
fwupd_update_state_to_string (FwupdUpdateState update_state);

Converts a FwupdUpdateState to a string.

Parameters

Returns

identifier string

Since: 0.7.0


fwupd_update_state_from_string ()

FwupdUpdateState
fwupd_update_state_from_string (const gchar *update_state);

Converts a string to a FwupdUpdateState.

Parameters

update_state

A string, e.g. pending

 

Returns

enumerated value

Since: 0.7.0


fwupd_trust_flag_to_string ()

const gchar *
fwupd_trust_flag_to_string (FwupdTrustFlags trust_flag);

Converts a FwupdTrustFlags to a string.

Parameters

Returns

identifier string

Since: 0.7.0


fwupd_trust_flag_from_string ()

FwupdTrustFlags
fwupd_trust_flag_from_string (const gchar *trust_flag);

Converts a string to a FwupdTrustFlags.

Parameters

trust_flag

A string, e.g. payload

 

Returns

enumerated value

Since: 0.7.0


fwupd_feature_flag_to_string ()

const gchar *
fwupd_feature_flag_to_string (FwupdFeatureFlags feature_flag);

Converts a FwupdFeatureFlags to a string.

Parameters

Returns

identifier string

Since: 1.4.5


fwupd_feature_flag_from_string ()

FwupdFeatureFlags
fwupd_feature_flag_from_string (const gchar *feature_flag);

Converts a string to a FwupdFeatureFlags.

Parameters

feature_flag

A string, e.g. detach-action

 

Returns

enumerated value

Since: 1.4.5


fwupd_keyring_kind_from_string ()

FwupdKeyringKind
fwupd_keyring_kind_from_string (const gchar *keyring_kind);

Converts an printable string to an enumerated type.

Parameters

keyring_kind

a string, e.g. gpg

 

Since: 0.9.7


fwupd_keyring_kind_to_string ()

const gchar *
fwupd_keyring_kind_to_string (FwupdKeyringKind keyring_kind);

Converts an enumerated type to a printable string.

Parameters

keyring_kind

a FwupdKeyringKind, e.g. FWUPD_KEYRING_KIND_GPG

 

Returns

a string, e.g. gpg

Since: 0.9.7


fwupd_version_format_from_string ()

FwupdVersionFormat
fwupd_version_format_from_string (const gchar *str);

Converts text to a display version type.

Parameters

str

A string, e.g. quad

 

Since: 1.2.9


fwupd_version_format_to_string ()

const gchar *
fwupd_version_format_to_string (FwupdVersionFormat kind);

Converts a display version type to text.

Returns

A string, e.g. quad, or NULL if not known

Since: 1.2.9

Types and Values

enum FwupdStatus

The flags to show daemon status.

Members

FWUPD_STATUS_UNKNOWN

Unknown state

 

FWUPD_STATUS_IDLE

Idle

 

FWUPD_STATUS_LOADING

Loading a resource

 

FWUPD_STATUS_DECOMPRESSING

Decompressing firmware

 

FWUPD_STATUS_DEVICE_RESTART

Restarting the device

 

FWUPD_STATUS_DEVICE_WRITE

Writing to a device

 

FWUPD_STATUS_DEVICE_VERIFY

Verifying (reading) a device

 

FWUPD_STATUS_SCHEDULING

Scheduling an offline update

 

FWUPD_STATUS_DOWNLOADING

A file is downloading

 

FWUPD_STATUS_DEVICE_READ

Reading from a device

 

FWUPD_STATUS_DEVICE_ERASE

Erasing a device

 

FWUPD_STATUS_WAITING_FOR_AUTH

Waiting for authentication

 

FWUPD_STATUS_DEVICE_BUSY

The device is busy

 

FWUPD_STATUS_SHUTDOWN

The daemon is shutting down

 

enum FwupdTrustFlags

The flags to show the level of trust.

Members

FWUPD_TRUST_FLAG_NONE

No trust

 

FWUPD_TRUST_FLAG_PAYLOAD

The firmware is trusted

 

FWUPD_TRUST_FLAG_METADATA

The metadata is trusted

 

enum FwupdFeatureFlags

The flags to the feature capabilities of the front-end client.

Members

FWUPD_FEATURE_FLAG_NONE

No trust

 

FWUPD_FEATURE_FLAG_CAN_REPORT

Can upload a report of the update back to the server

 

FWUPD_FEATURE_FLAG_DETACH_ACTION

Can perform detach action, typically showing text

 

FWUPD_FEATURE_FLAG_UPDATE_ACTION

Can perform update action, typically showing text

 

FWUPD_FEATURE_FLAG_SWITCH_BRANCH

Can switch the firmware branch

 

FWUPD_DEVICE_FLAG_NONE

#define FWUPD_DEVICE_FLAG_NONE			(0u)		/* Since: 0.1.3 */

FWUPD_DEVICE_FLAG_INTERNAL

#define FWUPD_DEVICE_FLAG_INTERNAL		(1u << 0) /* Since: 0.1.3 */

FWUPD_DEVICE_FLAG_UPDATABLE

#define FWUPD_DEVICE_FLAG_UPDATABLE		(1u << 1) /* Since: 0.9.7 */

FWUPD_DEVICE_FLAG_ONLY_OFFLINE

#define FWUPD_DEVICE_FLAG_ONLY_OFFLINE		(1u << 2) /* Since: 0.9.7 */

FWUPD_DEVICE_FLAG_REQUIRE_AC

#define FWUPD_DEVICE_FLAG_REQUIRE_AC		(1u << 3) /* Since: 0.6.3 */

FWUPD_DEVICE_FLAG_LOCKED

#define FWUPD_DEVICE_FLAG_LOCKED		(1u << 4) /* Since: 0.6.3 */

FWUPD_DEVICE_FLAG_SUPPORTED

#define FWUPD_DEVICE_FLAG_SUPPORTED		(1u << 5) /* Since: 0.7.1 */

FWUPD_DEVICE_FLAG_REGISTERED

#define FWUPD_DEVICE_FLAG_REGISTERED		(1u << 7) /* Since: 0.9.7 */

FWUPD_DEVICE_FLAG_NEEDS_REBOOT

#define FWUPD_DEVICE_FLAG_NEEDS_REBOOT		(1u << 8) /* Since: 0.9.7 */

FWUPD_DEVICE_FLAG_REPORTED

#define FWUPD_DEVICE_FLAG_REPORTED		(1u << 9) /* Since: 1.0.4 */

FWUPD_DEVICE_FLAG_NOTIFIED

#define FWUPD_DEVICE_FLAG_NOTIFIED		(1u << 10) /* Since: 1.0.5 */

FWUPD_DEVICE_FLAG_USE_RUNTIME_VERSION

#define FWUPD_DEVICE_FLAG_USE_RUNTIME_VERSION (1u << 11) /* Since: 1.0.6 */

FWUPD_DEVICE_FLAG_INSTALL_PARENT_FIRST

#define FWUPD_DEVICE_FLAG_INSTALL_PARENT_FIRST (1u << 12) /* Since: 1.0.8 */

FWUPD_DEVICE_FLAG_WAIT_FOR_REPLUG

#define FWUPD_DEVICE_FLAG_WAIT_FOR_REPLUG (1u << 14) /* Since: 1.1.2 */

FWUPD_DEVICE_FLAG_IGNORE_VALIDATION

#define FWUPD_DEVICE_FLAG_IGNORE_VALIDATION (1u << 15) /* Since: 1.1.2 */

FWUPD_DEVICE_FLAG_TRUSTED

#define FWUPD_DEVICE_FLAG_TRUSTED		(1u << 16) /* Since: 1.1.2 */

FWUPD_DEVICE_FLAG_NEEDS_SHUTDOWN

#define FWUPD_DEVICE_FLAG_NEEDS_SHUTDOWN (1u << 17) /* Since: 1.2.4 */

FWUPD_DEVICE_FLAG_ANOTHER_WRITE_REQUIRED

#define FWUPD_DEVICE_FLAG_ANOTHER_WRITE_REQUIRED (1u << 18) /* Since: 1.2.5 */

FWUPD_DEVICE_FLAG_NO_AUTO_INSTANCE_IDS

#define FWUPD_DEVICE_FLAG_NO_AUTO_INSTANCE_IDS (1u << 19) /* Since: 1.2.5; Deprecated: 1.5.5 */

FWUPD_DEVICE_FLAG_NEEDS_ACTIVATION

#define FWUPD_DEVICE_FLAG_NEEDS_ACTIVATION (1u << 20) /* Since: 1.2.6 */

FWUPD_DEVICE_FLAG_ENSURE_SEMVER

#define FWUPD_DEVICE_FLAG_ENSURE_SEMVER		(1u << 21) /* Since: 1.2.9; Deprecated: 1.5.5 */

FWUPD_DEVICE_FLAG_HISTORICAL

#define FWUPD_DEVICE_FLAG_HISTORICAL		(1u << 22) /* Since: 1.3.2 */

FWUPD_DEVICE_FLAG_ONLY_SUPPORTED

#define FWUPD_DEVICE_FLAG_ONLY_SUPPORTED (1u << 23) /* Since: 1.3.3; Deprecated: 1.5.5 */

FWUPD_DEVICE_FLAG_WILL_DISAPPEAR

#define FWUPD_DEVICE_FLAG_WILL_DISAPPEAR (1u << 24) /* Since: 1.3.3 */

FWUPD_DEVICE_FLAG_CAN_VERIFY

#define FWUPD_DEVICE_FLAG_CAN_VERIFY		(1u << 25) /* Since: 1.3.3 */

FWUPD_DEVICE_FLAG_CAN_VERIFY_IMAGE

#define FWUPD_DEVICE_FLAG_CAN_VERIFY_IMAGE (1u << 26) /* Since: 1.3.3 */

FWUPD_DEVICE_FLAG_DUAL_IMAGE

#define FWUPD_DEVICE_FLAG_DUAL_IMAGE		(1u << 27) /* Since: 1.3.3 */

FWUPD_DEVICE_FLAG_SELF_RECOVERY

#define FWUPD_DEVICE_FLAG_SELF_RECOVERY		(1u << 28) /* Since: 1.3.3 */

FWUPD_DEVICE_FLAG_USABLE_DURING_UPDATE

#define FWUPD_DEVICE_FLAG_USABLE_DURING_UPDATE (1u << 29) /* Since: 1.3.3 */

FWUPD_DEVICE_FLAG_VERSION_CHECK_REQUIRED

#define FWUPD_DEVICE_FLAG_VERSION_CHECK_REQUIRED (1u << 30) /* Since: 1.3.7 */

FWUPD_DEVICE_FLAG_INSTALL_ALL_RELEASES

#define FWUPD_DEVICE_FLAG_INSTALL_ALL_RELEASES (1u << 31) /* Since: 1.3.7 */

FWUPD_DEVICE_FLAG_MD_SET_NAME

#define FWUPD_DEVICE_FLAG_MD_SET_NAME		(1llu << 32) /* Since: 1.4.0; Deprecated: 1.5.5 */

FWUPD_DEVICE_FLAG_MD_SET_NAME_CATEGORY

#define FWUPD_DEVICE_FLAG_MD_SET_NAME_CATEGORY (1llu << 33) /* Since: 1.4.0; Deprecated: 1.5.5 */

FWUPD_DEVICE_FLAG_MD_SET_VERFMT

#define FWUPD_DEVICE_FLAG_MD_SET_VERFMT		(1llu << 34) /* Since: 1.4.0; Deprecated: 1.5.5 */

FWUPD_DEVICE_FLAG_ADD_COUNTERPART_GUIDS

#define FWUPD_DEVICE_FLAG_ADD_COUNTERPART_GUIDS (1llu << 35) /* Since: 1.4.0 */

FWUPD_DEVICE_FLAG_NO_GUID_MATCHING

#define FWUPD_DEVICE_FLAG_NO_GUID_MATCHING (1llu << 36) /* Since: 1.4.1; Deprecated: 1.5.8 */

FWUPD_DEVICE_FLAG_UPDATABLE_HIDDEN

#define FWUPD_DEVICE_FLAG_UPDATABLE_HIDDEN (1llu << 37) /* Since: 1.4.1 */

FWUPD_DEVICE_FLAG_SKIPS_RESTART

#define FWUPD_DEVICE_FLAG_SKIPS_RESTART		(1llu << 38) /* Since: 1.5.0 */

FWUPD_DEVICE_FLAG_HAS_MULTIPLE_BRANCHES

#define FWUPD_DEVICE_FLAG_HAS_MULTIPLE_BRANCHES (1llu << 39) /* Since: 1.5.0 */

FWUPD_DEVICE_FLAG_BACKUP_BEFORE_INSTALL

#define FWUPD_DEVICE_FLAG_BACKUP_BEFORE_INSTALL (1llu << 40) /* Since: 1.5.0 */

FWUPD_DEVICE_FLAG_MD_SET_ICON

#define FWUPD_DEVICE_FLAG_MD_SET_ICON		(1llu << 41) /* Since: 1.5.2; Deprecated: 1.5.5 */

FWUPD_DEVICE_FLAG_UNKNOWN

#define FWUPD_DEVICE_FLAG_UNKNOWN		G_MAXUINT64 /* Since: 0.7.3 */

FwupdDeviceFlags

typedef guint64 FwupdDeviceFlags;

The device flags.


FWUPD_RELEASE_FLAG_NONE

#define FWUPD_RELEASE_FLAG_NONE			(0u)		/* Since: 1.2.6 */

FWUPD_RELEASE_FLAG_TRUSTED_PAYLOAD

#define FWUPD_RELEASE_FLAG_TRUSTED_PAYLOAD (1u << 0) /* Since: 1.2.6 */

FWUPD_RELEASE_FLAG_TRUSTED_METADATA

#define FWUPD_RELEASE_FLAG_TRUSTED_METADATA (1u << 1) /* Since: 1.2.6 */

FWUPD_RELEASE_FLAG_BLOCKED_VERSION

#define FWUPD_RELEASE_FLAG_BLOCKED_VERSION (1u << 4) /* Since: 1.2.6 */

FWUPD_RELEASE_FLAG_BLOCKED_APPROVAL

#define FWUPD_RELEASE_FLAG_BLOCKED_APPROVAL (1u << 5) /* Since: 1.2.6 */

FWUPD_RELEASE_FLAG_UNKNOWN

#define FWUPD_RELEASE_FLAG_UNKNOWN		G_MAXUINT64 /* Since: 1.2.6 */

FwupdReleaseFlags

typedef guint64 FwupdReleaseFlags;

The release flags.


enum FwupdReleaseUrgency

The release urgency.

Members

FWUPD_RELEASE_URGENCY_UNKNOWN

Unknown

 

FWUPD_RELEASE_URGENCY_LOW

Low

 

FWUPD_RELEASE_URGENCY_MEDIUM

Medium

 

FWUPD_RELEASE_URGENCY_HIGH

High

 

FWUPD_RELEASE_URGENCY_CRITICAL

Critical, e.g. a security fix

 

FWUPD_PLUGIN_FLAG_NONE

#define FWUPD_PLUGIN_FLAG_NONE			(0u)		/* Since: 1.5.0 */

FWUPD_PLUGIN_FLAG_DISABLED

#define FWUPD_PLUGIN_FLAG_DISABLED		(1u << 0) /* Since: 1.5.0 */

FWUPD_PLUGIN_FLAG_USER_WARNING

#define FWUPD_PLUGIN_FLAG_USER_WARNING		(1u << 1) /* Since: 1.5.0 */

FWUPD_PLUGIN_FLAG_CLEAR_UPDATABLE

#define FWUPD_PLUGIN_FLAG_CLEAR_UPDATABLE (1u << 2) /* Since: 1.5.0 */

FWUPD_PLUGIN_FLAG_NO_HARDWARE

#define FWUPD_PLUGIN_FLAG_NO_HARDWARE		(1u << 3) /* Since: 1.5.0 */

FWUPD_PLUGIN_FLAG_CAPSULES_UNSUPPORTED

#define FWUPD_PLUGIN_FLAG_CAPSULES_UNSUPPORTED (1u << 4) /* Since: 1.5.0 */

FWUPD_PLUGIN_FLAG_UNLOCK_REQUIRED

#define FWUPD_PLUGIN_FLAG_UNLOCK_REQUIRED (1u << 5) /* Since: 1.5.0 */

FWUPD_PLUGIN_FLAG_EFIVAR_NOT_MOUNTED

#define FWUPD_PLUGIN_FLAG_EFIVAR_NOT_MOUNTED (1u << 6) /* Since: 1.5.0 */

FWUPD_PLUGIN_FLAG_ESP_NOT_FOUND

#define FWUPD_PLUGIN_FLAG_ESP_NOT_FOUND		(1u << 7) /* Since: 1.5.0 */

FWUPD_PLUGIN_FLAG_LEGACY_BIOS

#define FWUPD_PLUGIN_FLAG_LEGACY_BIOS		(1u << 8) /* Since: 1.5.0 */

FWUPD_PLUGIN_FLAG_FAILED_OPEN

#define FWUPD_PLUGIN_FLAG_FAILED_OPEN		(1u << 9) /* Since: 1.5.0 */

FWUPD_PLUGIN_FLAG_REQUIRE_HWID

#define FWUPD_PLUGIN_FLAG_REQUIRE_HWID		(1u << 10) /* Since: 1.5.8 */

FWUPD_PLUGIN_FLAG_UNKNOWN

#define FWUPD_PLUGIN_FLAG_UNKNOWN		G_MAXUINT64 /* Since: 1.5.0 */

FwupdPluginFlags

typedef guint64 FwupdPluginFlags;

The plugin flags.


enum FwupdInstallFlags

Flags to set when performing the firmware update or install.

Members

FWUPD_INSTALL_FLAG_NONE

No flags set

 

FWUPD_INSTALL_FLAG_OFFLINE

Schedule this for next boot

 

FWUPD_INSTALL_FLAG_ALLOW_REINSTALL

Allow reinstalling the same version

 

FWUPD_INSTALL_FLAG_ALLOW_OLDER

Allow downgrading firmware

 

FWUPD_INSTALL_FLAG_FORCE

Force the update even if not a good idea

 

FWUPD_INSTALL_FLAG_NO_HISTORY

Do not write to the history database

 

FWUPD_INSTALL_FLAG_ALLOW_BRANCH_SWITCH

Allow firmware branch switching

 

FWUPD_INSTALL_FLAG_IGNORE_CHECKSUM

Ignore firmware CRCs and checksums

 

FWUPD_INSTALL_FLAG_IGNORE_VID_PID

Ignore firmware vendor and project checks

 

FWUPD_INSTALL_FLAG_IGNORE_POWER

Ignore requirement of external power source

 

FWUPD_INSTALL_FLAG_NO_SEARCH

Do not use heuristics when parsing the image

 

enum FwupdSelfSignFlags

Flags to set when performing the firmware update or install.

Members

FWUPD_SELF_SIGN_FLAG_NONE

No flags set

 

FWUPD_SELF_SIGN_FLAG_ADD_TIMESTAMP

Add the timestamp to the detached signature

 

FWUPD_SELF_SIGN_FLAG_ADD_CERT

Add the certificate to the detached signature

 

enum FwupdUpdateState

The update state.

Members

FWUPD_UPDATE_STATE_UNKNOWN

Unknown

 

FWUPD_UPDATE_STATE_PENDING

Update is pending

 

FWUPD_UPDATE_STATE_SUCCESS

Update was successful

 

FWUPD_UPDATE_STATE_FAILED

Update failed

 

FWUPD_UPDATE_STATE_NEEDS_REBOOT

Waiting for a reboot to apply

 

FWUPD_UPDATE_STATE_FAILED_TRANSIENT

Update failed due to transient issue, e.g. AC power required

 

enum FwupdKeyringKind

The update state.

Members

FWUPD_KEYRING_KIND_UNKNOWN

Unknown

 

FWUPD_KEYRING_KIND_NONE

No verification

 

FWUPD_KEYRING_KIND_GPG

Verification using GPG

 

FWUPD_KEYRING_KIND_PKCS7

Verification using PKCS7

 

FWUPD_KEYRING_KIND_JCAT

Verification using Jcat

 

enum FwupdVersionFormat

The flags used when parsing version numbers.

If no verification is required then FWUPD_VERSION_FORMAT_PLAIN should be used to signify an unparsable text string.

Members

FWUPD_VERSION_FORMAT_UNKNOWN

Unknown version format

 

FWUPD_VERSION_FORMAT_PLAIN

An unidentified format text string

 

FWUPD_VERSION_FORMAT_NUMBER

A single integer version number

 

FWUPD_VERSION_FORMAT_PAIR

Two AABB.CCDD version numbers

 

FWUPD_VERSION_FORMAT_TRIPLET

Microsoft-style AA.BB.CCDD version numbers

 

FWUPD_VERSION_FORMAT_QUAD

UEFI-style AA.BB.CC.DD version numbers

 

FWUPD_VERSION_FORMAT_BCD

Binary coded decimal notation

 

FWUPD_VERSION_FORMAT_INTEL_ME

Intel ME-style bitshifted notation

 

FWUPD_VERSION_FORMAT_INTEL_ME2

Intel ME-style A.B.CC.DDDD notation notation

 

FWUPD_VERSION_FORMAT_SURFACE_LEGACY

Legacy Microsoft Surface 10b.12b.10b

 

FWUPD_VERSION_FORMAT_SURFACE

Microsoft Surface 8b.16b.8b

 

FWUPD_VERSION_FORMAT_DELL_BIOS

Dell BIOS BB.CC.DD style

 

FWUPD_VERSION_FORMAT_HEX

Hexadecimal 0xAABCCDD style