.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.48.3.
.TH FWUPDMGR "1" "May 2021" "fwupdmgr 1.5.7" "User Commands"
.SH NAME
fwupdmgr \- Firmware update manager client utility
.SH DESCRIPTION
.SS "Usage:"
.IP
fwupdmgr [OPTION?]
.TP
activate [DEVICE\-ID|GUID]
Activate devices
.TP
block\-firmware [CHECKSUM]
Blocks a specific firmware from being installed
.TP
clear\-history
Erase all firmware update history
.TP
clear\-offline
Clears any updates scheduled to be updated offline
.TP
clear\-results DEVICE\-ID|GUID
Clears the results from the last update
.TP
disable\-remote REMOTE\-ID
Disables a given remote
.TP
downgrade [DEVICE\-ID|GUID]
Downgrades the firmware on a device
.TP
enable\-remote REMOTE\-ID
Enables a given remote
.TP
get\-approved\-firmware
Gets the list of approved firmware
.TP
get\-blocked\-firmware
Gets the list of blocked firmware
.TP
get\-details FILE
Gets details about a firmware file
.TP
get\-devices
Get all devices that support firmware updates
.TP
get\-history
Show history of firmware updates
.TP
get\-plugins
Get all enabled plugins registered with the system
.TP
get\-releases [DEVICE\-ID|GUID]
Gets the releases for a device
.TP
get\-remotes
Gets the configured remotes
.TP
get\-results DEVICE\-ID|GUID
Gets the results from the last update
.TP
get\-topology
Alias to get\-devices
.TP
get\-updates [DEVICE\-ID|GUID]
Gets the list of updates for connected hardware
.TP
get\-upgrades [DEVICE\-ID|GUID]
Alias to get\-updates
.TP
install FILE [DEVICE\-ID|GUID]
Install a firmware file on this hardware
.TP
modify\-config KEY,VALUE
Modifies a daemon configuration value
.TP
modify\-remote REMOTE\-ID KEY VALUE
Modifies a given remote
.TP
refresh [FILE FILE_SIG REMOTE\-ID]
Refresh metadata from remote server
.TP
reinstall [DEVICE\-ID|GUID]
Reinstall current firmware on the device
.TP
report\-history
Share firmware history with the developers
.TP
security
Gets the host security attributes
.TP
set\-approved\-firmware CHECKSUM1[,CHECKSUM2][,CHECKSUM3]
Sets the list of approved firmware
.TP
switch\-branch [DEVICE\-ID|GUID] [BRANCH]
Switch the firmware branch on the device
.TP
unblock\-firmware [CHECKSUM]
Unblocks a specific firmware from being installed
.TP
unlock DEVICE\-ID|GUID
Unlocks the device for firmware access
.TP
update [DEVICE\-ID|GUID]
Updates all firmware to latest versions available
.TP
upgrade [DEVICE\-ID|GUID]
Alias to update
.TP
verify [DEVICE\-ID|GUID]
Checks cryptographic hash matches firmware
.TP
verify\-update [DEVICE\-ID|GUID]
Update the stored cryptographic hash with current ROM contents
.SS "Help Options:"
.TP
\fB\-h\fR, \fB\-\-help\fR
Show help options
.SS "Application Options:"
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Show extra debugging information
.TP
\fB\-\-version\fR
Show client and daemon versions
.TP
\fB\-\-offline\fR
Schedule installation for next reboot when possible
.TP
\fB\-\-allow\-reinstall\fR
Allow reinstalling existing firmware versions
.TP
\fB\-\-allow\-older\fR
Allow downgrading firmware versions
.TP
\fB\-\-allow\-branch\-switch\fR
Allow switching firmware branch
.TP
\fB\-\-force\fR
Force the action by relaxing some runtime checks
.TP
\fB\-y\fR, \fB\-\-assume\-yes\fR
Answer yes to all questions
.TP
\fB\-\-sign\fR
Sign the uploaded data with the client certificate
.TP
\fB\-\-no\-unreported\-check\fR
Do not check for unreported history
.TP
\fB\-\-no\-metadata\-check\fR
Do not check for old metadata
.TP
\fB\-\-no\-remote\-check\fR
Do not check if download remotes should be enabled
.TP
\fB\-\-no\-reboot\-check\fR
Do not check for reboot after update
.TP
\fB\-\-no\-safety\-check\fR
Do not perform device safety checks
.TP
\fB\-\-no\-history\fR
Do not write to the history database
.TP
\fB\-\-show\-all\fR
Show all results
.TP
\fB\-\-disable\-ssl\-strict\fR
Ignore SSL strict checks when downloading files
.TP
\fB\-\-ipfs\fR
Only use IPFS when downloading files
.TP
\fB\-\-filter\fR
Filter with a set of device flags using a ~ prefix to exclude, e.g. 'internal,~needs\-reboot'
.TP
\fB\-\-ignore\-power\fR
Ignore requirement of external power source
.PP
This tool allows an administrator to query and control the fwupd daemon, allowing them to perform actions such as installing or downgrading firmware.
.SH 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".