FWUPDMGR

Section: User Commands (1)
Updated: March 2021
Page Index
 

NAME

fwupdmgr - Firmware update manager client utility  

DESCRIPTION

 

Usage:

fwupdmgr [OPTIONā.¦]
activate [DEVICE-ID|GUID]
Activate devices
block-firmware [CHECKSUM]
Blocks a specific firmware from being installed
clear-history
Erase all firmware update history
clear-offline
Clears any updates scheduled to be updated offline
clear-results DEVICE-ID|GUID
Clears the results from the last update
disable-remote REMOTE-ID
Disables a given remote
downgrade [DEVICE-ID|GUID]
Downgrades the firmware on a device
enable-remote REMOTE-ID
Enables a given remote
get-approved-firmware
Gets the list of approved firmware
get-blocked-firmware
Gets the list of blocked firmware
get-details FILE
Gets details about a firmware file
get-devices
Get all devices that support firmware updates
get-history
Show history of firmware updates
get-plugins
Get all enabled plugins registered with the system
get-releases [DEVICE-ID|GUID]
Gets the releases for a device
get-remotes
Gets the configured remotes
get-results DEVICE-ID|GUID
Gets the results from the last update
get-topology
Alias to get-devices
get-updates [DEVICE-ID|GUID]
Gets the list of updates for connected hardware
get-upgrades [DEVICE-ID|GUID]
Alias to get-updates
install FILE [DEVICE-ID|GUID]
Install a firmware file on this hardware
modify-config KEY,VALUE
Modifies a daemon configuration value
modify-remote REMOTE-ID KEY VALUE
Modifies a given remote
refresh [FILE FILE_SIG REMOTE-ID]
Refresh metadata from remote server
reinstall [DEVICE-ID|GUID]
Reinstall current firmware on the device
report-history
Share firmware history with the developers
security
Gets the host security attributes
set-approved-firmware CHECKSUM1[,CHECKSUM2][,CHECKSUM3]
Sets the list of approved firmware
switch-branch [DEVICE-ID|GUID] [BRANCH]
Switch the firmware branch on the device
unblock-firmware [CHECKSUM]
Unblocks a specific firmware from being installed
unlock DEVICE-ID|GUID
Unlocks the device for firmware access
update [DEVICE-ID|GUID]
Updates all firmware to latest versions available
upgrade [DEVICE-ID|GUID]
Alias to update
verify [DEVICE-ID|GUID]
Checks cryptographic hash matches firmware
verify-update [DEVICE-ID|GUID]
Update the stored cryptographic hash with current ROM contents
 

Help Options:

-h, --help
Show help options
 

Application Options:

-v, --verbose
Show extra debugging information
--version
Show client and daemon versions
--offline
Schedule installation for next reboot when possible
--allow-reinstall
Allow reinstalling existing firmware versions
--allow-older
Allow downgrading firmware versions
--allow-branch-switch
Allow switching firmware branch
--force
Force the action by relaxing some runtime checks
-y, --assume-yes
Answer yes to all questions
--sign
Sign the uploaded data with the client certificate
--no-unreported-check
Do not check for unreported history
--no-metadata-check
Do not check for old metadata
--no-remote-check
Do not check if download remotes should be enabled
--no-reboot-check
Do not check for reboot after update
--no-safety-check
Do not perform device safety checks
--no-history
Do not write to the history database
--show-all
Show all results
--disable-ssl-strict
Ignore SSL strict checks when downloading files
--ipfs
Only use IPFS when downloading files
--filter
Filter with a set of device flags using a ~ prefix to exclude, e.g. 'internal,~needs-reboot'
--ignore-power
Ignore requirement of external power source

This tool allows an administrator to query and control the fwupd daemon, allowing them to perform actions such as installing or downgrading firmware.  

SCRIPTING

A variety of client tools are provided by fwupd. Not all tools are suggested to be scripted.

fwupdmgr is a command line fwupd client intended to be used interactively. The output between versions of fwupd is not guaranteed to be stable. Commands that succesfully execute will return "0". Commands that have no actions but succesfully execute will return "2".

fwupdagent is a command line fwupd client intended to be used by scripts. The output is JSON and guaranteed to be stable. Commands that succesfully execute will return "0".


 

Index

NAME
DESCRIPTION
Usage:
Help Options:
Application Options:
SCRIPTING