fwupdagent - Commands

FwupdagentDevices - command /bin/fwupdagent get-devices FwupdagentSecurity - command /bin/fwupdagent security --force

Both commands produce JSON data representing current state of the HW firmware.

class insights.parsers.fwupdagent.FwupdagentDevices(context, extra_bad_lines=None)

Bases: CommandParser, JSONParser

Class FwupdagentDevices parses the output of the /bin/fwupdagent get-devices command.

data

The parsed output of the command.

Type:

dict

Sample input data:

{
  "Devices" : [
    {
      "Name" : "Thunderbolt host controller",
      "DeviceId" : "113494429de0754484e6b93d70e879a913311dd5",
      "Guid" : [
        "ea3c7ac8-d937-568a-aab5-e053bd6af9ce",
        "3d3f953a-3408-56fa-81f3-042d73c59c16",
        "e773c51e-a20c-5b29-9f09-6bb0e0ef7560",
        "f1793149-6c12-5a7f-95db-9fefd116748d"
      ],
      "Summary" : "Unmatched performance for high-speed I/O",
      "Plugin" : "thunderbolt",
      "Protocol" : "com.intel.thunderbolt",
      "Flags" : [
        "internal",
        "updatable",
        "require-ac",
        "supported",
        "registered",
        "dual-image"
      ],
      "Vendor" : "Lenovo",
      "VendorId" : "THUNDERBOLT:0x0109|TBT:0x0109",
      "VendorIds" : [
        "THUNDERBOLT:0x0109",
        "TBT:0x0109"
      ],
      "Version" : "20.00",
      "VersionFormat" : "pair",
      "Icons" : [
        "thunderbolt"
      ],
      "Created" : 1633947746,
      "Releases" : [
        {
          "AppstreamId" : "com.lenovo.ThinkPadN2JTF.firmware",
          "RemoteId" : "lvfs",
          "Summary" : "Lenovo ThinkPad X390/ThinkPad T490s Thunderbolt Firmware",
          "Description" : "<p>Lenovo ThinkPad X390/ThinkPad T490s Thunderbolt Firmware</p><p>Fix Thunderbolt SPI ROM Wear out issue.</p>",
          "Version" : "20.00",
          "Filename" : "fc93d9ff3f7ced7eb11d9bf7d8cd009ce408d7d9",
          "Protocol" : "com.intel.thunderbolt",
          "Checksum" : [
            "915a6657f6972937bcb88868e5d8ce1f1ec9fb85"
          ],
          "License" : "LicenseRef-proprietary",
          "Size" : 253952,
          "Created" : 1583253000,
          "Locations" : [
            "https://fwupd.org/downloads/8eef957c95cb6f534448be1faa7bbfc8702d620f64b757d40ee5e0b6b7094c0e-Lenovo-ThinkPad-X390-SystemFirmware-01.cab"
          ],
          "Uri" : "https://fwupd.org/downloads/8eef957c95cb6f534448be1faa7bbfc8702d620f64b757d40ee5e0b6b7094c0e-Lenovo-ThinkPad-X390-SystemFirmware-01.cab",
          "Homepage" : "http://www.lenovo.com",
          "Vendor" : "Lenovo Ltd."
        }
      ]
    },
    {
      "Name" : "USB3.0 Hub",
      "DeviceId" : "54f0d9041b6c5438c7ff825f5139559c5ca1b222",
      "Guid" : [
        "9429e4c7-f053-51d7-9289-75c4ddb14a97",
        "26f33695-3a3e-5c08-badb-f6141390ebd9",
        "10eb3a15-c177-5810-af53-1963e9200e65",
        "60e0a85e-b245-5c84-ba3b-d5bdb540cd47",
        "d91a45a0-4435-59d6-bb6b-9499f4a793c2",
        "022d2f73-4826-546a-ba0f-62579ea848ea"
      ],
      "Summary" : "USB 3.x Hub",
      "Plugin" : "vli",
      "Protocol" : "com.vli.usbhub",
      "Flags" : [
        "updatable",
        "registered",
        "can-verify",
        "can-verify-image",
        "dual-image",
        "self-recovery",
        "add-counterpart-guids"
      ],
      "Vendor" : "VIA Labs, Inc.",
      "VendorId" : "USB:0x2109",
      "Version" : "3.114",
      "VersionFormat" : "bcd",
      "Icons" : [
        "audio-card"
      ],
      "InstallDuration" : 15,
      "Created" : 1633947743
    }
  ]
}

Examples

>>> type(devices)
<class 'insights.parsers.fwupdagent.FwupdagentDevices'>
>>> len(devices["Devices"])
2

class insights.parsers.fwupdagent.FwupdagentSecurity(context, extra_bad_lines=None)

Bases: CommandParser, JSONParser

Class FwupdagentSecurity parses the output of the /bin/fwupdagent get-devices command.

data

The parsed output of the command.

Type:

dict

Sample input data:

{
  "HostSecurityAttributes" : [
    {
      "AppstreamId" : "org.fwupd.hsi.Kernel.Tainted",
      "HsiResult" : "not-tainted",
      "Name" : "Linux kernel",
      "Uri" : "https://fwupd.github.io/hsi.html#org.fwupd.hsi.Kernel.Tainted",
      "Flags" : [
        "success",
        "runtime-issue"
      ]
    },
    {
      "AppstreamId" : "org.fwupd.hsi.EncryptedRam",
      "HsiLevel" : 4,
      "HsiResult" : "not-supported",
      "Name" : "Encrypted RAM",
      "Uri" : "https://fwupd.github.io/hsi.html#org.fwupd.hsi.EncryptedRam"
    }
  ]
}

Examples

>>> type(security)
<class 'insights.parsers.fwupdagent.FwupdagentSecurity'>
>>> len(security["HostSecurityAttributes"])
2