1FWUPDMGR(1)                      User Commands                     FWUPDMGR(1)
2
3
4

NAME

6       fwupdmgr - Firmware update manager client utility
7

DESCRIPTION

9   Usage:
10              fwupdmgr [OPTIONâ.¦]
11
12       activate [DEVICE-ID|GUID]
13              Activate devices
14
15       block-firmware [CHECKSUM]
16              Blocks a specific firmware from being installed
17
18       clear-history
19              Erase all firmware update history
20
21       clear-offline
22              Clears any updates scheduled to be updated offline
23
24       clear-results DEVICE-ID|GUID
25              Clears the results from the last update
26
27       disable-remote REMOTE-ID
28              Disables a given remote
29
30       downgrade [DEVICE-ID|GUID]
31              Downgrades the firmware on a device
32
33       enable-remote REMOTE-ID
34              Enables a given remote
35
36       get-approved-firmware
37              Gets the list of approved firmware
38
39       get-blocked-firmware
40              Gets the list of blocked firmware
41
42       get-details FILE
43              Gets details about a firmware file
44
45       get-devices
46              Get all devices that support firmware updates
47
48       get-history
49              Show history of firmware updates
50
51       get-plugins
52              Get all enabled plugins registered with the system
53
54       get-releases [DEVICE-ID|GUID]
55              Gets the releases for a device
56
57       get-remotes
58              Gets the configured remotes
59
60       get-results DEVICE-ID|GUID
61              Gets the results from the last update
62
63       get-topology
64              Alias to get-devices
65
66       get-updates [DEVICE-ID|GUID]
67              Gets the list of updates for connected hardware
68
69       get-upgrades [DEVICE-ID|GUID]
70              Alias to get-updates
71
72       install FILE [DEVICE-ID|GUID]
73              Install a firmware file on this hardware
74
75       modify-config KEY,VALUE
76              Modifies a daemon configuration value
77
78       modify-remote REMOTE-ID KEY VALUE
79              Modifies a given remote
80
81       refresh [FILE FILE_SIG REMOTE-ID]
82              Refresh metadata from remote server
83
84       reinstall [DEVICE-ID|GUID]
85              Reinstall current firmware on the device
86
87       report-history
88              Share firmware history with the developers
89
90       security
91              Gets the host security attributes
92
93       set-approved-firmware CHECKSUM1[,CHECKSUM2][,CHECKSUM3]
94              Sets the list of approved firmware
95
96       switch-branch [DEVICE-ID|GUID] [BRANCH]
97              Switch the firmware branch on the device
98
99       unblock-firmware [CHECKSUM]
100              Unblocks a specific firmware from being installed
101
102       unlock DEVICE-ID|GUID
103              Unlocks the device for firmware access
104
105       update [DEVICE-ID|GUID]
106              Updates all firmware to latest versions available
107
108       upgrade [DEVICE-ID|GUID]
109              Alias to update
110
111       verify [DEVICE-ID|GUID]
112              Checks cryptographic hash matches firmware
113
114       verify-update [DEVICE-ID|GUID]
115              Update the stored cryptographic hash with current ROM contents
116
117   Help Options:
118       -h, --help
119              Show help options
120
121   Application Options:
122       -v, --verbose
123              Show extra debugging information
124
125       --version
126              Show client and daemon versions
127
128       --offline
129              Schedule installation for next reboot when possible
130
131       --allow-reinstall
132              Allow reinstalling existing firmware versions
133
134       --allow-older
135              Allow downgrading firmware versions
136
137       --allow-branch-switch
138              Allow switching firmware branch
139
140       --force
141              Force the action by relaxing some runtime checks
142
143       -y, --assume-yes
144              Answer yes to all questions
145
146       --sign Sign the uploaded data with the client certificate
147
148       --no-unreported-check
149              Do not check for unreported history
150
151       --no-metadata-check
152              Do not check for old metadata
153
154       --no-remote-check
155              Do not check if download remotes should be enabled
156
157       --no-reboot-check
158              Do not check for reboot after update
159
160       --no-safety-check
161              Do not perform device safety checks
162
163       --no-history
164              Do not write to the history database
165
166       --show-all
167              Show all results
168
169       --disable-ssl-strict
170              Ignore SSL strict checks when downloading files
171
172       --ipfs Only use IPFS when downloading files
173
174       --filter
175              Filter  with  a set of device flags using a ~ prefix to exclude,
176              e.g. 'internal,~needs-reboot'
177
178       --ignore-power
179              Ignore requirement of external power source
180
181       This tool allows an administrator to query and control the  fwupd  dae‐
182       mon, allowing them to perform actions such as installing or downgrading
183       firmware.
184

SCRIPTING

186       A variety of client tools are provided by fwupd.   Not  all  tools  are
187       suggested to be scripted.
188
189       fwupdmgr  is  a  command line fwupd client intended to be used interac‐
190       tively. The output between versions of fwupd is not  guaranteed  to  be
191       stable.  Commands  that  succesfully  execute will return "0". Commands
192       that have no actions but succesfully execute will return "2".
193
194       fwupdagent is a command line  fwupd  client  intended  to  be  used  by
195       scripts.  The output is JSON and guaranteed to be stable. Commands that
196       succesfully execute will return "0".
197
198
199
200fwupdmgr 1.5.8                    March 2021                       FWUPDMGR(1)