Print this page
11622 clean up rarer mandoc lint warnings
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man1m/prtconf.1m
+++ new/usr/src/man/man1m/prtconf.1m
1 1 '\" te
|
↓ open down ↓ |
1 lines elided |
↑ open up ↑ |
2 2 .\" Copyright 1989 AT&T Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved
3 3 .\" Copyright 2012, Joyent, Inc. All Rights Reserved
4 4 .\" Copyright 2019, Peter tribble.
5 5 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
6 6 .\" See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the
7 7 .\" fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
8 8 .TH PRTCONF 1M "Jan 21, 2019"
9 9 .SH NAME
10 10 prtconf \- print system configuration
11 11 .SH SYNOPSIS
12 -.LP
13 12 .nf
14 -\fB/usr/sbin/prtconf\fR [\fB-V\fR] | [\fB-F\fR] | [\fB-m\fr] | [\fB-x\fR] | [\fB-bpv\fR] | [\fB-acdDPv\fR]
13 +\fB/usr/sbin/prtconf\fR [\fB-V\fR] | [\fB-F\fR] | [\fB-m\fR] | [\fB-x\fR] | [\fB-bpv\fR] | [\fB-acdDPv\fR]
15 14 [\fIdev_path\fR]
16 15 .fi
17 16
18 17 .SH DESCRIPTION
19 -.LP
20 18 The \fBprtconf\fR command prints the system configuration information. The
21 19 output includes the total amount of memory, and the configuration of system
22 20 peripherals formatted as a device tree.
23 21 .sp
24 22 .LP
25 23 If a device path is specified on the command line for those command options
26 24 that can take a device path, \fBprtconf\fR will only display information for
27 25 that device node.
28 26 .SH OPTIONS
29 -.LP
30 27 The following options are supported:
31 28 .sp
32 29 .ne 2
33 30 .na
34 31 \fB-a\fR
35 32 .ad
36 33 .RS 6n
37 34 Display all the ancestors device nodes, up to the root node of the device tree,
38 35 for the device specified on the command line.
39 36 .RE
40 37
41 38 .sp
42 39 .ne 2
43 40 .na
44 41 \fB-b\fR
45 42 .ad
46 43 .RS 6n
47 44 Display the firmware device tree root properties for the purpose of platform
48 45 identification. These properties are "name", "compatible", "banner-name" and
49 46 "model".
50 47 .RE
51 48
52 49 .sp
53 50 .ne 2
54 51 .na
55 52 \fB-c\fR
56 53 .ad
57 54 .RS 6n
58 55 Display the device subtree rooted at the device node specified on the command
59 56 line, that is, display all the children of the device node specified on the
60 57 command line.
61 58 .RE
62 59
63 60 .sp
64 61 .ne 2
65 62 .na
66 63 \fB-d\fR
67 64 .ad
68 65 .RS 6n
69 66 Display vendor ID and device ID for PCI and PCI Express devices, in addition to
70 67 the nodename. If the information is known, the vendor name and device name will
71 68 also be shown.
72 69 .RE
73 70
74 71 .sp
75 72 .ne 2
76 73 .na
77 74 \fB-D\fR
78 75 .ad
79 76 .RS 6n
80 77 For each system peripheral in the device tree, displays the name of the device
81 78 driver used to manage the peripheral.
82 79 .RE
83 80
84 81 .sp
85 82 .ne 2
86 83 .na
87 84 \fB-F\fR
88 85 .ad
89 86 .RS 6n
90 87 Returns the device path name of the console frame buffer,
91 88 if one exists. If there is no frame buffer, \fBprtconf\fR returns a non-zero
92 89 exit code. This flag must be used by itself. It returns only the name of the
93 90 console, frame buffer device or a non-zero exit code. For example, if the
94 91 console frame buffer on a SUNW,Ultra-30 is \fBffb\fR, the command returns:
95 92 \fB/SUNW,ffb@1e,0:ffb0\fR. This option could be used to create a symlink for
96 93 \fB/dev/fb\fR to the actual console device.
97 94 .RE
98 95
99 96 .sp
100 97 .ne 2
101 98 .na
102 99 \fB-m\fR
103 100 .ad
104 101 .RS 6n
105 102 Displays the amount of system memory in megabytes.
106 103 This flag must be used by itself.
107 104 .RE
108 105
109 106
110 107 .ne 2
111 108 .na
112 109 \fB-p\fR
113 110 .ad
114 111 .RS 6n
115 112 Displays information derived from the device tree provided by the firmware
116 113 (PROM) on SPARC platforms or the booting system on x86 platforms.The device
117 114 tree information displayed using this option is a snapshot of the initial
118 115 configuration and may not accurately reflect reconfiguration events that occur
119 116 later.
120 117 .RE
121 118
122 119 .sp
123 120 .ne 2
124 121 .na
125 122 \fB-P\fR
126 123 .ad
127 124 .RS 6n
128 125 Includes information about pseudo devices. By default, information regarding
129 126 pseudo devices is omitted.
130 127 .RE
131 128
132 129 .sp
133 130 .ne 2
134 131 .na
135 132 \fB-v\fR
136 133 .ad
137 134 .RS 6n
138 135 Specifies verbose mode.
139 136 .RE
140 137
141 138 .sp
142 139 .ne 2
143 140 .na
144 141 \fB-V\fR
145 142 .ad
146 143 .RS 6n
147 144 Displays platform-dependent \fBPROM\fR (on SPARC platforms) or booting system
148 145 (on x86 platforms) version information. This flag must be used by itself. The
149 146 output is a string. The format of the string is arbitrary and
150 147 platform-dependent.
151 148 .RE
152 149
153 150 .sp
154 151 .ne 2
155 152 .na
156 153 \fB-x\fR
|
↓ open down ↓ |
117 lines elided |
↑ open up ↑ |
157 154 .ad
158 155 .RS 6n
159 156 A legacy flag that reported if the firmware on this system is 64-bit ready.
160 157 As illumos only runs on 64-bit platforms, this flag is kept for compatibility
161 158 only, and zero is always returned.
162 159 .sp
163 160 This flag overrides all other flags and must be used by itself.
164 161 .RE
165 162
166 163 .SH OPERANDS
167 -.LP
168 164 The following operands are supported:
169 165 .sp
170 166 .ne 2
171 167 .na
172 168 \fIdev_path\fR
173 169 .ad
174 170 .RS 12n
175 171 The path to a target device minor node, device nexus node, or device link for
176 172 which device node configuration information is displayed
177 173 .RE
178 174
179 175 .SH EXIT STATUS
180 -.LP
181 176 The following exit values are returned:
182 177 .sp
183 178 .ne 2
184 179 .na
185 180 \fB0\fR
186 181 .ad
187 182 .RS 12n
188 183 No error occurred.
189 184 .RE
190 185
191 186 .sp
192 187 .ne 2
|
↓ open down ↓ |
2 lines elided |
↑ open up ↑ |
193 188 .na
194 189 \fBnon-zero\fR
195 190 .ad
196 191 .RS 12n
197 192 With the \fB-F\fR option, a non-zero return value means that the
198 193 output device is not a frame buffer. In all other cases, a
199 194 non-zero return value means that an error occurred.
200 195 .RE
201 196
202 197 .SH ATTRIBUTES
203 -.LP
204 198 See \fBattributes\fR(5) for descriptions of the following attributes:
205 199 .sp
206 200
207 201 .sp
208 202 .TS
209 203 box;
210 204 c | c
211 205 l | l .
212 206 ATTRIBUTE TYPE ATTRIBUTE VALUE
213 207 Interface Stability Unstable
214 208 .TE
215 209
216 210 .SH SEE ALSO
217 -.LP
218 211 \fBfuser\fR(1M), \fBmodinfo\fR(1M), \fBsysdef\fR(1M), \fBattributes\fR(5),
219 212 \fBopenprom\fR(7D)
220 213 .SH NOTES
221 -.LP
222 214 The output of the \fBprtconf\fR command is highly dependent on the version of
223 215 the \fBPROM\fR installed in the system. The output will be affected in
224 216 potentially all circumstances.
225 217 .sp
226 218 .LP
227 219 The \fBdriver not attached\fR message means that no driver is currently
228 220 attached to that instance of the device. In general, drivers are loaded and
229 221 installed (and attached to hardware instances) on demand, and when needed, and
230 222 may be uninstalled and unloaded when the device is not in use.
231 223 .sp
232 224 .LP
233 225 On x86 platforms, the use of \fBprtconf\fR \fB-vp\fR provides a subset of
234 226 information from \fBprtconf\fR \fB-v\fR. The value of integer properties from
235 227 \fBprtconf\fR \fB-vp\fR might require byte swapping for correct interpretation.
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX