version 1.9, 2021/12/26 18:08:53 |
version 1.11, 2022/01/07 00:38:06 |
|
|
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. |
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. |
.\" |
.\" |
.Dd $Mdocdate$ |
.Dd $Mdocdate$ |
.Dt FW_UPDATE 1 |
.Dt FW_UPDATE 8 |
.Os |
.Os |
.Sh NAME |
.Sh NAME |
.Nm fw_update |
.Nm fw_update |
.Nd install non-free firmware packages |
.Nd install non-free firmware packages |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm |
.Nm |
.Op Fl adinv |
.Op Fl adFnv |
.Op Fl p Ar path |
.Op Fl p Ar path |
.Op Ar driver ... |
.Op Ar driver | file ... |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
The |
The |
.Nm |
.Nm |
|
|
It is an error to specify this option with any |
It is an error to specify this option with any |
.Ar driver |
.Ar driver |
arguments. |
arguments. |
|
This is enabled by default unless drivers, files or |
|
.Fl d |
|
are specified. |
.It Fl d |
.It Fl d |
Delete firmware for |
Delete firmware for |
.Ar driver . |
.Ar driver . |
|
|
If used in conjunction with |
If used in conjunction with |
.Fl a , |
.Fl a , |
delete firmware for all drivers. |
delete firmware for all drivers. |
.It Fl i |
.It Fl F |
Display information about firmware which is installed or missing, and whether |
Download drivers only. |
it appears to be required by a driver. |
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 |
.It Fl n |
Dry run. |
Dry run. |
Do not actually install or update any firmware packages; |
Do not actually install or update any firmware packages; |
|
|
The files are in the format required by |
The files are in the format required by |
.Xr pkg_add 1 , |
.Xr pkg_add 1 , |
but direct use of pkg_add is discouraged. |
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 |
.Sh SEE ALSO |
.Xr pkg_add 1 , |
.Xr pkg_add 1 , |
.Xr dmesg 8 |
.Xr dmesg 8 |
|
|
.Nm |
.Nm |
program was designed by |
program was designed by |
.An Alexander Hall Aq Mt alexander@beard.se ; |
.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 . |
.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 . |