Scroll to navigation

FWUPDMGR(1) User Commands FWUPDMGR(1)

NAME

fwupdmgr - Firmware update manager client utility

DESCRIPTION

Usage:

fwupdmgr [OPTION?]
Activate devices
Blocks a specific firmware from being installed
Erase all firmware update history
Clears any updates scheduled to be updated offline
Clears the results from the last update
Disables a given remote
Downgrades the firmware on a device
Enables a given remote
Gets the list of approved firmware
Gets the list of blocked firmware
Gets details about a firmware file
Get all devices that support firmware updates
Show history of firmware updates
Get all enabled plugins registered with the system
Gets the releases for a device
Gets the configured remotes
Gets the results from the last update
Alias to get-devices
Gets the list of updates for connected hardware
Alias to get-updates
Install a firmware file on this hardware
Modifies a daemon configuration value
Modifies a given remote
Refresh metadata from remote server
Reinstall current firmware on the device
Share firmware history with the developers
Gets the host security attributes
Sets the list of approved firmware
Switch the firmware branch on the device
Unblocks a specific firmware from being installed
Unlocks the device for firmware access
Updates all firmware to latest versions available
Alias to update
Checks cryptographic hash matches firmware
Update the stored cryptographic hash with current ROM contents

Help Options:

Show help options

Application Options:

Show extra debugging information
Show client and daemon versions
Schedule installation for next reboot when possible
Allow reinstalling existing firmware versions
Allow downgrading firmware versions
Allow switching firmware branch
Force the action by relaxing some runtime checks
Answer yes to all questions
Sign the uploaded data with the client certificate
Do not check for unreported history
Do not check for old metadata
Do not check if download remotes should be enabled
Do not check for reboot after update
Do not perform device safety checks
Do not write to the history database
Show all results
Ignore SSL strict checks when downloading files
Only use IPFS when downloading files
Filter with a set of device flags using a ~ prefix to exclude, e.g. 'internal,~needs-reboot'
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".

September 2021 fwupdmgr 1.5.7