PRTCONF(8) Maintenance Commands and Procedures PRTCONF(8)

NAME

prtconf - print system configuration

SYNOPSIS

/usr/sbin/prtconf [-V] | [-F] | [-m] | [-x] | [-bpv] | [-acdDPv]
[dev_path]

DESCRIPTION

The prtconf command prints the system configuration information. The
output includes the total amount of memory, and the configuration of
system peripherals formatted as a device tree.


If a device path is specified on the command line for those command
options that can take a device path, prtconf will only display
information for that device node.

OPTIONS

The following options are supported:

-a
Display all the ancestors device nodes, up to the root node of
the device tree, for the device specified on the command line.


-b
Display the firmware device tree root properties for the
purpose of platform identification. These properties are
"name", "compatible", "banner-name" and "model".


-c
Display the device subtree rooted at the device node specified
on the command line, that is, display all the children of the
device node specified on the command line.


-d
Display vendor ID and device ID for PCI and PCI Express
devices, in addition to the nodename. If the information is
known, the vendor name and device name will also be shown.


-D
For each system peripheral in the device tree, displays the
name of the device driver used to manage the peripheral.


-F
Returns the device path name of the console frame buffer, if
one exists. If there is no frame buffer, prtconf returns a non-
zero exit code. This flag must be used by itself. It returns
only the name of the console, frame buffer device or a non-zero
exit code. For example, if the console frame buffer on a
SUNW,Ultra-30 is ffb, the command returns: /SUNW,ffb@1e,0:ffb0.
This option could be used to create a symlink for /dev/fb to
the actual console device.


-m
Displays the amount of system memory in megabytes. This flag
must be used by itself.


-p
Displays information derived from the device tree provided by
the firmware (PROM) on SPARC platforms or the booting system on
x86 platforms.The device tree information displayed using this
option is a snapshot of the initial configuration and may not
accurately reflect reconfiguration events that occur later.


-P
Includes information about pseudo devices. By default,
information regarding pseudo devices is omitted.


-v
Specifies verbose mode.


-V
Displays platform-dependent PROM (on SPARC platforms) or
booting system (on x86 platforms) version information. This
flag must be used by itself. The output is a string. The format
of the string is arbitrary and platform-dependent.


-x
A legacy flag that reported if the firmware on this system is
64-bit ready. As illumos only runs on 64-bit platforms, this
flag is kept for compatibility only, and zero is always
returned.

This flag overrides all other flags and must be used by itself.

OPERANDS

The following operands are supported:

dev_path
The path to a target device minor node, device nexus
node, or device link for which device node configuration
information is displayed

EXIT STATUS

The following exit values are returned:

0
No error occurred.


non-zero
With the -F option, a non-zero return value means that
the output device is not a frame buffer. In all other
cases, a non-zero return value means that an error
occurred.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|Interface Stability | Unstable |
+--------------------+-----------------+

SEE ALSO

openprom(4D), attributes(7), fuser(8), modinfo(8), sysdef(8)

NOTES

The output of the prtconf command is highly dependent on the version
of the PROM installed in the system. The output will be affected in
potentially all circumstances.


The driver not attached message means that no driver is currently
attached to that instance of the device. In general, drivers are
loaded and installed (and attached to hardware instances) on demand,
and when needed, and may be uninstalled and unloaded when the device
is not in use.


On x86 platforms, the use of prtconf -vp provides a subset of
information from prtconf -v. The value of integer properties from
prtconf -vp might require byte swapping for correct interpretation.

January 21, 2019 PRTCONF(8)