2 .\" Copyright (c) 2017 Netflix, Inc
4 .\" All rights reserved.
6 .\" Redistribution and use in source and binary forms, with or without
7 .\" modification, are permitted provided that the following conditions
9 .\" 1. Redistributions of source code must retain the above copyright
10 .\" notice, this list of conditions and the following disclaimer.
11 .\" 2. Redistributions in binary form must reproduce the above copyright
12 .\" notice, this list of conditions and the following disclaimer in the
13 .\" documentation and/or other materials provided with the distribution.
15 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR
16 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18 .\" IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY DIRECT, INDIRECT,
19 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
21 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
22 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33 .Nd print information about unattached devices
40 .Op Fl -nomatch Ar event
46 utility, without any arguments, prints all the kernel modules it has
47 found for all the unattached, enabled devices in the system.
50 Include all devices, not just the ones that are unattached.
52 Produce a human readable dump of the
55 .It Fl h Fl -hints Ar file
60 guessed from the current module load path.
61 .It Fl p Fl -nomatch Ar event
62 Parse and use a standard NOMATCH event from
64 for matching instead of searching the device tree.
66 Attempt to produce a list of those drivers with PNP info whose driver
67 tables with that PNP info can't be found.
69 Produce more verbose output.
75 The kernel has hints in it, but we exclude it from the list of modules
76 to suggest for unmatched devices.
77 We exclude it when suggesting drivers, but include it when looking for
78 unbound devices or producing a full dump of
80 This can be confusing.
82 Some modules are hard links in
84 and will be reported twice.
86 The PNP string's attributes are evaluated once per PNP entry on that
89 The term PNP is overloaded in FreeBSD.
90 It means, generically, the identifying data the bus provides about a
92 While this include old ISA PNP identifiers, it also includes the
93 logical equivalent in USB, PCI, and others.
95 Many drivers currently lack proper PNP table decorations and need to
98 .An Warner Losh Aq Mt imp@FreeBSD.org