NAME

fw_update — install non-free firmware packages

SYNOPSIS

DESCRIPTION

The fw_update utility installs, updates, or deletes firmware packages for driver from the Internet. If no driver is specified, the fw_update utility tries to determine which firmware is needed on the system.

Since firmware with an acceptable license is already present in OpenBSD, fw_update exists purely to deal with firmware that may not be freely distributed with OpenBSD.

The options are as follows:

-a

Install or update firmware for all drivers. It is an error to specify this option with any driver arguments. This is enabled by default unless drivers, files or -d are specified.

-d

Delete firmware for driver. If used without parameters, delete all firmware that is not required by a driver. If used in conjunction with -a, delete firmware for all drivers.

-F

Download firmware only. By default downloads to the current directory. Specifying a URL with -p downloads from that URL, specifying a path downloads to that directory.

-n

Dry run. Do not actually install or update any firmware packages; just report the steps that would be taken.

-p path

Use the firmware found at package repository path, being either a local directory or a URL, instead of the default location.

-v

Turn on verbose output. This flag can be specified multiple times for increased verbosity.

Firmware is downloaded from release-specific directories at http://firmware.openbsd.org/firmware/. The files are in the format required by pkg_add(1), but direct use of pkg_add is discouraged.

ENVIRONMENT

DESTDIR

The root of the system to install into.

FILES

${DESTDIR}/usr/share/misc/firmware_patterns

A list of patterns used to detect needed firmware from the dmesg(8).

${DESTDIR}/etc/signify/openbsd-XX-fw.pub

Used with signify(1) to verify downloaded firmware files.

SEE ALSO

pkg_add(1), dmesg(8)

AUTHORS

The fw_update program was designed by Alexander Hall <alexander@beard.se>; it was then replaced with a perl version by Marc Espie <espie@openbsd.org>. It was rewritten to be able to be run from the installer by Andrew Hewus Fresh <afresh1@openbsd.org>.