Annotation of openbsd/fw_update/fw_install.1, 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$
! 18: .Dt FW_INSTALL 1
! 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 DL
! 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 envrionment of the installer.
! 34: .Pp
! 35: The options are as follows:
! 36: .Bl -tag -width Ds
! 37: .It -D
! 38: Downloads firmware packages to the current directory without installing.
! 39: .It -L
! 40: Installs firmware from a local copy the current directory.
! 41: .El
! 42: .Pp
! 43: Additional arguments are taken as
! 44: device names for which filenames will be looked up
! 45: or as filenames of firmware packages be installed.
! 46: If no additional arguments are given,
! 47: .Nm
! 48: searches
! 49: .Xr dmesg 8
! 50: for
! 51: .Pa firmware_patterns
! 52: to find matching drivers.
! 53: .Sh ENVIRONMENT
! 54: .Bl -tag -width Ds
! 55: .It Ev DESTDIR
! 56: The root of the system to install into
! 57: .El
! 58: .Sh FILES
! 59: .Bl -tag -width Ds
! 60: .It Pa ${DESTDIR}/usr/share/misc/firmware_patterns
! 61: A list of patterns used to detect needed firmware from the
! 62: .Xr dmesg 8 .
! 63: .It Pa ${DESTDIR}/etc/signify/openbsd-XX-fw.pub
! 64: Used with
! 65: .Xr signify 1
! 66: to verify downloaded firmware files.
! 67: .El
! 68: .Sh EXIT STATUS
! 69: .Ex -std
! 70: .\" .Sh EXAMPLES
! 71: .Sh SEE ALSO
! 72: .Xr fw_update 1 ,
! 73: .Xr dmesg 8
! 74: .\" .Sh STANDARDS
! 75: .Sh AUTHORS
! 76: The
! 77: .Nm
! 78: program as a limited version of
! 79: .Xr fw_update 1
! 80: written by
! 81: .An Andrew Hewus Fresh Aq Mt afresh1@openbsd.org
! 82: .\" .Sh CAVEATS
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>