xref: /freebsd/usr.sbin/devinfo/devinfo.8 (revision 9fab5bbc38b7efc7c3361b4a33c89cdf98f4e2de)
111e4779eSRobert Watson.\" -*- nroff -*-
211e4779eSRobert Watson.\"
311e4779eSRobert Watson.\" Copyright (c) 2002 Hiten Pandya
411e4779eSRobert Watson.\" Copyright (c) 2002 Robert N. M. Watson
511e4779eSRobert Watson.\"
611e4779eSRobert Watson.\" All rights reserved.
711e4779eSRobert Watson.\"
811e4779eSRobert Watson.\" Redistribution and use in source and binary forms, with or without
911e4779eSRobert Watson.\" modification, are permitted provided that the following conditions
1011e4779eSRobert Watson.\" are met:
1111e4779eSRobert Watson.\" 1. Redistributions of source code must retain the above copyright
1211e4779eSRobert Watson.\"    notice, this list of conditions and the following disclaimer.
1311e4779eSRobert Watson.\" 2. Redistributions in binary form must reproduce the above copyright
1411e4779eSRobert Watson.\"    notice, this list of conditions and the following disclaimer in the
1511e4779eSRobert Watson.\"    documentation and/or other materials provided with the distribution.
1611e4779eSRobert Watson.\"
1711e4779eSRobert Watson.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR
1811e4779eSRobert Watson.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
1911e4779eSRobert Watson.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
2011e4779eSRobert Watson.\" IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY DIRECT, INDIRECT,
2111e4779eSRobert Watson.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
2211e4779eSRobert Watson.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
2311e4779eSRobert Watson.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
2411e4779eSRobert Watson.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
2511e4779eSRobert Watson.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
2611e4779eSRobert Watson.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
2711e4779eSRobert Watson.\"
28*9fab5bbcSJohn Baldwin.Dd January 29, 2025
2911e4779eSRobert Watson.Dt DEVINFO 8
30aa12cea2SUlrich Spörlein.Os
3111e4779eSRobert Watson.Sh NAME
3211e4779eSRobert Watson.Nm devinfo
33e4e67dfeSGiorgos Keramidas.Nd print information about system device configuration
3411e4779eSRobert Watson.Sh SYNOPSIS
3511e4779eSRobert Watson.Nm
3672eb2563SJoseph Koshy.Op Fl rv
3772eb2563SJoseph Koshy.Nm
38b8529e7cSJohn Baldwin.Fl u Op Fl v
3933860097SWarner Losh.Nm
40b68de894SWarner Losh.Fl p Ar dev Op Fl v
4111e4779eSRobert Watson.Sh DESCRIPTION
424e71fd98SRuslan ErmilovThe
434e71fd98SRuslan Ermilov.Nm
444e71fd98SRuslan Ermilovutility, without any arguments, shows the hierarchy of devices available
45f1c746bbSGiorgos Keramidasin the system, starting from the
464e71fd98SRuslan Ermilov.Dq nexus
47e4e67dfeSGiorgos Keramidasdevice.
4811e4779eSRobert Watson.Pp
494e71fd98SRuslan ErmilovThe following options are accepted.
504e71fd98SRuslan Ermilov.Bl -tag -width indent
514e71fd98SRuslan Ermilov.It Fl r
524e71fd98SRuslan ErmilovCauses hardware resource information (such as IRQ, I/O ports, I/O memory
534e71fd98SRuslan Ermilovaddresses) to be also listed, under each device that has reserved those resources.
544e71fd98SRuslan Ermilov.It Fl u
554e71fd98SRuslan ErmilovDisplays the same information as with
564e71fd98SRuslan Ermilov.Fl r
574e71fd98SRuslan Ermilovbut sorts by resource type rather than by device, allowing to review the
584e71fd98SRuslan Ermilovset of system resources by usage and available resources.
594e71fd98SRuslan ErmilovI.e., it lists all
6011e4779eSRobert Watsonthe IRQ consumers together.
617f156483SWarner Losh.It Fl v
627f156483SWarner LoshDisplay all devices in the driver tree, not just those that are attached or
637f156483SWarner Loshbusy.
647f156483SWarner LoshWithout this flag, only those devices that have attached are reported.
65b68de894SWarner LoshThis flag also displays verbose information about each device.
663ca6eb9fSWarner Losh.It Fl p Ar dev
673ca6eb9fSWarner LoshDisplay the path of
683ca6eb9fSWarner Losh.Ar dev
693ca6eb9fSWarner Loshback to the root of the device tree.
7011e4779eSRobert Watson.El
7111e4779eSRobert Watson.Sh SEE ALSO
72e4e67dfeSGiorgos Keramidas.Xr systat 1 ,
73e4e67dfeSGiorgos Keramidas.Xr devinfo 3 ,
745c19fabbSWarner Losh.Xr devctl 8 ,
75e4e67dfeSGiorgos Keramidas.Xr iostat 8 ,
7611e4779eSRobert Watson.Xr pciconf 8 ,
7772eb2563SJoseph Koshy.Xr vmstat 8 ,
7872eb2563SJoseph Koshy.Xr devclass 9 ,
7972eb2563SJoseph Koshy.Xr device 9
8011e4779eSRobert Watson.Sh AUTHORS
8101c2b8acSBaptiste Daroussin.An Mike Smith Aq Mt msmith@FreeBSD.org
82