f63080fbe2
This allows us to show in the tools if a device is currently affected
by a specific CVE. For instance, we could inform the user that a device
requires a critical firmware update that is being actively exploited.
Note, this also means we can show the user a firmware update is now
required, even though the firmware may not be available on the LVFS.
Also show the issue in the `fwupdmgr security` output, e.g.
There are devices with issues:
Samsung — MZVLB2T0HALB-000L7:
• CVE-2022-12345
• CVE-2022-54321
|
||
|---|---|---|
| .. | ||
| tests | ||
| fu-bluez-backend.c | ||
| fu-bluez-backend.h | ||
| fu-config.c | ||
| fu-config.h | ||
| fu-debug.c | ||
| fu-debug.h | ||
| fu-device-list.c | ||
| fu-device-list.h | ||
| fu-engine-helper.c | ||
| fu-engine-helper.h | ||
| fu-engine-request.c | ||
| fu-engine-request.h | ||
| fu-engine.c | ||
| fu-engine.h | ||
| fu-history.c | ||
| fu-history.h | ||
| fu-idle.c | ||
| fu-idle.h | ||
| fu-install-task.c | ||
| fu-install-task.h | ||
| fu-keyring-utils.c | ||
| fu-keyring-utils.h | ||
| fu-main.c | ||
| fu-offline.c | ||
| fu-plugin-list.c | ||
| fu-plugin-list.h | ||
| fu-polkit-agent.c | ||
| fu-polkit-agent.h | ||
| fu-progressbar.c | ||
| fu-progressbar.h | ||
| fu-remote-list.c | ||
| fu-remote-list.h | ||
| fu-security-attr.c | ||
| fu-security-attr.h | ||
| fu-self-test.c | ||
| fu-systemd.c | ||
| fu-systemd.h | ||
| fu-tool.c | ||
| fu-udev-backend.c | ||
| fu-udev-backend.h | ||
| fu-usb-backend.c | ||
| fu-usb-backend.h | ||
| fu-util-common.c | ||
| fu-util-common.h | ||
| fu-util.c | ||
| fwupd.gresource.xml | ||
| fwupdagent.1 | ||
| fwupdmgr.1 | ||
| fwupdtool.1 | ||
| meson.build | ||
| org.freedesktop.fwupd.xml | ||
| README.md | ||
Quirk use
Quirks are defined by creating an INI style file in the compiled in quirk location (typically /usr/share/fwupd/quirks.d).
The quirk is declared by creating a group based upon the DeviceInstanceId or GUID
and then mapping out values to keys.
All plugins
All fwupd devices support the following quirks:
Plugin
Sets the plugin to use for a specific hardware device.
- Key: the device ID, e.g.
USB\VID_0763&PID_2806 - Value: the plugin name, e.g.
csr - Minimum fwupd version: 1.1.0
Flags
Assigns optional quirks to use for a 8bitdo device
- Key: the device ID, e.g.
USB\VID_0763&PID_2806 - Value: the quirk, e.g.
is-bootloader - Supported values:
none: no device quirksis-bootloader: device is in bootloader mode
- Minimum fwupd version: 1.0.3
Summary
Sets a summary for a specific hardware device.
- Key: the device ID, e.g.
USB\VID_0763&PID_2806 - the device summary, e.g.
An open source display colorimeter - Minimum fwupd version: 1.0.2
Icon
Adds an icon name for a specific hardware device.
- Key: the device ID, e.g.
USB\VID_0763&PID_2806 - Value: the device icon name, e.g.
media-removable - Minimum fwupd version: 1.0.2
Name
Sets a name for a specific hardware device.
- Key: the device ID, e.g.
USB\VID_0763&PID_2806 - Value: the device name, e.g.
ColorHug - Minimum fwupd version: 1.0.2
Guid
Adds an extra GUID for a specific hardware device. If the value provided is not already a suitable GUID, it will be converted to one.
- Key: the device ID, e.g.
USB\VID_0763&PID_2806 - Value: the GUID, e.g.
537f7800-8529-5656-b2fa-b0901fe91696 - Minimum fwupd version: 1.0.3
CounterpartGuid
Adds an counterpart GUID for a specific hardware device. If the value provided is not already a suitable GUID, it will be converted to one. A counterpart GUID is typically the GUID of the same device in bootloader or runtime mode, if they have a different device PCI or USB ID. Adding this type of GUID does not cause a "cascade" by matching using the quirk database.
- Key: the device ID, e.g.
USB\VID_0763&PID_2806 - Value: the GUID, e.g.
537f7800-8529-5656-b2fa-b0901fe91696 - Minimum fwupd version: 1.1.2
ParentGuid
Adds an extra GUID to mark as the parent device. If the value provided is not already a suitable GUID, it will be converted to one.
- Key: the device ID, e.g.
USB\VID_0763&PID_2806 - Value: the GUID, e.g.
537f7800-8529-5656-b2fa-b0901fe91696 - Minimum fwupd version: 1.1.2
Children
Adds one or more virtual devices to a physical device. To set the object type
of the child device use a pipe before the object type, for instance:
FuRts54xxDeviceUSB\VID_0763&PID_2806&I2C_01 If the type of device is not
specified the parent device type is used. If the values provided are not
already suitable GUIDs, they will be converted.
- Key: the device ID, e.g.
USB\VID_0763&PID_2806 - Value: The virtual device, delimited by a comma
- Minimum fwupd version: 1.1.2
Vendor
Sets a vendor name for a specific hardware device.
- Key: the device ID, e.g.
USB\VID_0763&PID_2806 - Value: the vendor, e.g.
Hughski Limited - Minimum fwupd version: 1.0.3
VendorId
Sets a vendor ID for a specific hardware device.
- Key: the device ID, e.g.
USB\VID_0763&PID_2806 - Value: the vendor, e.g.
USB:0x123A - Minimum fwupd version: 1.1.2
Version
Sets a version for a specific hardware device.
- Key: the device ID, e.g.
USB\VID_0763&PID_2806 - Value: Version number, e.g.
1.2 - Minimum fwupd version: 1.0.3
FirmwareSizeMin
Sets the minimum allowed firmware size.
- Key: the device ID, e.g.
USB\VID_0763&PID_2806 - Value: A number in bytes, e.g.
512 - Minimum fwupd version: 1.1.2
FirmwareSizeMax
Sets the maximum allowed firmware size.
- Key: the device ID, e.g.
USB\VID_0763&PID_2806 - Value: A number in bytes, e.g.
1024 - Minimum fwupd version: 1.1.2
InstallDuration
Sets the estimated time to flash the device
- Key: the device ID, e.g.
USB\VID_0763&PID_2806 - Value: A number in seconds, e.g.
60 - Minimum fwupd version: 1.1.3
VersionFormat
Sets the version format the device should use for conversion.
- Key: the device ID, e.g.
USB\VID_0763&PID_2806 - Value: The quirk format, e.g.
quad - Minimum fwupd version: 1.2.0
Plugin specific
Plugins may add support for additional quirks that are relevant only for
those plugins. View them by looking at the README.md in plugin directories.
Example
Here is an example as seen in the CSR plugin.
[USB\VID_0A12&PID_1337]
Plugin = dfu_csr
Name = H05
Summary = Bluetooth Headphones
Icon = audio-headphones
Vendor = AIAIAI
[USB\VID_0A12&PID_1337&REV_2520]
Version = 1.2
Additional samples can be found in other plugins.