Changeset View
Changeset View
Standalone View
Standalone View
sbin/devmatch/devmatch.8
Show All 17 Lines | |||||
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | ||||
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | ||||
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | ||||
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | ||||
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd November 21, 2021 | .Dd November 3, 2022 | ||||
.Dt DEVMATCH 8 | .Dt DEVMATCH 8 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm devmatch | .Nm devmatch | ||||
.Nd print information about unattached devices | .Nd print information about unattached devices | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
.Nm | .Nm | ||||
.Op Fl adhpuv | .Op Fl a | -all | ||||
.Op Fl -all | .Op Fl d | -dump | ||||
.Op Fl -dump | .Op Oo Fl h | -hints Oc Ar file | ||||
.Op Fl -hints Ar file | .Op Oo Fl p | -nomatch Oc Ar event | ||||
.Op Fl -nomatch Ar event | .Op Fl u | -unbound | ||||
.Op Fl -unbound | .Op Fl v | -verbose | ||||
.Op Fl -verbose | |||||
.Sh DESCRIPTION | .Sh DESCRIPTION | ||||
The | The | ||||
.Nm | .Nm | ||||
utility, without any arguments, prints all the kernel modules it has | utility, without any arguments, prints all the kernel modules it has | ||||
found for all the unattached, enabled devices in the system. | found for all the unattached, enabled devices in the system. | ||||
.Bl -tag -width 20m | .Bl -tag -width 20m | ||||
.It Fl a Fl -all | .It Fl a Fl -all | ||||
Include all devices, not just the ones that are unattached. | Include all devices, not just the ones that are unattached. | ||||
.It Fl d Fl -dump | .It Fl d Fl -dump | ||||
Produce a human readable dump of the | Produce a human readable dump of the | ||||
.Pa linker.hints | .Pa linker.hints | ||||
file. | file. | ||||
.It Fl h Fl -hints Ar file | .It Fl h Fl -hints Ar file | ||||
Use the named | Use the named | ||||
.Ar file | .Ar file | ||||
instead of | instead of | ||||
.Pa linker.hints | .Pa linker.hints | ||||
guessed from the current module load path. | guessed from the current module load path. | ||||
.It Fl p Fl -nomatch Ar event | .It Fl p Fl -nomatch Ar event | ||||
Parse and use a standard NOMATCH event from | Parse and use a standard NOMATCH event from | ||||
.Xr devd 8 | .Xr devd 8 | ||||
for matching instead of searching the device tree. | for matching instead of searching the device tree. | ||||
.It Fl u Fl -unbound | .It Fl u Fl -unbound | ||||
Attempt to produce a list of those drivers with PNP info whose driver | Attempt to produce a list of those drivers with PNP info whose driver | ||||
tables with that PNP info can not be found. | tables with that PNP info cannot be found. | ||||
.It Fl v Fl -verbose | .It Fl v Fl -verbose | ||||
Produce more verbose output. | Produce more verbose output. | ||||
.El | .El | ||||
.Sh SEE ALSO | .Sh SEE ALSO | ||||
.Xr rc.conf 5 , | .Xr rc.conf 5 , | ||||
.Xr devinfo 8 , | .Xr devinfo 8 , | ||||
.Xr MODULE_PNP_INFO 9 | .Xr MODULE_PNP_INFO 9 | ||||
.Sh HISTORY | .Sh HISTORY | ||||
Show All 12 Lines | |||||
.Pp | .Pp | ||||
Some modules are hard links in | Some modules are hard links in | ||||
.Pa /boot/kernel | .Pa /boot/kernel | ||||
and will be reported twice. | and will be reported twice. | ||||
.Pp | .Pp | ||||
The PNP string's attributes are evaluated once per PNP entry on that | The PNP string's attributes are evaluated once per PNP entry on that | ||||
bus rather than once. | bus rather than once. | ||||
.Pp | .Pp | ||||
The term PNP is overloaded in FreeBSD. | The term PNP is overloaded in | ||||
.Fx . | |||||
It means, generically, the identifying data the bus provides about a | It means, generically, the identifying data the bus provides about a | ||||
device. | device. | ||||
While this include old ISA PNP identifiers, it also includes the | While this include old ISA PNP identifiers, it also includes the | ||||
logical equivalent in USB, PCI, and others. | logical equivalent in USB, PCI, and others. | ||||
.Pp | .Pp | ||||
Many drivers currently lack proper PNP table decorations and need to | Many drivers currently lack proper PNP table decorations and need to | ||||
be updated. | be updated. |