Return to fw_install.8 CVS log

Up to [local] / openbsd / fw_update

Annotation of openbsd/fw_update/fw_install.8, Revision 1.9

1.9     ! afresh1     1: .\" $OpenBSD: fw_update.1,v 1.5 2020/07/24 16:40:47 jmc Exp $
1.1       afresh1     2: .\"
1.9     ! afresh1     3: .\" Copyright (c) 2011 Alexander Hall <alexander@beard.se>
1.1       afresh1     4: .\"
                      5: .\" Permission to use, copy, modify, and distribute this software for any
                      6: .\" purpose with or without fee is hereby granted, provided that the above
                      7: .\" copyright notice and this permission notice appear in all copies.
                      8: .\"
                      9: .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
                     10: .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
                     11: .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
                     12: .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
                     13: .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
                     14: .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
                     15: .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
                     16: .\"
1.9     ! afresh1    17: .Dd $Mdocdate: July 24 2020 $
        !            18: .Dt FW_UPDATE 1
1.1       afresh1    19: .Os
                     20: .Sh NAME
1.9     ! afresh1    21: .Nm fw_update
        !            22: .Nd install non-free firmware packages
1.1       afresh1    23: .Sh SYNOPSIS
                     24: .Nm
1.9     ! afresh1    25: .Op Fl adinv
1.6       afresh1    26: .Op Fl p Ar path
1.9     ! afresh1    27: .Op Ar driver ...
1.1       afresh1    28: .Sh DESCRIPTION
                     29: The
                     30: .Nm
1.9     ! afresh1    31: utility installs, updates, or deletes firmware packages for
        !            32: .Ar driver
        !            33: from the Internet.
        !            34: If no
        !            35: .Ar driver
        !            36: is specified, the
        !            37: .Nm
        !            38: utility tries to determine which firmware is needed on the system.
        !            39: .Pp
        !            40: Since firmware with an acceptable license is already present in
        !            41: .Ox ,
        !            42: .Nm
        !            43: exists purely to deal with firmware that may not be freely
        !            44: distributed with
        !            45: .Ox .
1.1       afresh1    46: .Pp
                     47: The options are as follows:
                     48: .Bl -tag -width Ds
1.5       afresh1    49: .It Fl a
1.9     ! afresh1    50: Install or update firmware for all drivers.
        !            51: It is an error to specify this option with any
        !            52: .Ar driver
        !            53: arguments.
1.3       afresh1    54: .It Fl d
1.9     ! afresh1    55: Delete firmware for
        !            56: .Ar driver .
        !            57: If used without parameters, delete all firmware that is not required by
        !            58: a driver.
        !            59: If used in conjunction with
        !            60: .Fl a ,
        !            61: delete firmware for all drivers.
        !            62: .It Fl i
        !            63: Display information about firmware which is installed or missing, and whether
        !            64: it appears to be required by a driver.
1.8       afresh1    65: .It Fl n
1.9     ! afresh1    66: Dry run.
        !            67: Do not actually install or update any firmware packages;
        !            68: just report the steps that would be taken.
1.6       afresh1    69: .It Fl p Ar path
                     70: Use the firmware found at package repository
                     71: .Ar path ,
                     72: being either a local directory or a URL,
                     73: instead of the default location.
1.2       afresh1    74: .It Fl v
1.9     ! afresh1    75: Turn on verbose output.
        !            76: This flag can be specified multiple times for increased verbosity.
1.4       afresh1    77: .El
1.1       afresh1    78: .Pp
1.9     ! afresh1    79: Firmware is downloaded from release-specific directories at
        !            80: .Lk http://firmware.openbsd.org/firmware/ .
        !            81: The files are in the format required by
        !            82: .Xr pkg_add 1 ,
        !            83: but direct use of pkg_add is discouraged.
1.1       afresh1    84: .Sh SEE ALSO
1.9     ! afresh1    85: .Xr pkg_add 1 ,
1.1       afresh1    86: .Xr dmesg 8
                     87: .Sh AUTHORS
1.9     ! afresh1    88: .An -nosplit
1.1       afresh1    89: The
                     90: .Nm
1.9     ! afresh1    91: program was designed by
        !            92: .An Alexander Hall Aq Mt alexander@beard.se ;
        !            93: the current code was written by
        !            94: .An Marc Espie Aq Mt espie@openbsd.org .