Return to fw_install.8 CVS log

Up to [local] / openbsd / fw_update

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

1.1     ! afresh1     1: .\" $OpenBSD$
        !             2: .\"
        !             3: .\" Copyright (c) 2021 Andrew Hewus Fresh <afresh1@openbsd.org>
        !             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: .\"
        !            17: .Dd $Mdocdate: December 19 2021 $
        !            18: .Dt FW_INSTALL 8
        !            19: .Os
        !            20: .Sh NAME
        !            21: .Nm fw_install
        !            22: .Nd download and install non-free firmware packages
        !            23: .Sh SYNOPSIS
        !            24: .Nm
        !            25: .Op Fl D | L
        !            26: .Op Ar driver | file ...
        !            27: .Sh DESCRIPTION
        !            28: The
        !            29: .Nm
        !            30: utility downloads and installs non-free firmware packages.
        !            31: It is designed as a version of
        !            32: .Xr fw_update 1
        !            33: that can run in the limited environment of the installer.
        !            34: .Pp
        !            35: The options are as follows:
        !            36: .Bl -tag -width Ds
        !            37: .It Fl D
        !            38: Download firmware packages to the current working directory,
        !            39: without installing them.
        !            40: .It Fl L
        !            41: Install firmware from a local copy in the current directory.
        !            42: .El
        !            43: .Pp
        !            44: Additional arguments are taken as
        !            45: device names for which filenames will be looked up
        !            46: or as filenames of firmware packages to be installed.
        !            47: If no additional arguments are given,
        !            48: .Nm
        !            49: searches
        !            50: .Xr dmesg 8
        !            51: for
        !            52: .Pa firmware_patterns
        !            53: to find matching drivers.
        !            54: .Sh ENVIRONMENT
        !            55: .Bl -tag -width DESTDIRXXX
        !            56: .It Ev DESTDIR
        !            57: The root of the system to install into.
        !            58: .El
        !            59: .Sh FILES
        !            60: .Bl -tag -width Ds
        !            61: .It Pa ${DESTDIR}/usr/share/misc/firmware_patterns
        !            62: A list of patterns used to detect needed firmware from the
        !            63: .Xr dmesg 8 .
        !            64: .It Pa ${DESTDIR}/etc/signify/openbsd-XX-fw.pub
        !            65: Used with
        !            66: .Xr signify 1
        !            67: to verify downloaded firmware files.
        !            68: .El
        !            69: .Sh EXIT STATUS
        !            70: .Ex -std
        !            71: .\" .Sh EXAMPLES
        !            72: .Sh SEE ALSO
        !            73: .Xr fw_update 1 ,
        !            74: .Xr dmesg 8
        !            75: .\" .Sh STANDARDS
        !            76: .Sh AUTHORS
        !            77: The
        !            78: .Nm
        !            79: program was designed and written by
        !            80: .An Andrew Hewus Fresh Aq Mt afresh1@openbsd.org
        !            81: as a limited version of
        !            82: .Xr fw_update 1 .
        !            83: .\" .Sh CAVEATS