1 '\" te
2 .\" Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved
3 .\" 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.
4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
5 .\" 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 fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH LUXADM 1M "May 13, 2017"
7 .SH NAME
8 luxadm \- administer Sun Fire 880 storage subsystem and FC_AL devices
9 .SH SYNOPSIS
10 .LP
11 .nf
12 \fBluxadm\fR [\fIoptions\fR]... \fIsubcommand\fR [\fIoptions\fR]... \fIenclosure\fR
13 [,\fIdev\fR] | \fIpathname\fR...
14 .fi
15
16 .SH DESCRIPTION
17 .LP
18 The \fBluxadm\fR program is an administrative command that manages the
19 \fBSENA\fR, Sun Fire 880 internal storage subsystem, and individual Fiber
20 Channel Arbitrated Loop (\fBFC_AL\fR) devices. \fBluxadm\fR performs a variety
21 of control and query tasks depending on the command line arguments and options
22 used.
23 .sp
24 .LP
25 The command line must contain a subcommand. The command line may also contain
26 options, usually at least one enclosure name or pathname, and other parameters
27 depending on the subcommand. You need specify only as many characters as are
28 required to uniquely identify a subcommand.
29 .sp
30 .LP
31 Specify the device that a subcommand interacts with by entering a pathname. For
32 the \fBSENA\fR subsystem, a disk device or enclosure services controller may
33 instead be specified by entering the World Wide Name (\fBWWN\fR) for the device
34 or a port to the device. The device may also be specified by entering the name
35 of the \fBSENA\fR enclosure, and an optional identifier for the particular
36 device in the enclosure. The individual \fBFC_AL\fR devices may be specified by
37 entering the \fBWWN\fR for the device or a port to the device.
38 .SS "Pathname"
39 .LP
40 Specify the device or controller by either a complete physical pathname or a
41 complete logical pathname.
42 .sp
43 .LP
44 For \fBSENA,\fR a typical physical pathname for a device is:
45 .sp
46 .in +2
47 .nf
48 /devices/sbus@1f,0/SUNW,socal@1,0/sf@0,0/ssd@w2200002037000f96,
49 0:a,raw
50 .fi
51 .in -2
52 .sp
53
54 .sp
55 .LP
56 For all \fBSENA IBs\fR (Interface Boards) and Sun Fire 880 SES device
57 controllers on the system, a logical link to the physical paths is kept in the
58 directory \fB/dev/es\fR. An example of a logical link is \fB/dev/es/ses0\fR.
59 .sp
103 .sp
104 .in +2
105 .nf
106 /devices/sbus@3.0/SUNW,socal@d,10000/sf@0,0/ssd@w2200002037049fc3,0:a,raw
107 .fi
108 .in -2
109 .sp
110
111 .sp
112 .LP
113 and a typical logical pathname is:
114 .sp
115 .in +2
116 .nf
117 /dev/rdsk/c1t0d0s2
118 .fi
119 .in -2
120 .sp
121
122 .SS "Enclosure"
123 .LP
124 For \fBSENA,\fR a device may be identified by its enclosure name and slotname:
125 .br
126 .in +2
127 \fIbox_name\fR[\fB,f\fR\fIslot_number\fR]
128 .in -2
129 .br
130 .in +2
131 \fIbox_name\fR[\fB,r\fR\fIslot_number\fR]
132 .in -2
133 .sp
134 .LP
135 \fIbox_name\fR is the name of the \fBSENA\fR enclosure, as specified by the
136 \fBenclosure_name\fR subcommand. When used without the optional
137 \fIslot_number\fR parameter, the \fIbox_name\fR identifies the \fBSENA\fR
138 subsystem \fBIB.\fR
139 .sp
140 .LP
141 \fBf\fR or \fBr\fR specifies the front or rear slots in the \fBSENA\fR
142 enclosure.
143 .sp
152 .in +2
153 .nf
154 \fIbox_name\fR[,\fIsslot_number\fR]
155 .fi
156 .in -2
157 .sp
158
159 .sp
160 .LP
161 \fIbox_name\fR is the name of the Sun Fire 880 enclosure, as specified by the
162 \fBenclosure_name\fR subcommand. When used without the optional
163 \fIslot_number\fR parameter, \fIbox_name\fR identifies the Sun Fire 880
164 internal storage subsystem enclosure services device. Use \fIs\fR to specify
165 the disk slot number in the Sun Fire 880 internal storage subsystem, \fB0\fR -
166 \fB11\fR.
167 .sp
168 .LP
169 See \fBdisks\fR(1M) and \fBdevlinks\fR(1M) for additional information on
170 logical names for disks and subsystems.
171 .SH OPTIONS
172 .LP
173 The following options are supported by all subcommands:
174 .sp
175 .ne 2
176 .na
177 \fB\fB-e\fR\fR
178 .ad
179 .RS 6n
180 Expert mode. This option is not recommended for the novice user.
181 .RE
182
183 .sp
184 .ne 2
185 .na
186 \fB\fB-v\fR\fR
187 .ad
188 .RS 6n
189 Verbose mode.
190 .RE
191
192 .sp
193 .LP
194 Options that are specific to particular subcommands are described with the
195 subcommand in the \fBUSAGE\fR section.
196 .SH OPERANDS
197 .LP
198 The following operands are supported:
199 .sp
200 .ne 2
201 .na
202 \fB\fIenclosure\fR\fR
203 .ad
204 .sp .6
205 .RS 4n
206 The \fIbox_name\fR of the \fBSENA\fR or Sun Fire 880 internal storage
207 subsystem.
208 .RE
209
210 .sp
211 .ne 2
212 .na
213 \fB\fIfibre_channel_HBA_port\fR\fR
214 .ad
215 .sp .6
216 .RS 4n
217 The path to the host controller port. A typical path is:
298 Displays in verbose mode, including mode sense data.
299 .RE
300
301 .RE
302
303 .sp
304 .ne 2
305 .na
306 \fB\fBdownload\fR [ \fB-s\fR ] [ \fB-f\fR \fIfilename_path\fR ]
307 \fIenclosure\fR.\|.\|.\fR
308 .ad
309 .sp .6
310 .RS 4n
311 Download the prom image pointed to the SENA subsystem Interface Board unit or
312 the Sun Fire 880 internal storage subsystem specified by the enclosure or
313 pathname.
314 .sp
315 When the \fBSENA's\fR download is complete, the \fBSENA\fR will be reset and
316 the downloaded code executed. If no filename is specified, the default prom
317 image will be used. The default prom image for the \fBSENA\fR is in the
318 directory \fBusr/lib/locale/C/LC_MESSAGES\fR and is named \fBibfirmware\fR
319 .sp
320 When the Sun Fire 880 internal storage subsystem's download is complete, the
321 subsystem resets and the downloaded code begins execution. The default firmware
322 image for the Sun Fire 880 internal storage subsystem is in:
323 \fB/usr/platform/SUNW,Sun-Fire-880/lib/images/int_fcbpl_fw\fR.
324 .sp
325 .ne 2
326 .na
327 \fB\fB-s\fR\fR
328 .ad
329 .RS 6n
330 Save. The \fB-s\fR option is used to save the downloaded firmware in the
331 FEPROM. If \fB-s\fR is not specified, the downloaded firmware will not be saved
332 across power cycles.
333 .sp
334 The \fB-s\fR option does not apply to the Sun Fire 880 internal storage
335 subsystem as it always stores downloaded firmware in the flash memory.
336 .sp
337 When using the \fB-s\fR option, the \fBdownload\fR subcommand modifies the
338 \fBFEPROM\fR on the subsystem and should be used with \fIcaution\fR.
729 .ne 2
730 .na
731 \fB\fBstart\fR \fIpathname\fR\fR
732 .ad
733 .sp .6
734 .RS 4n
735 Spin up the specified disk(s) in a SENA.
736 .RE
737
738 .sp
739 .ne 2
740 .na
741 \fB\fBstop\fR \fIpathname\fR...\fR
742 .ad
743 .sp .6
744 .RS 4n
745 Spin down the specified disks in a SENA.
746 .RE
747
748 .SS "SENA, Sun Fire 880 Internal Storage Subsystem, and Individual FC_AL Drive Expert Mode Subcommands"
749 .LP
750 The following subcommands are for expert use only, and are applicable only to
751 the \fBSENA\fR, Sun Fire 880 internal storage subsystem, and fiber channel
752 loops. They should only be used by users that are knowledgeable about the
753 \fBSENA\fR subsystem and fiber channel loops.
754 .sp
755 .LP
756 If you specify a disk to an expert subcommand that operates on a bus, the
757 subcommand operates on the bus to which the specified disk is attached.
758 .sp
759 .ne 2
760 .na
761 \fB\fB-e\fR \fBbypass\fR \fB[\fR\fB-ab\fR\fB]\fR \fIenclosure\fR,\fIdev\fR\fR
762 .ad
763 .br
764 .na
765 \fB\fB-e\fR \fBbypass\fR \fB-f\fR \fIenclosure\fR\fR
766 .ad
767 .sp .6
768 .RS 4n
769 Request the enclosure services controller to set the LRC (Loop Redundancy
850 loop. Use the pathname to specify a specific path for multiple loop
851 configurations.
852 .sp
853 This is an expert only command and should be used with caution. It will reset
854 all ports on the loop.
855 .RE
856
857 .sp
858 .ne 2
859 .na
860 \fB\fB\fR\fB-e\fR \fBrdls\fR \fIenclosure\fR[\fB,\fR\fIdev\fR] \|.\|.\|. |
861 \fIpathname\fR\|.\|.\|.\fR
862 .ad
863 .sp .6
864 .RS 4n
865 Read and display the link error status information for all available devices on
866 the loop that contains the device specified by the enclosure or pathname.
867 .RE
868
869 .SS "Other Expert Mode Subcommands"
870 .LP
871 See \fBNOTES\fR for limitations of these subcommands. They should only be used
872 by users that are knowledgeable about the systems they are managing.
873 .sp
874 .LP
875 These commands do not apply to the Sun Fire 880 internal storage subsystem.
876 .sp
877 .ne 2
878 .na
879 \fB\fB\fR\fB-e\fR \fBbus_getstate\fR \fIpathname\fR\fR
880 .ad
881 .RS 29n
882 Get and display the state of the specified bus.
883 .RE
884
885 .sp
886 .ne 2
887 .na
888 \fB\fB\fR\fB-e\fR \fBbus_quiesce\fR \fIpathname\fR\fR
889 .ad
890 .RS 29n
938
939 .sp
940 .ne 2
941 .na
942 \fB\fB\fR\fB-e\fR \fBoffline\fR \fIpathname\fR\fR
943 .ad
944 .RS 29n
945 Take the specified device offline.
946 .RE
947
948 .sp
949 .ne 2
950 .na
951 \fB\fB\fR\fB-e\fR \fBonline\fR \fIpathname\fR\fR
952 .ad
953 .RS 29n
954 Put the specified device online.
955 .RE
956
957 .SH EXAMPLES
958 .LP
959 \fBExample 1 \fRDisplaying the \fBSENA\fRs and Individual FC_AL Devices on a
960 System
961 .sp
962 .LP
963 The following example finds and displays all of the \fBSENA\fRs and individual
964 \fBFC_AL\fR devices on a system:
965
966 .sp
967 .in +2
968 .nf
969 example% \fBluxadm probe\fR
970 .fi
971 .in -2
972 .sp
973
974 .LP
975 \fBExample 2 \fRDisplaying a \fBSENA\fR or Sun Fire 880 Internal Storage
976 Subsystem
977 .sp
978 .LP
1190 .sp
1191
1192 .LP
1193 \fBExample 15 \fRUnquiescing the Bus
1194 .sp
1195 .LP
1196 The user then removes the disk and continues by unquiescing the bus, putting
1197 the disk back online, then unreserving it:
1198
1199 .sp
1200 .in +2
1201 .nf
1202 example# \fBluxadm \fR\fB-e\fR\fB bus_unquiesce /dev/rdsk/c1t8d0s2\fR
1203 example# \fBluxadm \fR\fB-e\fR\fB online /dev/rdsk/c1t8d0s2\fR
1204 example# \fBluxadm release /dev/rdsk/c1t8d0s2\fR
1205 .fi
1206 .in -2
1207 .sp
1208
1209 .SH ENVIRONMENT VARIABLES
1210 .LP
1211 See \fBenviron\fR(5) for a description of the \fBLANG\fR environment variable
1212 that affects the execution of \fBluxadm\fR.
1213 .SH EXIT STATUS
1214 .LP
1215 The following exit values are returned:
1216 .sp
1217 .ne 2
1218 .na
1219 \fB\fB0\fR\fR
1220 .ad
1221 .RS 9n
1222 Successful completion.
1223 .RE
1224
1225 .sp
1226 .ne 2
1227 .na
1228 \fB\fB\(mi1\fR\fR
1229 .ad
1230 .RS 9n
1231 An error occurred.
1232 .RE
1233
1234 .SH FILES
1235 .ne 2
1236 .na
1237 \fB\fBusr/lib/firmware/fc_s/fc_s_fcode\fR\fR
1238 .ad
1239 .sp .6
1240 .RS 4n
1241
1242 .RE
1243
1244 .sp
1245 .ne 2
1246 .na
1247 \fB\fBusr/lib/locale/C/LC_MESSAGES/ibfirmware\fR\fR
1248 .ad
1249 .sp .6
1250 .RS 4n
1251
1252 .RE
1253
1254 .SH SEE ALSO
1255 .LP
1256 \fBdevlinks\fR(1M), \fBdisks\fR(1M), \fBattributes\fR(5), \fBenviron\fR(5),
1257 \fBses\fR(7D)
1258 .SH NOTES
1259 .LP
1260 Currently, only some device drivers
1261 support hot plugging. If hot plugging is attempted on a disk or bus where it is
1262 not supported, an error message of the form:
1263 .sp
1264 .in +2
1265 .nf
1266 luxadm: can't acquire "PATHNAME": No such file or directory
1267 .fi
1268 .in -2
1269 .sp
1270
1271 .sp
1272 .LP
1273 will be displayed.
1274 .sp
1275 .LP
1276 You must be careful not to quiesce a bus that contains the root or the
1277 \fB/usr\fR filesystems or any swap data. If you do quiesce such a bus a
1278 deadlock can result, requiring a system reboot.
|
1 '\" te
2 .\" Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved
3 .\" 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.
4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
5 .\" 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 fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH LUXADM 1M "May 17, 2020"
7 .SH NAME
8 luxadm \- administer Sun Fire 880 storage subsystem and FC_AL devices
9 .SH SYNOPSIS
10 .nf
11 \fBluxadm\fR [\fIoptions\fR]... \fIsubcommand\fR [\fIoptions\fR]... \fIenclosure\fR
12 [,\fIdev\fR] | \fIpathname\fR...
13 .fi
14
15 .SH DESCRIPTION
16 The \fBluxadm\fR program is an administrative command that manages the
17 \fBSENA\fR, Sun Fire 880 internal storage subsystem, and individual Fiber
18 Channel Arbitrated Loop (\fBFC_AL\fR) devices. \fBluxadm\fR performs a variety
19 of control and query tasks depending on the command line arguments and options
20 used.
21 .sp
22 .LP
23 The command line must contain a subcommand. The command line may also contain
24 options, usually at least one enclosure name or pathname, and other parameters
25 depending on the subcommand. You need specify only as many characters as are
26 required to uniquely identify a subcommand.
27 .sp
28 .LP
29 Specify the device that a subcommand interacts with by entering a pathname. For
30 the \fBSENA\fR subsystem, a disk device or enclosure services controller may
31 instead be specified by entering the World Wide Name (\fBWWN\fR) for the device
32 or a port to the device. The device may also be specified by entering the name
33 of the \fBSENA\fR enclosure, and an optional identifier for the particular
34 device in the enclosure. The individual \fBFC_AL\fR devices may be specified by
35 entering the \fBWWN\fR for the device or a port to the device.
36 .SS "Pathname"
37 Specify the device or controller by either a complete physical pathname or a
38 complete logical pathname.
39 .sp
40 .LP
41 For \fBSENA,\fR a typical physical pathname for a device is:
42 .sp
43 .in +2
44 .nf
45 /devices/sbus@1f,0/SUNW,socal@1,0/sf@0,0/ssd@w2200002037000f96,
46 0:a,raw
47 .fi
48 .in -2
49 .sp
50
51 .sp
52 .LP
53 For all \fBSENA IBs\fR (Interface Boards) and Sun Fire 880 SES device
54 controllers on the system, a logical link to the physical paths is kept in the
55 directory \fB/dev/es\fR. An example of a logical link is \fB/dev/es/ses0\fR.
56 .sp
100 .sp
101 .in +2
102 .nf
103 /devices/sbus@3.0/SUNW,socal@d,10000/sf@0,0/ssd@w2200002037049fc3,0:a,raw
104 .fi
105 .in -2
106 .sp
107
108 .sp
109 .LP
110 and a typical logical pathname is:
111 .sp
112 .in +2
113 .nf
114 /dev/rdsk/c1t0d0s2
115 .fi
116 .in -2
117 .sp
118
119 .SS "Enclosure"
120 For \fBSENA,\fR a device may be identified by its enclosure name and slotname:
121 .br
122 .in +2
123 \fIbox_name\fR[\fB,f\fR\fIslot_number\fR]
124 .in -2
125 .br
126 .in +2
127 \fIbox_name\fR[\fB,r\fR\fIslot_number\fR]
128 .in -2
129 .sp
130 .LP
131 \fIbox_name\fR is the name of the \fBSENA\fR enclosure, as specified by the
132 \fBenclosure_name\fR subcommand. When used without the optional
133 \fIslot_number\fR parameter, the \fIbox_name\fR identifies the \fBSENA\fR
134 subsystem \fBIB.\fR
135 .sp
136 .LP
137 \fBf\fR or \fBr\fR specifies the front or rear slots in the \fBSENA\fR
138 enclosure.
139 .sp
148 .in +2
149 .nf
150 \fIbox_name\fR[,\fIsslot_number\fR]
151 .fi
152 .in -2
153 .sp
154
155 .sp
156 .LP
157 \fIbox_name\fR is the name of the Sun Fire 880 enclosure, as specified by the
158 \fBenclosure_name\fR subcommand. When used without the optional
159 \fIslot_number\fR parameter, \fIbox_name\fR identifies the Sun Fire 880
160 internal storage subsystem enclosure services device. Use \fIs\fR to specify
161 the disk slot number in the Sun Fire 880 internal storage subsystem, \fB0\fR -
162 \fB11\fR.
163 .sp
164 .LP
165 See \fBdisks\fR(1M) and \fBdevlinks\fR(1M) for additional information on
166 logical names for disks and subsystems.
167 .SH OPTIONS
168 The following options are supported by all subcommands:
169 .sp
170 .ne 2
171 .na
172 \fB\fB-e\fR\fR
173 .ad
174 .RS 6n
175 Expert mode. This option is not recommended for the novice user.
176 .RE
177
178 .sp
179 .ne 2
180 .na
181 \fB\fB-v\fR\fR
182 .ad
183 .RS 6n
184 Verbose mode.
185 .RE
186
187 .sp
188 .LP
189 Options that are specific to particular subcommands are described with the
190 subcommand in the \fBUSAGE\fR section.
191 .SH OPERANDS
192 The following operands are supported:
193 .sp
194 .ne 2
195 .na
196 \fB\fIenclosure\fR\fR
197 .ad
198 .sp .6
199 .RS 4n
200 The \fIbox_name\fR of the \fBSENA\fR or Sun Fire 880 internal storage
201 subsystem.
202 .RE
203
204 .sp
205 .ne 2
206 .na
207 \fB\fIfibre_channel_HBA_port\fR\fR
208 .ad
209 .sp .6
210 .RS 4n
211 The path to the host controller port. A typical path is:
292 Displays in verbose mode, including mode sense data.
293 .RE
294
295 .RE
296
297 .sp
298 .ne 2
299 .na
300 \fB\fBdownload\fR [ \fB-s\fR ] [ \fB-f\fR \fIfilename_path\fR ]
301 \fIenclosure\fR.\|.\|.\fR
302 .ad
303 .sp .6
304 .RS 4n
305 Download the prom image pointed to the SENA subsystem Interface Board unit or
306 the Sun Fire 880 internal storage subsystem specified by the enclosure or
307 pathname.
308 .sp
309 When the \fBSENA's\fR download is complete, the \fBSENA\fR will be reset and
310 the downloaded code executed. If no filename is specified, the default prom
311 image will be used. The default prom image for the \fBSENA\fR is in the
312 directory \fB/usr/lib/locale/C/LC_MESSAGES\fR and is named \fBibfirmware\fR
313 .sp
314 When the Sun Fire 880 internal storage subsystem's download is complete, the
315 subsystem resets and the downloaded code begins execution. The default firmware
316 image for the Sun Fire 880 internal storage subsystem is in:
317 \fB/usr/platform/SUNW,Sun-Fire-880/lib/images/int_fcbpl_fw\fR.
318 .sp
319 .ne 2
320 .na
321 \fB\fB-s\fR\fR
322 .ad
323 .RS 6n
324 Save. The \fB-s\fR option is used to save the downloaded firmware in the
325 FEPROM. If \fB-s\fR is not specified, the downloaded firmware will not be saved
326 across power cycles.
327 .sp
328 The \fB-s\fR option does not apply to the Sun Fire 880 internal storage
329 subsystem as it always stores downloaded firmware in the flash memory.
330 .sp
331 When using the \fB-s\fR option, the \fBdownload\fR subcommand modifies the
332 \fBFEPROM\fR on the subsystem and should be used with \fIcaution\fR.
723 .ne 2
724 .na
725 \fB\fBstart\fR \fIpathname\fR\fR
726 .ad
727 .sp .6
728 .RS 4n
729 Spin up the specified disk(s) in a SENA.
730 .RE
731
732 .sp
733 .ne 2
734 .na
735 \fB\fBstop\fR \fIpathname\fR...\fR
736 .ad
737 .sp .6
738 .RS 4n
739 Spin down the specified disks in a SENA.
740 .RE
741
742 .SS "SENA, Sun Fire 880 Internal Storage Subsystem, and Individual FC_AL Drive Expert Mode Subcommands"
743 The following subcommands are for expert use only, and are applicable only to
744 the \fBSENA\fR, Sun Fire 880 internal storage subsystem, and fiber channel
745 loops. They should only be used by users that are knowledgeable about the
746 \fBSENA\fR subsystem and fiber channel loops.
747 .sp
748 .LP
749 If you specify a disk to an expert subcommand that operates on a bus, the
750 subcommand operates on the bus to which the specified disk is attached.
751 .sp
752 .ne 2
753 .na
754 \fB\fB-e\fR \fBbypass\fR \fB[\fR\fB-ab\fR\fB]\fR \fIenclosure\fR,\fIdev\fR\fR
755 .ad
756 .br
757 .na
758 \fB\fB-e\fR \fBbypass\fR \fB-f\fR \fIenclosure\fR\fR
759 .ad
760 .sp .6
761 .RS 4n
762 Request the enclosure services controller to set the LRC (Loop Redundancy
843 loop. Use the pathname to specify a specific path for multiple loop
844 configurations.
845 .sp
846 This is an expert only command and should be used with caution. It will reset
847 all ports on the loop.
848 .RE
849
850 .sp
851 .ne 2
852 .na
853 \fB\fB\fR\fB-e\fR \fBrdls\fR \fIenclosure\fR[\fB,\fR\fIdev\fR] \|.\|.\|. |
854 \fIpathname\fR\|.\|.\|.\fR
855 .ad
856 .sp .6
857 .RS 4n
858 Read and display the link error status information for all available devices on
859 the loop that contains the device specified by the enclosure or pathname.
860 .RE
861
862 .SS "Other Expert Mode Subcommands"
863 See \fBNOTES\fR for limitations of these subcommands. They should only be used
864 by users that are knowledgeable about the systems they are managing.
865 .sp
866 .LP
867 These commands do not apply to the Sun Fire 880 internal storage subsystem.
868 .sp
869 .ne 2
870 .na
871 \fB\fB\fR\fB-e\fR \fBbus_getstate\fR \fIpathname\fR\fR
872 .ad
873 .RS 29n
874 Get and display the state of the specified bus.
875 .RE
876
877 .sp
878 .ne 2
879 .na
880 \fB\fB\fR\fB-e\fR \fBbus_quiesce\fR \fIpathname\fR\fR
881 .ad
882 .RS 29n
930
931 .sp
932 .ne 2
933 .na
934 \fB\fB\fR\fB-e\fR \fBoffline\fR \fIpathname\fR\fR
935 .ad
936 .RS 29n
937 Take the specified device offline.
938 .RE
939
940 .sp
941 .ne 2
942 .na
943 \fB\fB\fR\fB-e\fR \fBonline\fR \fIpathname\fR\fR
944 .ad
945 .RS 29n
946 Put the specified device online.
947 .RE
948
949 .SH EXAMPLES
950 \fBExample 1 \fRDisplaying the \fBSENA\fRs and Individual FC_AL Devices on a
951 System
952 .sp
953 .LP
954 The following example finds and displays all of the \fBSENA\fRs and individual
955 \fBFC_AL\fR devices on a system:
956
957 .sp
958 .in +2
959 .nf
960 example% \fBluxadm probe\fR
961 .fi
962 .in -2
963 .sp
964
965 .LP
966 \fBExample 2 \fRDisplaying a \fBSENA\fR or Sun Fire 880 Internal Storage
967 Subsystem
968 .sp
969 .LP
1181 .sp
1182
1183 .LP
1184 \fBExample 15 \fRUnquiescing the Bus
1185 .sp
1186 .LP
1187 The user then removes the disk and continues by unquiescing the bus, putting
1188 the disk back online, then unreserving it:
1189
1190 .sp
1191 .in +2
1192 .nf
1193 example# \fBluxadm \fR\fB-e\fR\fB bus_unquiesce /dev/rdsk/c1t8d0s2\fR
1194 example# \fBluxadm \fR\fB-e\fR\fB online /dev/rdsk/c1t8d0s2\fR
1195 example# \fBluxadm release /dev/rdsk/c1t8d0s2\fR
1196 .fi
1197 .in -2
1198 .sp
1199
1200 .SH ENVIRONMENT VARIABLES
1201 See \fBenviron\fR(5) for a description of the \fBLANG\fR environment variable
1202 that affects the execution of \fBluxadm\fR.
1203 .SH EXIT STATUS
1204 The following exit values are returned:
1205 .sp
1206 .ne 2
1207 .na
1208 \fB\fB0\fR\fR
1209 .ad
1210 .RS 9n
1211 Successful completion.
1212 .RE
1213
1214 .sp
1215 .ne 2
1216 .na
1217 \fB\fB\(mi1\fR\fR
1218 .ad
1219 .RS 9n
1220 An error occurred.
1221 .RE
1222
1223 .SH FILES
1224 .ne 2
1225 .na
1226 \fB\fB/usr/lib/firmware/fc_s/fc_s_fcode\fR\fR
1227 .ad
1228 .sp .6
1229 .RS 4n
1230
1231 .RE
1232
1233 .sp
1234 .ne 2
1235 .na
1236 \fB\fB/usr/lib/locale/C/LC_MESSAGES/ibfirmware\fR\fR
1237 .ad
1238 .sp .6
1239 .RS 4n
1240
1241 .RE
1242
1243 .SH SEE ALSO
1244 \fBdevlinks\fR(1M), \fBdisks\fR(1M), \fBattributes\fR(5), \fBenviron\fR(5),
1245 \fBses\fR(7D)
1246 .SH NOTES
1247 Currently, only some device drivers
1248 support hot plugging. If hot plugging is attempted on a disk or bus where it is
1249 not supported, an error message of the form:
1250 .sp
1251 .in +2
1252 .nf
1253 luxadm: can't acquire "PATHNAME": No such file or directory
1254 .fi
1255 .in -2
1256 .sp
1257
1258 .sp
1259 .LP
1260 will be displayed.
1261 .sp
1262 .LP
1263 You must be careful not to quiesce a bus that contains the root or the
1264 \fB/usr\fR filesystems or any swap data. If you do quiesce such a bus a
1265 deadlock can result, requiring a system reboot.
|