man-pages/man1/fwupdmgr.1.html
2021-03-31 01:06:50 +01:00

148 lines
4.6 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of FWUPDMGR</TITLE>
</HEAD><BODY>
<H1>FWUPDMGR</H1>
Section: User Commands (1)<BR>Updated: June 2020<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
fwupdmgr - Firmware update manager client utility
<A NAME="lbAC">&nbsp;</A>
<H2>DESCRIPTION</H2>
<A NAME="lbAD">&nbsp;</A>
<H3>Usage:</H3>
<DL COMPACT>
<DT id="1"><DD>
fwupdmgr [OPTION?]
<DT id="2">activate [DEVICE-ID]<DD>
Activate devices
<DT id="3">clear-history<DD>
Erase all firmware update history
<DT id="4">clear-offline<DD>
Clears any updates scheduled to be updated offline
<DT id="5">clear-results DEVICE-ID<DD>
Clears the results from the last update
<DT id="6">disable-remote REMOTE-ID<DD>
Disables a given remote
<DT id="7">downgrade [DEVICE-ID]<DD>
Downgrades the firmware on a device
<DT id="8">enable-remote REMOTE-ID<DD>
Enables a given remote
<DT id="9">get-approved-firmware<DD>
Gets the list of approved firmware.
<DT id="10">get-details FILE<DD>
Gets details about a firmware file
<DT id="11">get-devices<DD>
Get all devices that support firmware updates
<DT id="12">get-history<DD>
Show history of firmware updates
<DT id="13">get-releases [DEVICE-ID]<DD>
Gets the releases for a device
<DT id="14">get-remotes<DD>
Gets the configured remotes
<DT id="15">get-results DEVICE-ID<DD>
Gets the results from the last update
<DT id="16">get-topology<DD>
Alias to get-devices
<DT id="17">get-updates<DD>
Gets the list of updates for connected hardware
<DT id="18">get-upgrades<DD>
Alias to get-updates
<DT id="19">install FILE [DEVICE-ID]<DD>
Install a firmware file on this hardware
<DT id="20">modify-config KEY,VALUE<DD>
Modifies a daemon configuration value.
<DT id="21">modify-remote REMOTE-ID KEY VALUE<DD>
Modifies a given remote
<DT id="22">refresh [FILE FILE_SIG REMOTE-ID]<DD>
Refresh metadata from remote server
<DT id="23">reinstall [DEVICE-ID]<DD>
Reinstall current firmware on the device.
<DT id="24">report-history<DD>
Share firmware history with the developers
<DT id="25">set-approved-firmware CHECKSUM1[,CHECKSUM2][,CHECKSUM3]<DD>
Sets the list of approved firmware.
<DT id="26">unlock DEVICE-ID<DD>
Unlocks the device for firmware access
<DT id="27">update [DEVICE-ID]<DD>
Updates all firmware to latest versions available
<DT id="28">upgrade [DEVICE-ID]<DD>
Alias to update
<DT id="29">verify [DEVICE-ID]<DD>
Checks cryptographic hash matches firmware
<DT id="30">verify-update [DEVICE-ID]<DD>
Update the stored cryptographic hash with current ROM contents
</DL>
<A NAME="lbAE">&nbsp;</A>
<H3>Help Options:</H3>
<DL COMPACT>
<DT id="31"><B>-h</B>, <B>--help</B><DD>
Show help options
</DL>
<A NAME="lbAF">&nbsp;</A>
<H3>Application Options:</H3>
<DL COMPACT>
<DT id="32"><B>-v</B>, <B>--verbose</B><DD>
Show extra debugging information
<DT id="33"><B>--version</B><DD>
Show client and daemon versions
<DT id="34"><B>--offline</B><DD>
Schedule installation for next reboot when possible
<DT id="35"><B>--allow-reinstall</B><DD>
Allow reinstalling existing firmware versions
<DT id="36"><B>--allow-older</B><DD>
Allow downgrading firmware versions
<DT id="37"><B>--force</B><DD>
Override warnings and force the action
<DT id="38"><B>-y</B>, <B>--assume-yes</B><DD>
Answer yes to all questions
<DT id="39"><B>--sign</B><DD>
Sign the uploaded data with the client certificate
<DT id="40"><B>--no-unreported-check</B><DD>
Do not check for unreported history
<DT id="41"><B>--no-metadata-check</B><DD>
Do not check for old metadata
<DT id="42"><B>--no-reboot-check</B><DD>
Do not check for reboot after update
<DT id="43"><B>--no-safety-check</B><DD>
Do not perform device safety checks
<DT id="44"><B>--no-history</B><DD>
Do not write to the history database
<DT id="45"><B>--show-all-devices</B><DD>
Show devices that are not updatable
<DT id="46"><B>--disable-ssl-strict</B><DD>
Ignore SSL strict checks when downloading files
<DT id="47"><B>--filter</B><DD>
Filter with a set of device flags using a ~ prefix to exclude, e.g. 'internal,~needs-reboot'
</DL>
<P>
This tool allows an administrator to query and control the fwupd daemon, allowing them to perform actions such as installing or downgrading firmware.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="48"><A HREF="#lbAB">NAME</A><DD>
<DT id="49"><A HREF="#lbAC">DESCRIPTION</A><DD>
<DL>
<DT id="50"><A HREF="#lbAD">Usage:</A><DD>
<DT id="51"><A HREF="#lbAE">Help Options:</A><DD>
<DT id="52"><A HREF="#lbAF">Application Options:</A><DD>
</DL>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:12 GMT, March 31, 2021
</BODY>
</HTML>