1 PRTCONF(1M)                  Maintenance Commands                  PRTCONF(1M)
   2 
   3 
   4 
   5 NAME
   6        prtconf - print system configuration
   7 
   8 SYNOPSIS
   9        /usr/sbin/prtconf [-V] | [-F] | [-m] | [-x] | [-bpv] | [-acdDPv]
  10             [dev_path]
  11 
  12 
  13 DESCRIPTION
  14        The prtconf command prints the system configuration information. The
  15        output includes the total amount of memory, and the configuration of
  16        system peripherals formatted as a device tree.
  17 
  18 
  19        If a device path is specified on the command line for those command
  20        options that can take a device path, prtconf will only display
  21        information for that device node.
  22 
  23 OPTIONS
  24        The following options are supported:
  25 
  26        -a
  27              Display all the ancestors device nodes, up to the root node of
  28              the device tree, for the device specified on the command line.
  29 
  30 
  31        -b
  32              Display the firmware device tree root properties for the purpose
  33              of platform identification. These properties are "name",
  34              "compatible", "banner-name" and "model".
  35 
  36 
  37        -c
  38              Display the device subtree rooted at the device node specified on
  39              the command line, that is, display all the children of the device
  40              node specified on the command line.
  41 
  42 
  43        -d
  44              Display vendor ID and device ID for PCI and PCI Express devices,
  45              in addition to the nodename. If the information is known, the
  46              vendor name and device name will also be shown.
  47 
  48 
  49        -D
  50              For each system peripheral in the device tree, displays the name
  51              of the device driver used to manage the peripheral.
  52 
  53 
  54        -F
  55              Returns the device path name of the console frame buffer, if one
  56              exists. If there is no frame buffer, prtconf returns a non-zero
  57              exit code. This flag must be used by itself. It returns only the
  58              name of the console, frame buffer device or a non-zero exit code.
  59              For example, if the console frame buffer on a SUNW,Ultra-30 is
  60              ffb, the command returns: /SUNW,ffb@1e,0:ffb0. This option could
  61              be used to create a symlink for /dev/fb to the actual console
  62              device.
  63 
  64 
  65        -m
  66              Displays the amount of system memory in megabytes.  This flag
  67              must be used by itself.
  68 
  69 
  70        -p
  71              Displays information derived from the device tree provided by the
  72              firmware (PROM) on SPARC platforms or the booting system on x86
  73              platforms.The device tree information displayed using this option
  74              is a snapshot of the initial configuration and may not accurately
  75              reflect reconfiguration events that occur later.
  76 
  77 
  78        -P
  79              Includes information about pseudo devices. By default,
  80              information regarding pseudo devices is omitted.
  81 
  82 
  83        -v
  84              Specifies verbose mode.
  85 
  86 
  87        -V
  88              Displays platform-dependent PROM (on SPARC platforms) or booting
  89              system (on x86 platforms) version information. This flag must be
  90              used by itself. The output is a string. The format of the string
  91              is arbitrary and platform-dependent.
  92 
  93 
  94        -x
  95              A legacy flag that reported if the firmware on this system is
  96              64-bit ready.  As illumos only runs on 64-bit platforms, this
  97              flag is kept for compatibility only, and zero is always returned.
  98 
  99              This flag overrides all other flags and must be used by itself.
 100 
 101 
 102 OPERANDS
 103        The following operands are supported:
 104 
 105        dev_path
 106                    The path to a target device minor node, device nexus node,
 107                    or device link for which device node configuration
 108                    information is displayed
 109 
 110 
 111 EXIT STATUS
 112        The following exit values are returned:
 113 
 114        0
 115                    No error occurred.
 116 
 117 
 118        non-zero
 119                    With the -F option, a non-zero return value means that the
 120                    output device is not a frame buffer. In all other cases, a
 121                    non-zero return value means that an error occurred.
 122 
 123 
 124 ATTRIBUTES
 125        See attributes(5) for descriptions of the following attributes:
 126 
 127 
 128 
 129 
 130        +--------------------+-----------------+
 131        |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
 132        |Interface Stability | Unstable        |
 133        +--------------------+-----------------+
 134 
 135 SEE ALSO
 136        fuser(1M), modinfo(1M), sysdef(1M), attributes(5), openprom(7D)
 137 
 138 NOTES
 139        The output of the prtconf command is highly dependent on the version of
 140        the PROM installed in the system. The output will be affected in
 141        potentially all circumstances.
 142 
 143 
 144        The driver not attached message means that no driver is currently
 145        attached to that instance of the device. In general, drivers are loaded
 146        and installed (and attached to hardware instances) on demand, and when
 147        needed, and may be uninstalled and unloaded when the device is not in
 148        use.
 149 
 150 
 151        On x86 platforms, the use of prtconf -vp provides a subset of
 152        information from prtconf -v. The value of integer properties from
 153        prtconf -vp might require byte swapping for correct interpretation.
 154 
 155 
 156 
 157                                January 21, 2019                    PRTCONF(1M)