=================================================================== RCS file: /cvs/openbsd/fw_update/fw_install.8,v retrieving revision 1.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- openbsd/fw_update/fw_install.8 2021/12/26 18:08:53 1.9 +++ openbsd/fw_update/fw_install.8 2021/12/26 18:59:20 1.10 @@ -1,4 +1,4 @@ -.\" $OpenBSD: fw_install.8,v 1.9 2021/12/26 18:08:53 afresh1 Exp $ +.\" $OpenBSD: fw_install.8,v 1.10 2021/12/26 18:59:20 afresh1 Exp $ .\" .\" Copyright (c) 2011 Alexander Hall .\" @@ -15,16 +15,16 @@ .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" .Dd $Mdocdate: December 26 2021 $ -.Dt FW_UPDATE 1 +.Dt FW_UPDATE 8 .Os .Sh NAME .Nm fw_update .Nd install non-free firmware packages .Sh SYNOPSIS .Nm -.Op Fl adinv +.Op Fl adDnv .Op Fl p Ar path -.Op Ar driver ... +.Op Ar driver | file ... .Sh DESCRIPTION The .Nm @@ -51,6 +51,9 @@ It is an error to specify this option with any .Ar driver arguments. +This is enabled by default unless drivers, files or +.Fl d +are specified. .It Fl d Delete firmware for .Ar driver . @@ -59,9 +62,13 @@ If used in conjunction with .Fl a , delete firmware for all drivers. -.It Fl i -Display information about firmware which is installed or missing, and whether -it appears to be required by a driver. +.It Fl D +Download drivers only. +By default downloads to the current directory. +Secifying a URL with +.Fl p +downloads from that URL, +specifying a path downloads to that directory. .It Fl n Dry run. Do not actually install or update any firmware packages; @@ -81,6 +88,21 @@ The files are in the format required by .Xr pkg_add 1 , but direct use of pkg_add is discouraged. +.Sh ENVIRONMENT +.Bl -tag -width DESTDIRXXX +.It Ev DESTDIR +The root of the system to install into. +.El +.Sh FILES +.Bl -tag -width Ds +.It Pa ${DESTDIR}/usr/share/misc/firmware_patterns +A list of patterns used to detect needed firmware from the +.Xr dmesg 8 . +.It Pa ${DESTDIR}/etc/signify/openbsd-XX-fw.pub +Used with +.Xr signify 1 +to verify downloaded firmware files. +.El .Sh SEE ALSO .Xr pkg_add 1 , .Xr dmesg 8 @@ -90,5 +112,7 @@ .Nm program was designed by .An Alexander Hall Aq Mt alexander@beard.se ; -the current code was written by +it was then replaced with a perl version by .An Marc Espie Aq Mt espie@openbsd.org . +It was rewritten to be able to be run from the installer by +.An Andrew Hewus Fresh Aq Mt afresh1@openbsd.org .