When running fwupd reads some variables from your environment and changes some behavior. This might be useful for debugging, or to make fwupd run somewhere with a non-standard filesystem layout.
fwupdmgr and fwupdtool
DISABLE_SSL_STRICTdisables strict SSL certificate checking, which may make downloading files work when using some antisocial corporate firewalls.FWUPD_CURL_VERBOSEshows more information when downloading filesFWUPD_DEVICE_TESTS_BASE_URIsets the base URI when downloading firmware for the device-testsFWUPD_SUPPORTEDoverrides the-Dsupported_buildmeson option at runtimeFWUPD_VERBOSEis set when running--verboseFWUPD_BACKEND_VERBOSEcan be used to show detailed plugin and backend debuggingFWUPD_XMLB_VERBOSEcan be set to show Xmlb silo regeneration and quirk matchesFWUPD_DBUS_SOCKETis used to set the socket filename if running without a dbus-daemonFWUPD_DOWNLOAD_VERBOSEcan be used to show wget or curl outputFWUPD_PROFILEcan be used to set the profile traceback threshold value in msFWUPD_FUZZER_RUNNINGif the firmware format is being fuzzed- standard glibc variables like
LANGare also honored for CLI tools that are translated - libcurl respects the session proxy, e.g.
http_proxy,all_proxy,sftp_proxyandno_proxy
daemon
FWUPD_MACHINE_KINDcan be used to override the detected machine type, e.g.physical,virtual, orcontainerFWUPD_HOST_EMULATEcan be used to load test data from/usr/share/fwupd/host-emulate.d, e.g.thinkpad-p1-no-iommu.json.gz
Self Tests
CI_NETWORKif CI is running with network accessTPM_SERVER_RUNNINGif an emulated TPM is running
Shared libfwupdplugin
FU_HID_DEVICE_VERBOSEshows HID trafficFU_SREC_FIRMWARE_VERBOSEshows more information about parsing Motorola S-record filesFU_IHEX_FIRMWARE_VERBOSEshows more information about parsing Intel hex filesFU_UDEV_DEVICE_DEBUGshows more information about UDEV devices, including parentsFU_USB_DEVICE_DEBUGshows more information about USB devicesFU_MEI_DEVICE_DEBUGshows MEI reads and writesFWUPD_DEVICE_LIST_VERBOSEdisplay devices being added and removed from the listFWUPD_PROBE_VERBOSEdump the detected devices to the console, even if not supported by fwupdFWUPD_BIOS_SETTING_VERBOSEbe verbose while parsing BIOS settingsFWUPD_EFI_SIGNATURE_VERBOSEbe verbose while parsing EFI signatures
Plugins
Most plugins read a plugin-specific runtime key to increase verbosity more than the usual VERBOSE.
This can be also used when using fwupdtool e.g. using --plugin-verbose=dell will set the
environment variable of FWUPD_DELL_VERBOSE automatically.
Other variables, include:
FWUPD_DELL_FAKE_SMBIOSif set, use fake SMBIOS information for testsFWUPD_FORCE_TPM2ignores a TPM 1.2 device detected in the TPM self testsFWUPD_PLUGIN_TESTused by the test plugin to pass data out-of-band to the loaderFWUPD_REDFISH_SELF_TESTif set, do destructive tests on the actual device BMCFWUPD_REDFISH_SMBIOS_DATAuse this filename to emulate a specific SMBIOS blobFWUPD_SOLOKEY_EMULATEemulates a fake device for testingFWUPD_SUPERIO_DISABLE_MIRRORdisables the e-flash fixup to get byte-accurate hardware dumpsFWUPD_SUPERIO_RECOVERallow recovery of a corrupted SuperIO by hardcoding the device sizeFWUPD_TEST_PLUGIN_XMLused by the test plugin to load XML state out-of-band before startupFWUPD_UEFI_CAPSULE_RECREATE_COD_DATAif set, write the files in the example COD tree in srcdirFWUPD_UEFI_TESTused by the UEFI plugins to disable specific sanity checks during self testsFWUPD_WAC_EMULATEemulates a fake device for testing
File system overrides
These are not fully documented here, see https://github.com/fwupd/fwupd/blob/main/libfwupdplugin/fu-common.c for details.
CACHE_DIRECTORYCONFIGURATION_DIRECTORYFWUPD_ACPITABLESDIRFWUPD_DATADIRFWUPD_DATADIR_QUIRKSFWUPD_EFIAPPDIRFWUPD_FIRMWARESEARCHFWUPD_LIBDIR_PKGFWUPD_LOCALSTATEDIRFWUPD_LOCALSTATEDIR_QUIRKSFWUPD_OFFLINE_TRIGGERFWUPD_PROCFSFWUPD_SYSCONFDIRFWUPD_SYSFSDMIDIRFWUPD_SYSFSDRIVERDIRFWUPD_SYSFSFWATTRIBDIRFWUPD_SYSFSFWDIRFWUPD_SYSFSSECURITYDIRFWUPD_SYSFSTPMDIRFWUPD_UEFI_ESP_PATHHOMERUNTIME_DIRECTORYSNAPSNAP_USER_DATASTATE_DIRECTORY