man pages section 1M: System Administration Commands

prtconf(1M)

NAME

prtconf– print system configuration

SYNOPSIS

SPARC

/usr/sbin/prtconf

-V

-F

-x

-vpPD

x86

/usr/sbin/prtconf

-V

-x

-vpPD

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.

OPTIONS

The following options are supported:

-D

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

-F

(SPARC only). Returns the device pathname 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 SPARCstation 1 is cgthree in SBus slot #3, the command returns: /sbus@1,f80000000/cgthree@3,0. This option could be used to create a symlink for /dev/fb to the actual console device.

-p

Displays information derived from the device tree provided by the firmware (PROM) on SPARC platforms or the booting system on x86 platforms.

-P

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

-v

Specifies verbose mode. You must be in an administrative role to use this option.

-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

Reports if the firmware on this system is 64-bit ready. Some existing platforms may need a firmware upgrade in order to run the 64-bit kernel. If the operation is not applicable to this platform or the firmware is already 64-bit ready, it exits silently with a return code of zero. If the operation is applicable to this platform and the firmware is not 64-bit ready, it displays a descriptive message on stdout and exits with a non-zero return code. The hardware platform documentation contains more information about the platforms that may need a firmware upgrade in order to run the 64-bit kernel.

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

EXAMPLES

Example 1 Running prtconf on a SPARC Sun Ultra 10

Running prtconf on a Sun Ultra 10 machine produces the following sample output:

example% prtconf
System Configuration:  Sun Microsystems  sun4u
Memory size: 256 Megabytes
System Peripherals (Software Nodes):

SUNW,Ultra-5_10
    packages (driver not attached)
        terminal-emulator (driver not attached)
        deblocker (driver not attached)
        obp-tftp (driver not attached)
        disk-label (driver not attached)
        SUNW,builtin-drivers (driver not attached)
        sun-keyboard (driver not attached)
        ufs-file-system (driver not attached)
    chosen (driver not attached)
    openprom (driver not attached)
        client-services (driver not attached)
    options, instance #0
    aliases (driver not attached)
    memory (driver not attached)
    virtual-memory (driver not attached)
    pci, instance #0
        pci, instance #0
            ebus, instance #0
                auxio (driver not attached)
                power, instance #0
                SUNW,pll (driver not attached)
                se, instance #0
                su, instance #0
                su, instance #1
                ecpp (driver not attached)
                fdthree (driver not attached)
                eeprom (driver not attached)
                flashprom (driver not attached)
                SUNW,CS4231, instance #0
            network, instance #0
            ide, instance #0
                disk (driver not attached)
                cdrom (driver not attached)
                dad, instance #0
        pci, instance #1
            TSI,gfxp, instance #0
    SUNW,UltraSPARC-IIi (driver not attached)
    pseudo, instance #0

Example 2 Running prtconf on an x86 Machine

Running prtconf on an x86 machine produces the following sample output:

example% prtconf
System Configuration:  Sun Microsystems  i86pc
Memory size: 256 Megabytes
System Peripherals (Software Nodes):

i86pc
    eisa, instance #0
        kd, instance #0
        ata, instance #0
            cmdk, instance #0
        aha, instance #0
            cmdk, instance #1 (driver not attached)
            cmdk, instance #2 (driver not attached)
            cmdk, instance #3 (driver not attached)
            cmdk, instance #4 (driver not attached)
            cmdk, instance #5 (driver not attached)
            cmdk, instance #6 (driver not attached)
            cmdk, instance #7
        chanmux, instance #0
        asy, instance #0
        asy, instance #1
        elx, instance #0
        elx, instance #1 (driver not attached)
        elx, instance #2 (driver not attached)
        elx, instance #3 (driver not attached)
        fdc, instance #0
            fd, instance #0
            fd, instance #1
    options, instance #0
    objmgr, instance #0
    pseudo, instance #0
example%

EXIT STATUS

The following exit values are returned:

0: No error occurred.
non-zero: With the -F option (SPARC only), a non-zero return value means that the output device is not a framebuffer. With the -x option, a non-zero return value means that the firmware is not 64–bit ready. In all other cases, a non-zero return value means that an error occurred.

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWesu (32-bit)
	SUNWesxu (64-bit)

SUMMARY OF TRUSTED SOLARIS CHANGES

The -v option of this command must be run from an administrative role.

Trusted Solaris 8 HW 12/02 Reference Manual

sysdef(1M)

SunOS 5.8 Reference Manual

modinfo(1M), attributes(5)

Sun Hardware Platform Guide

SPARC Only

openprom(7D)

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.

Trusted Solaris 8 HW 12/02 Last Revised 7 Jan 2003