Enumeration
FwupdDeviceFlags
Members
-
FWUPD_DEVICE_FLAG_NONE -
No flags set.
- Value:
0 - Available since: 0.1.3
- Value:
-
FWUPD_DEVICE_FLAG_INTERNAL -
Device is internal to the platform and cannot be removed easily.
- Value:
1 - Available since: 0.1.3
- Value:
-
FWUPD_DEVICE_FLAG_UPDATABLE -
Device has the ability to be updated in this or any other mode.
- Value:
2 - Available since: 0.9.7
- Value:
-
FWUPD_DEVICE_FLAG_REQUIRE_AC -
Device requires an external power source to be connected or the battery level at a minimum threshold to update.
- Value:
8 - Available since: 0.6.3
- Value:
-
FWUPD_DEVICE_FLAG_LOCKED -
The device can not be updated without manual user interaction.
- Value:
16 - Available since: 0.6.3
- Value:
-
FWUPD_DEVICE_FLAG_SUPPORTED -
The device is found in metadata loaded into the daemon.
- Value:
32 - Available since: 0.7.1
- Value:
-
FWUPD_DEVICE_FLAG_NEEDS_BOOTLOADER -
The device requires entering a bootloader mode to be manually.
- Value:
64 - Available since: 0.7.3
- Value:
-
FWUPD_DEVICE_FLAG_NEEDS_REBOOT -
The device requires a system reboot to apply firmware or to reload hardware.
- Value:
256 - Available since: 0.9.7
- Value:
-
FWUPD_DEVICE_FLAG_REPORTED -
The success or failure of a previous update has been reported to a metadata server.
- Value:
512 - Available since: 1.0.4
- Value:
-
FWUPD_DEVICE_FLAG_NOTIFIED -
The user has been notified about a change in the device state.
- Value:
1024 - Available since: 1.0.5
- Value:
-
FWUPD_DEVICE_FLAG_IS_BOOTLOADER -
The device is currently in a read-only bootloader mode and not running application code.
- Value:
8192 - Available since: 1.0.8
- Value:
-
FWUPD_DEVICE_FLAG_WAIT_FOR_REPLUG -
The device is in the middle of and update and the hardware is waiting to be probed or replugged.
- Value:
16384 - Available since: 1.1.2
- Value:
-
FWUPD_DEVICE_FLAG_NEEDS_SHUTDOWN -
The device requires the system to be shutdown to finish application of new firmware.
- Value:
131072 - Available since: 1.2.4
- Value:
-
FWUPD_DEVICE_FLAG_ANOTHER_WRITE_REQUIRED -
The device requires the update to be retried, possibly with a different plugin.
- Value:
262144 - Available since: 1.2.5
- Value:
-
FWUPD_DEVICE_FLAG_NEEDS_ACTIVATION -
The device update needs to be separately activated. This process may occur automatically on shutdown in some operating systems or when the device is unplugged with some devices.
- Value:
1048576 - Available since: 1.2.6
- Value:
-
FWUPD_DEVICE_FLAG_HISTORICAL -
The device is used for historical data only.
- Value:
4194304 - Available since: 1.3.2
- Value:
-
FWUPD_DEVICE_FLAG_WILL_DISAPPEAR -
The device will disappear after the update is complete and success or failure can’t be verified.
- Value:
16777216 - Available since: 1.3.3
- Value:
-
FWUPD_DEVICE_FLAG_CAN_VERIFY -
The device checksums can be compared against metadata.
- Value:
33554432 - Available since: 1.3.3
- Value:
-
FWUPD_DEVICE_FLAG_CAN_VERIFY_IMAGE -
The device application firmware image can be dumped from device for verification.
- Value:
67108864 - Available since: 1.3.3
- Value:
-
FWUPD_DEVICE_FLAG_DUAL_IMAGE -
The device firmware update architecture uses a redundancy mechanism such as A/B partitions for updates.
- Value:
134217728 - Available since: 1.3.3
- Value:
-
FWUPD_DEVICE_FLAG_SELF_RECOVERY -
In flashing mode, the device will only accept intended payloads and will revert back to a valid firmware image if an invalid or incomplete payload was sent.
- Value:
268435456 - Available since: 1.3.3
- Value:
-
FWUPD_DEVICE_FLAG_USABLE_DURING_UPDATE -
The device remains usable while the update flashes or schedules the update. The update will implicitly be applied next time the device is power cycled or possibly activated.
- Value:
536870912 - Available since: 1.3.3
- Value:
-
FWUPD_DEVICE_FLAG_VERSION_CHECK_REQUIRED -
All firmware updates for this device require a firmware version check.
- Value:
1073741824 - Available since: 1.3.7
- Value:
-
FWUPD_DEVICE_FLAG_INSTALL_ALL_RELEASES -
Install each intermediate releases for the device rather than jumping directly to the newest.
- Value:
2147483648 - Available since: 1.3.7
- Value:
-
The device is updatable but is currently inhibited from updates in the client. Reasons include but are not limited to low power or requiring reboot from a previous update.
- Value:
137438953472 - Available since: 1.4.1
- Value:
-
FWUPD_DEVICE_FLAG_HAS_MULTIPLE_BRANCHES -
The device supports switching to a different stream of firmware.
- Value:
549755813888 - Available since: 1.5.0
- Value:
-
FWUPD_DEVICE_FLAG_BACKUP_BEFORE_INSTALL -
The device firmware should be saved before installing firmware.
- Value:
1099511627776 - Available since: 1.5.0
- Value:
-
FWUPD_DEVICE_FLAG_WILDCARD_INSTALL -
All devices with matching GUIDs will be updated at the same time.
For some devices it is not possible to have different versions of firmware for hardware of the same type. Updating one device will force update of others with exactly the same instance IDs.
- Value:
4398046511104 - Available since: 1.6.2
- Value:
-
FWUPD_DEVICE_FLAG_ONLY_VERSION_UPGRADE -
The device firmware can only be updated to a newer version and never downgraded or reinstalled.
- Value:
8796093022208 - Available since: 1.6.2
- Value:
-
FWUPD_DEVICE_FLAG_UNREACHABLE -
The device is currently unreachable, perhaps because it is in a lower power state or is out of wireless range.
- Value:
17592186044416 - Available since: 1.7.0
- Value:
-
FWUPD_DEVICE_FLAG_AFFECTS_FDE -
The device is warning that a volume with full-disk-encryption was found on this machine, typically a Windows NTFS partition with BitLocker. Updating the firmware on this device may invalidate secrets used to decrypt the volume, and the recovery key may be required.
Supported clients will display this information as a warning to the user.
- Value:
35184372088832 - Available since: 1.7.1
- Value:
-
FWUPD_DEVICE_FLAG_END_OF_LIFE -
The device is no longer supported by the original hardware vendor as it is considered end-of-life. It it unlikely to receive firmware updates, even for security issues.
- Value:
70368744177664 - Available since: 1.7.5
- Value:
-
FWUPD_DEVICE_FLAG_SIGNED_PAYLOAD -
The firmware payload is verified on-device the payload using strong cryptography such as RSA, AES or ECC.
It is usually not possible to modify or flash custom firmware not provided by the vendor.
- Value:
140737488355328 - Available since: 1.7.6
- Value:
-
FWUPD_DEVICE_FLAG_UNSIGNED_PAYLOAD -
The firmware payload is unsigned and it is possible to modify and flash custom firmware.
- Value:
281474976710656 - Available since: 1.7.6
- Value:
-
FWUPD_DEVICE_FLAG_EMULATED -
The device is emulated and should not be recorded by the backend.
- Value:
562949953421312 - Available since: 1.8.11
- Value:
-
FWUPD_DEVICE_FLAG_EMULATION_TAG -
The device should be recorded by the backend, allowing emulation.
- Value:
1125899906842624 - Available since: 1.8.11
- Value:
-
FWUPD_DEVICE_FLAG_ONLY_EXPLICIT_UPDATES -
The device should stay on one firmware version unless the new version is explicitly specified.
This can either be done using
fwupdmgr install, using GNOME Firmware, or using a BKC config.- Value:
2251799813685248 - Available since: 1.9.3
- Value:
-
FWUPD_DEVICE_FLAG_CAN_EMULATION_TAG -
The device can be recorded by the backend, allowing emulation.
- Value:
4503599627370496 - Available since: 2.0.1
- Value:
-
FWUPD_DEVICE_FLAG_INSTALL_SKIP_VERSION_CHECK -
The device doesn’t require verification of the newly installed version.
- Value:
9007199254740992 - Available since: 2.0.2
- Value: