Enumeration
FwupdDeviceFlags
Members
Name | Description |
---|---|
FWUPD_DEVICE_FLAG_NONE |
No flags set. |
FWUPD_DEVICE_FLAG_INTERNAL |
Device is internal to the platform and cannot be removed easily. |
FWUPD_DEVICE_FLAG_UPDATABLE |
Device has the ability to be updated in this or any other mode. |
FWUPD_DEVICE_FLAG_REQUIRE_AC |
Device requires an external power source to be connected or the battery level at a minimum threshold to update. |
FWUPD_DEVICE_FLAG_LOCKED |
The device can not be updated without manual user interaction. |
FWUPD_DEVICE_FLAG_SUPPORTED |
The device is found in metadata loaded into the daemon. |
FWUPD_DEVICE_FLAG_NEEDS_BOOTLOADER |
The device requires entering a bootloader mode to be manually. |
FWUPD_DEVICE_FLAG_NEEDS_REBOOT |
The device requires a system reboot to apply firmware or to reload hardware. |
FWUPD_DEVICE_FLAG_REPORTED |
The success or failure of a previous update has been reported to a metadata server. |
FWUPD_DEVICE_FLAG_NOTIFIED |
The user has been notified about a change in the device state. |
FWUPD_DEVICE_FLAG_IS_BOOTLOADER |
The device is currently in a read-only bootloader mode and not running application code. |
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. |
FWUPD_DEVICE_FLAG_NEEDS_SHUTDOWN |
The device requires the system to be shutdown to finish application of new firmware. |
FWUPD_DEVICE_FLAG_ANOTHER_WRITE_REQUIRED |
The device requires the update to be retried, possibly with a different plugin. |
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. |
FWUPD_DEVICE_FLAG_HISTORICAL |
The device is used for historical data only. |
FWUPD_DEVICE_FLAG_WILL_DISAPPEAR |
The device will disappear after the update is complete and success or failure can’t be verified. |
FWUPD_DEVICE_FLAG_CAN_VERIFY |
The device checksums can be compared against metadata. |
FWUPD_DEVICE_FLAG_CAN_VERIFY_IMAGE |
The device application firmware image can be dumped from device for verification. |
FWUPD_DEVICE_FLAG_DUAL_IMAGE |
The device firmware update architecture uses a redundancy mechanism such as A/B partitions for updates. |
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. |
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. |
FWUPD_DEVICE_FLAG_VERSION_CHECK_REQUIRED |
All firmware updates for this device require a firmware version check. |
FWUPD_DEVICE_FLAG_INSTALL_ALL_RELEASES |
Install each intermediate releases for the device rather than jumping directly to the newest. |
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. |
|
FWUPD_DEVICE_FLAG_HAS_MULTIPLE_BRANCHES |
The device supports switching to a different stream of firmware. |
FWUPD_DEVICE_FLAG_BACKUP_BEFORE_INSTALL |
The device firmware should be saved before installing firmware. |
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. |
FWUPD_DEVICE_FLAG_ONLY_VERSION_UPGRADE |
The device firmware can only be updated to a newer version and never downgraded or reinstalled. |
FWUPD_DEVICE_FLAG_UNREACHABLE |
The device is currently unreachable, perhaps because it is in a lower power state or is out of wireless range. |
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. |
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. |
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. |
FWUPD_DEVICE_FLAG_UNSIGNED_PAYLOAD |
The firmware payload is unsigned and it is possible to modify and flash custom firmware. |
FWUPD_DEVICE_FLAG_EMULATED |
The device is emulated and should not be recorded by the backend. |
FWUPD_DEVICE_FLAG_EMULATION_TAG |
The device should be recorded by the backend, allowing emulation. |
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 |
FWUPD_DEVICE_FLAG_CAN_EMULATION_TAG |
The device can be recorded by the backend, allowing emulation. |