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