Print this page
12745 man page typos
Split |
Close |
Expand all |
Collapse all |
--- old/usr/src/man/man1m/luxadm.1m
+++ new/usr/src/man/man1m/luxadm.1m
1 1 '\" te
2 2 .\" Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved
3 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 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 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"
6 +.TH LUXADM 1M "May 17, 2020"
7 7 .SH NAME
8 8 luxadm \- administer Sun Fire 880 storage subsystem and FC_AL devices
9 9 .SH SYNOPSIS
10 -.LP
11 10 .nf
12 11 \fBluxadm\fR [\fIoptions\fR]... \fIsubcommand\fR [\fIoptions\fR]... \fIenclosure\fR
13 12 [,\fIdev\fR] | \fIpathname\fR...
14 13 .fi
15 14
16 15 .SH DESCRIPTION
17 -.LP
18 16 The \fBluxadm\fR program is an administrative command that manages the
19 17 \fBSENA\fR, Sun Fire 880 internal storage subsystem, and individual Fiber
20 18 Channel Arbitrated Loop (\fBFC_AL\fR) devices. \fBluxadm\fR performs a variety
21 19 of control and query tasks depending on the command line arguments and options
22 20 used.
23 21 .sp
24 22 .LP
25 23 The command line must contain a subcommand. The command line may also contain
26 24 options, usually at least one enclosure name or pathname, and other parameters
27 25 depending on the subcommand. You need specify only as many characters as are
28 26 required to uniquely identify a subcommand.
↓ open down ↓ |
1 lines elided |
↑ open up ↑ |
29 27 .sp
30 28 .LP
31 29 Specify the device that a subcommand interacts with by entering a pathname. For
32 30 the \fBSENA\fR subsystem, a disk device or enclosure services controller may
33 31 instead be specified by entering the World Wide Name (\fBWWN\fR) for the device
34 32 or a port to the device. The device may also be specified by entering the name
35 33 of the \fBSENA\fR enclosure, and an optional identifier for the particular
36 34 device in the enclosure. The individual \fBFC_AL\fR devices may be specified by
37 35 entering the \fBWWN\fR for the device or a port to the device.
38 36 .SS "Pathname"
39 -.LP
40 37 Specify the device or controller by either a complete physical pathname or a
41 38 complete logical pathname.
42 39 .sp
43 40 .LP
44 41 For \fBSENA,\fR a typical physical pathname for a device is:
45 42 .sp
46 43 .in +2
47 44 .nf
48 45 /devices/sbus@1f,0/SUNW,socal@1,0/sf@0,0/ssd@w2200002037000f96,
49 46 0:a,raw
50 47 .fi
51 48 .in -2
52 49 .sp
53 50
54 51 .sp
55 52 .LP
56 53 For all \fBSENA IBs\fR (Interface Boards) and Sun Fire 880 SES device
57 54 controllers on the system, a logical link to the physical paths is kept in the
58 55 directory \fB/dev/es\fR. An example of a logical link is \fB/dev/es/ses0\fR.
59 56 .sp
60 57 .LP
61 58 The \fBWWN\fR may be used in place of the pathname to select an \fBFC_AL\fR
62 59 device, \fBSENA\fR subsystem IB, or Sun Fire 880 internal storage subsystem.
63 60 The \fBWWN\fR is a unique 16 hexadecimal digit value that specifies either the
64 61 port used to access the device or the device itself. A typical \fBWWN\fR value
65 62 is:
66 63 .sp
67 64 .in +2
68 65 .nf
69 66 2200002037000f96
70 67 .fi
71 68 .in -2
72 69 .sp
73 70
74 71 .sp
75 72 .LP
76 73 See NOTES for more information on the \fBWWN\fR formats.
77 74 .sp
78 75 .LP
79 76 For a disk in a Sun Fire 880 internal storage subsystem, a typical physical
80 77 pathname is:
81 78 .sp
82 79 .in +2
83 80 .nf
84 81 /devices/pci@8,600000/SUNW,qlc@2/fp@0,0/ssd@w2100002037a6303c,0:a
85 82 .fi
86 83 .in -2
87 84 .sp
88 85
89 86 .sp
90 87 .LP
91 88 and a typical logical pathname is:
92 89 .sp
93 90 .in +2
94 91 .nf
95 92 /dev/rdsk/c2t8d0s2
96 93 .fi
97 94 .in -2
98 95 .sp
99 96
100 97 .sp
101 98 .LP
102 99 For individual FC_AL devices, a typical physical pathname is:
103 100 .sp
104 101 .in +2
105 102 .nf
106 103 /devices/sbus@3.0/SUNW,socal@d,10000/sf@0,0/ssd@w2200002037049fc3,0:a,raw
107 104 .fi
108 105 .in -2
109 106 .sp
110 107
111 108 .sp
112 109 .LP
↓ open down ↓ |
63 lines elided |
↑ open up ↑ |
113 110 and a typical logical pathname is:
114 111 .sp
115 112 .in +2
116 113 .nf
117 114 /dev/rdsk/c1t0d0s2
118 115 .fi
119 116 .in -2
120 117 .sp
121 118
122 119 .SS "Enclosure"
123 -.LP
124 120 For \fBSENA,\fR a device may be identified by its enclosure name and slotname:
125 121 .br
126 122 .in +2
127 123 \fIbox_name\fR[\fB,f\fR\fIslot_number\fR]
128 124 .in -2
129 125 .br
130 126 .in +2
131 127 \fIbox_name\fR[\fB,r\fR\fIslot_number\fR]
132 128 .in -2
133 129 .sp
134 130 .LP
135 131 \fIbox_name\fR is the name of the \fBSENA\fR enclosure, as specified by the
136 132 \fBenclosure_name\fR subcommand. When used without the optional
137 133 \fIslot_number\fR parameter, the \fIbox_name\fR identifies the \fBSENA\fR
138 134 subsystem \fBIB.\fR
139 135 .sp
140 136 .LP
141 137 \fBf\fR or \fBr\fR specifies the front or rear slots in the \fBSENA\fR
142 138 enclosure.
143 139 .sp
144 140 .LP
145 141 \fIslot_number\fR specifies the slot number of the device in the \fBSENA\fR
146 142 enclosure, \fB0-6\fR or \fB0-10\fR.
147 143 .sp
148 144 .LP
149 145 For a Sun Fire 880 internal storage subsystem, a device may also be identified
150 146 by its enclosure name and slot name. However, there is only one set of disks:
151 147 .sp
152 148 .in +2
153 149 .nf
154 150 \fIbox_name\fR[,\fIsslot_number\fR]
155 151 .fi
156 152 .in -2
157 153 .sp
158 154
159 155 .sp
160 156 .LP
161 157 \fIbox_name\fR is the name of the Sun Fire 880 enclosure, as specified by the
↓ open down ↓ |
28 lines elided |
↑ open up ↑ |
162 158 \fBenclosure_name\fR subcommand. When used without the optional
163 159 \fIslot_number\fR parameter, \fIbox_name\fR identifies the Sun Fire 880
164 160 internal storage subsystem enclosure services device. Use \fIs\fR to specify
165 161 the disk slot number in the Sun Fire 880 internal storage subsystem, \fB0\fR -
166 162 \fB11\fR.
167 163 .sp
168 164 .LP
169 165 See \fBdisks\fR(1M) and \fBdevlinks\fR(1M) for additional information on
170 166 logical names for disks and subsystems.
171 167 .SH OPTIONS
172 -.LP
173 168 The following options are supported by all subcommands:
174 169 .sp
175 170 .ne 2
176 171 .na
177 172 \fB\fB-e\fR\fR
178 173 .ad
179 174 .RS 6n
180 175 Expert mode. This option is not recommended for the novice user.
181 176 .RE
182 177
183 178 .sp
184 179 .ne 2
185 180 .na
186 181 \fB\fB-v\fR\fR
↓ open down ↓ |
4 lines elided |
↑ open up ↑ |
187 182 .ad
188 183 .RS 6n
189 184 Verbose mode.
190 185 .RE
191 186
192 187 .sp
193 188 .LP
194 189 Options that are specific to particular subcommands are described with the
195 190 subcommand in the \fBUSAGE\fR section.
196 191 .SH OPERANDS
197 -.LP
198 192 The following operands are supported:
199 193 .sp
200 194 .ne 2
201 195 .na
202 196 \fB\fIenclosure\fR\fR
203 197 .ad
204 198 .sp .6
205 199 .RS 4n
206 200 The \fIbox_name\fR of the \fBSENA\fR or Sun Fire 880 internal storage
207 201 subsystem.
208 202 .RE
209 203
210 204 .sp
211 205 .ne 2
212 206 .na
213 207 \fB\fIfibre_channel_HBA_port\fR\fR
214 208 .ad
215 209 .sp .6
216 210 .RS 4n
217 211 The path to the host controller port. A typical path is:
218 212 .sp
219 213 .in +2
220 214 .nf
221 215 /devices/pci@8,600000/pci@1/SUNW,qlc@4/fp@0,0:devctl
222 216 .fi
223 217 .in -2
224 218 .sp
225 219
226 220 .RE
227 221
228 222 .sp
229 223 .ne 2
230 224 .na
231 225 \fB\fIpathname\fR\fR
232 226 .ad
233 227 .sp .6
234 228 .RS 4n
235 229 The logical or physical path of a \fBSENA IB\fR, Sun Fire 880 internal storage
236 230 subsystem, or disk device. \fIpathname\fR can also be the \fBWWN\fR of a
237 231 \fBSENA IB\fR, \fBSENA\fR disk, or individual \fBFC_AL\fR device.
238 232 .RE
239 233
240 234 .SH USAGE
241 235 .SS "Subcommands"
242 236 .ne 2
243 237 .na
244 238 \fB\fBdisplay\fR \fIenclosure\fR[,\fIdev\fR]\|.\|.\|.\||
245 239 \fIpathname\fR\|.\|.\|.\fR
246 240 .ad
247 241 .br
248 242 .na
249 243 \fB\fBdisplay\fR \fB-p\fR \fIpathname\fR\|.\|.\|.\fR
250 244 .ad
251 245 .br
252 246 .na
253 247 \fB\fBdisplay\fR \fB-r\fR \fIenclosure\fR[,\fIdev\fR]\|.\|.\|.\||
254 248 \fIpathname\fR\|.\|.\|.\fR
255 249 .ad
256 250 .br
257 251 .na
258 252 \fB\fBdisplay\fR \fB-v\fR \fIenclosure\fR[,\fIdev\fR]\|.\|.\|.\||
259 253 \fIpathname\fR\|.\|.\|.\fR
260 254 .ad
261 255 .sp .6
262 256 .RS 4n
263 257 Displays enclosure or device specific data.
264 258 .sp
265 259 Subsystem data consists of enclosure environmental sense information and status
266 260 for all subsystem devices, including disks.
267 261 .sp
268 262 Disk data consists of inquiry, capacity, and configuration information.
269 263 .sp
270 264 .ne 2
271 265 .na
272 266 \fB\fB-p\fR\fR
273 267 .ad
274 268 .RS 6n
275 269 Displays performance information for the device or subsystem specified by
276 270 \fIpathname\fR. This option only applies to subsystems that accumulate
277 271 performance information.
278 272 .RE
279 273
280 274 .sp
281 275 .ne 2
282 276 .na
283 277 \fB\fB-r\fR\fR
284 278 .ad
285 279 .RS 6n
286 280 Displays error information for the \fBFC_AL\fR device specified by the
287 281 pathname, or, if the path is a \fBSENA,\fR for all devices on the loop. The
288 282 \fB-r\fR option only applies to \fBSENA\fR subsystems and individual
289 283 \fBFC_AL\fR devices.
290 284 .RE
291 285
292 286 .sp
293 287 .ne 2
294 288 .na
295 289 \fB\fB-v\fR\fR
296 290 .ad
297 291 .RS 6n
298 292 Displays in verbose mode, including mode sense data.
299 293 .RE
300 294
301 295 .RE
302 296
303 297 .sp
304 298 .ne 2
305 299 .na
306 300 \fB\fBdownload\fR [ \fB-s\fR ] [ \fB-f\fR \fIfilename_path\fR ]
307 301 \fIenclosure\fR.\|.\|.\fR
↓ open down ↓ |
100 lines elided |
↑ open up ↑ |
308 302 .ad
309 303 .sp .6
310 304 .RS 4n
311 305 Download the prom image pointed to the SENA subsystem Interface Board unit or
312 306 the Sun Fire 880 internal storage subsystem specified by the enclosure or
313 307 pathname.
314 308 .sp
315 309 When the \fBSENA's\fR download is complete, the \fBSENA\fR will be reset and
316 310 the downloaded code executed. If no filename is specified, the default prom
317 311 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
312 +directory \fB/usr/lib/locale/C/LC_MESSAGES\fR and is named \fBibfirmware\fR
319 313 .sp
320 314 When the Sun Fire 880 internal storage subsystem's download is complete, the
321 315 subsystem resets and the downloaded code begins execution. The default firmware
322 316 image for the Sun Fire 880 internal storage subsystem is in:
323 317 \fB/usr/platform/SUNW,Sun-Fire-880/lib/images/int_fcbpl_fw\fR.
324 318 .sp
325 319 .ne 2
326 320 .na
327 321 \fB\fB-s\fR\fR
328 322 .ad
329 323 .RS 6n
330 324 Save. The \fB-s\fR option is used to save the downloaded firmware in the
331 325 FEPROM. If \fB-s\fR is not specified, the downloaded firmware will not be saved
332 326 across power cycles.
333 327 .sp
334 328 The \fB-s\fR option does not apply to the Sun Fire 880 internal storage
335 329 subsystem as it always stores downloaded firmware in the flash memory.
336 330 .sp
337 331 When using the \fB-s\fR option, the \fBdownload\fR subcommand modifies the
338 332 \fBFEPROM\fR on the subsystem and should be used with \fIcaution\fR.
339 333 .RE
340 334
341 335 .RE
342 336
343 337 .sp
344 338 .ne 2
345 339 .na
346 340 \fB\fBenclosure_name\fR \fInew_name\fR \fIenclosure\fR | \fIpathname\fR\fR
347 341 .ad
348 342 .sp .6
349 343 .RS 4n
350 344 Change the enclosure name of the enclosure or enclosures specified by the
351 345 enclosure or pathname. The new name (\fInew_name\fR) must be 16 or less
352 346 characters. Only alphabetic or numeric characters are acceptable. This
353 347 subcommand applies only to the SENA and the Sun Fire 880 internal storage
354 348 subsystem.
355 349 .RE
356 350
357 351 .sp
358 352 .ne 2
359 353 .na
360 354 \fB\fBfailover primary\fR | \fBsecondary\fR \fIpathname\fR\fR
361 355 .ad
362 356 .sp .6
363 357 .RS 4n
364 358 Select which Sun Storage T3 storage array partner group controller accesses a
365 359 given logical volume. If \fBprimary\fR is specified, the logical volume is
366 360 accessed through the primary controller. If \fBsecondary\fR is specified, the
367 361 logical volume is accessed through the secondary controller specified by
368 362 \fIpathname\fR.
369 363 .RE
370 364
371 365 .sp
372 366 .ne 2
373 367 .na
374 368 \fB\fBfcal_s_download\fR [ \fB-f\fR \fIfcode-file\fR ]\fR
375 369 .ad
376 370 .sp .6
377 371 .RS 4n
378 372 Download the fcode contained in the file \fIfcode-file\fR into \fIall\fR the
379 373 \fBFC100/S\fR Sbus Cards. This command is interactive and expects user
380 374 confirmation before downloading the fcode.
381 375 .sp
382 376 Use \fBfcal_s_download\fR \fIonly\fR in single-user mode. Using
383 377 \fBfcal_s_download\fR to update a host adapter while there is \fBI/O\fR
384 378 activity through that adapter \fIwill\fR cause the adapter to reset. Newly
385 379 updated FCode will not be executed or visible until a system reboot.
386 380 .sp
387 381 .ne 2
388 382 .na
389 383 \fB\fB-f\fR \fIfcode-file\fR\fR
390 384 .ad
391 385 .RS 17n
392 386 When invoked without the \fB-f\fR option, the current version of the fcode in
393 387 each \fBFC100/S\fR Sbus card is printed.
394 388 .RE
395 389
396 390 .RE
397 391
398 392 .sp
399 393 .ne 2
400 394 .na
401 395 \fB\fBfcode_download\fR \fB-p\fR\fR
402 396 .ad
403 397 .br
404 398 .na
405 399 \fB\fBfcode_download\fR \fB-d\fR \fIdir-name\fR\fR
406 400 .ad
407 401 .sp .6
408 402 .RS 4n
409 403 Locate the installed \fBFC/S\fR, \fBFC100/S, FC100/P\fR, or \fBFC100/2P\fR host
410 404 bus adapter cards and download the FCode files in \fIdir-name\fR to the
411 405 appropriate cards. The command determines the correct card for each type of
412 406 file, and is interactive. User confirmation is required before downloading the
413 407 FCode to each device.
414 408 .sp
415 409 Use \fBfcode_download\fR to load FCode only in single-user mode. Using
416 410 \fBfcode_download\fR to update a host adapter while there is \fBI/O\fR activity
417 411 through that adapter causes the adapter to reset. Newly updated FCode will not
418 412 be executed or visible until a system reboot.
419 413 .sp
420 414 .ne 2
421 415 .na
422 416 \fB\fB-d\fR \fIdir-name\fR\fR
423 417 .ad
424 418 .RS 15n
425 419 Download the FCode files contained in the directory \fIdir-name\fR to the
426 420 appropriate adapter cards.
427 421 .RE
428 422
429 423 .sp
430 424 .ne 2
431 425 .na
432 426 \fB\fB-p\fR\fR
433 427 .ad
434 428 .RS 15n
435 429 Prints the current version of FCode loaded on each card. No download is
436 430 performed.
437 431 .RE
438 432
439 433 .RE
440 434
441 435 .sp
442 436 .ne 2
443 437 .na
444 438 \fB\fBinquiry\fR \fIenclosure\fR[,\fIdev\fR ]\|.\|.\|.\| |
445 439 \fIpathname\fR\|.\|.\|.\fR
446 440 .ad
447 441 .sp .6
448 442 .RS 4n
449 443 Display the inquiry information for the selected device specified by the
450 444 enclosure or pathname.
451 445 .RE
452 446
453 447 .sp
454 448 .ne 2
455 449 .na
456 450 \fB\fBinsert_device\fR [ \fIenclosure\fR,\fIdev\fR\|.\|.\|. ]\fR
457 451 .ad
458 452 .sp .6
459 453 .RS 4n
460 454 Assist the user in the hot insertion of a new device or a chain of new devices.
461 455 Refer to \fBNOTES\fR for limitations on hotplug operations. This subcommand
462 456 applies only to the \fBSENA\fR, Sun Fire 880 internal storage subsystem, and
463 457 individual FC_AL drives. For the \fBSENA\fR, if more than one enclosure has
464 458 been specified, concurrent hot insertions on multiple busses can be performed.
465 459 With no arguments to the subcommand, entire enclosures or individual
466 460 \fBFC_AL\fR drives can be inserted. For the \fBSENA\fR or the Sun Fire 880
467 461 internal storage subsystem, this subcommand guides the user interactively
468 462 through the hot insertion steps of a new device or chain of devices. If a list
469 463 of disks was entered it will ask the user to verify the list of devices to be
470 464 inserted is correct, at which point the user can continue or quit. It then
471 465 interactively asks the user to insert the disk(s) or enclosure(s) and then
472 466 creates and displays the logical pathnames for the devices.
473 467 .RE
474 468
475 469 .sp
476 470 .ne 2
477 471 .na
478 472 \fB\fBled\fR \fIenclosure\fR,\fIdev\fR\|.\|.\|.\|| \fIpathname\fR.\|.\|.\fR
479 473 .ad
480 474 .sp .6
481 475 .RS 4n
482 476 Display the current state of the \fBLED\fR associated with the disk specified
483 477 by the enclosure or pathname. This subcommand only applies to subsystems that
484 478 support this functionality.
485 479 .RE
486 480
487 481 .sp
488 482 .ne 2
489 483 .na
490 484 \fB\fBled_blink\fR \fIenclosure\fR,\fIdev\fR\|.\|.\|.\||
491 485 \fIpathname\fR\|.\|.\|.\fR
492 486 .ad
493 487 .sp .6
494 488 .RS 4n
495 489 Requests the subsystem to start blinking the \fBLED\fR associated with the disk
496 490 specified by the enclosure or pathname. This subcommand only applies to
497 491 subsystems that support this functionality.
498 492 .RE
499 493
500 494 .sp
501 495 .ne 2
502 496 .na
503 497 \fB\fBled_off\fR \fIenclosure\fR,\fIdev\fR\|.\|.\|.\||
504 498 \fIpathname\fR\|.\|.\|.\fR
505 499 .ad
506 500 .sp .6
507 501 .RS 4n
508 502 Requests the subsystem to disable (turn off) the \fBLED\fR associated with the
509 503 disk specified by the enclosure or pathname. On a \fBSENA\fR subsystem, this
510 504 may or may not cause the \fBLED\fR to turn off or stop blinking depending on
511 505 the state of the \fBSENA\fR subsystem. Refer to the \fBSENA\fR Array
512 506 Installation and Service Manual (p/n 802-7573). This subcommand only applies to
513 507 subsystems that support this functionality.
514 508 .RE
515 509
516 510 .sp
517 511 .ne 2
518 512 .na
519 513 \fB\fBled_on\fR \fIpathname\fR\|.\|.\|.\fR
520 514 .ad
521 515 .sp .6
522 516 .RS 4n
523 517 Requests the subsystem to enable (turn on) the \fBLED\fR associated with the
524 518 disk specified by the pathname. This subcommand only applies to subsystems that
525 519 support this functionality.
526 520 .RE
527 521
528 522 .sp
529 523 .ne 2
530 524 .na
531 525 \fB\fBpower_off\fR [ \fB-F\fR ] \fIenclosure\fR[,\fIdev\fR]\|.\|.\|. |
532 526 \fIpathname\fR \|.\|.\|.\fR
533 527 .ad
534 528 .sp .6
535 529 .RS 4n
536 530 When a \fBSENA\fR is addressed, this subcommand causes the \fBSENA\fR subsystem
537 531 to go into the power-save mode. The \fBSENA\fR drives are not available when in
538 532 the power-save mode. When a drive in a \fBSENA\fR is addressed the drive is set
539 533 to the drive off/unmated state. In the drive off/unmated state, the drive is
540 534 spun down (stopped) and in bypass mode. This command does not apply to the Sun
541 535 Fire 880 internal storage subsystem.
542 536 .sp
543 537 .ne 2
544 538 .na
545 539 \fB\fB-F\fR\fR
546 540 .ad
547 541 .RS 6n
548 542 The force option only applies to the \fBSENA.\fR Instructs \fBluxadm\fR to
549 543 attempt to power off one or more devices even if those devices are being used
550 544 by this host (and are, therefore, busy).
551 545 .sp
552 546 \fBWarning\fR: Powering off a device which has data that is currently being
553 547 used will cause unpredictable results. Users should attempt to power off the
554 548 device normally (without \fB-F\fR) first, only resorting to this option when
555 549 sure of the consequences of overriding normal checks.
556 550 .RE
557 551
558 552 .RE
559 553
560 554 .sp
561 555 .ne 2
562 556 .na
563 557 \fB\fBpower_on\fR \fIenclosure\fR[\fB,\fR\fIdev\fR]\|.\|.\|\fR
564 558 .ad
565 559 .sp .6
566 560 .RS 4n
567 561 Causes the \fBSENA\fR subsystem to go out of the power-save mode, when this
568 562 subcommand is addressed to a \fBSENA.\fR. When this subcommand is addressed to
569 563 a drive the drive is set to its normal start-up state. This command does not
570 564 apply to the Sun Fire 880 internal storage subsystem.
571 565 .RE
572 566
573 567 .sp
574 568 .ne 2
575 569 .na
576 570 \fB\fBprobe\fR [ \fB-p\fR ]\fR
577 571 .ad
578 572 .sp .6
579 573 .RS 4n
580 574 Finds and displays information about all attached \fBSENA\fR subsystems, Sun
581 575 Fire 880 internal storage subsystems, and individual \fBFC_AL\fR devices,
582 576 including the logical pathname, the \fBWWNs,\fR and enclosure names. This
583 577 subcommand warns the user if it finds different \fBSENAs\fR with the same
584 578 enclosure names.
585 579 .sp
586 580 .ne 2
587 581 .na
588 582 \fB\fB-p\fR\fR
589 583 .ad
590 584 .RS 6n
591 585 Includes the physical pathname in the display.
592 586 .RE
593 587
594 588 .RE
595 589
596 590 .sp
597 591 .ne 2
598 592 .na
599 593 \fB\fBqlgc_s_download\fR [ \fB-f\fR \fIfcode-file\fR ]\fR
600 594 .ad
601 595 .sp .6
602 596 .RS 4n
603 597 Download the FCode contained in the file \fIfcode-file\fR into all the
604 598 \fBFC100/P\fR, \fBFC100/2P\fR \fBPCI\fR host adapter cards. This command is
605 599 interactive and expects user confirmation before downloading the FCode to each
606 600 device. Only use \fBqlgc_s_download\fR in single-user mode. Using
607 601 \fBqlgc_s_download\fR to update a host adapter while there is\fB I/O\fR
608 602 activity through that adapter will cause the adapter to reset. Newly updated
609 603 FCode will not be executed or visible until a system reboot.
610 604 .sp
611 605 .ne 2
612 606 .na
613 607 \fB\fB-f\fR \fIfcode-file\fR\fR
614 608 .ad
615 609 .RS 17n
616 610 When invoked without the \fB-f\fR option, the current version of the FCode in
617 611 each \fBFC100/P\fR,\fB FC100/2P PCI\fR card is printed.
618 612 .RE
619 613
620 614 .RE
621 615
622 616 .sp
623 617 .ne 2
624 618 .na
625 619 \fB\fBrelease\fR \fIpathname\fR\fR
626 620 .ad
627 621 .sp .6
628 622 .RS 4n
629 623 Release a reservation held on the specified disk. The pathname should be the
630 624 physical or logical pathname for the disk.
631 625 .sp
632 626 This subcommand is included for historical and diagnostic purposes only.
633 627 .RE
634 628
635 629 .sp
636 630 .ne 2
637 631 .na
638 632 \fB\fBremove_device\fR [ \fB-F\fR ] \fIenclosure\fR[,\fIdev\fR]\|.\|.\|.\||
639 633 \fIpathname\fR\|.\|.\|.\fR
640 634 .ad
641 635 .sp .6
642 636 .RS 4n
643 637 Assists the user in hot removing a device or a chain of devices. This
644 638 subcommand can also be used to remove entire enclosures. This subcommand
645 639 applies to the \fBSENA\fR, Sun Fire 880 internal storage subsystem, and
646 640 individual \fBFC_AL\fR drives. Refer to \fBNOTES\fR for limitations on hotplug
647 641 operations. For the \fBSENA\fR, Sun Fire 880 internal storage subsystem, and
648 642 individual \fBFC_AL\fR devices, this subcommand guides the user through the hot
649 643 removal of a device or devices. During execution it will ask the user to verify
650 644 the list of devices to be removed is correct, at which point the user can
651 645 continue or quit. It then prepares the disk(s) or enclosure(s) for removal and
652 646 interactively asks the user to remove the disk(s) or enclosure(s).
653 647 .sp
654 648 For Multi-Hosted disk, the steps taken are:
655 649 .RS +4
656 650 .TP
657 651 .ie t \(bu
658 652 .el o
659 653 Issue the \fBluxadm\fR \fBremove_device\fR command on the first host. When
660 654 prompted to continue, wait.
661 655 .RE
662 656 .RS +4
663 657 .TP
664 658 .ie t \(bu
665 659 .el o
666 660 Issue the \fBluxadm\fR \fBremove_device\fR command on the secondary hosts. When
667 661 prompted to continue, wait.
668 662 .RE
669 663 .RS +4
670 664 .TP
671 665 .ie t \(bu
672 666 .el o
673 667 Continue with the \fBremove_device\fR command on the first host. Remove the
674 668 device when prompted to do so.
675 669 .RE
676 670 .RS +4
677 671 .TP
678 672 .ie t \(bu
679 673 .el o
680 674 Complete the \fBluxadm\fR \fBremove_device\fR command on the additional hosts.
681 675 .RE
682 676 .sp
683 677 .ne 2
684 678 .na
685 679 \fB\fB-F\fR\fR
686 680 .ad
687 681 .RS 6n
688 682 Instructs \fBluxadm\fR to attempt to hot plug one or more devices even if those
689 683 devices are being used by this host (and are, therefore, \fBbusy\fR or
690 684 \fBreserved\fR), to \fBforce\fR the hotplugging operation.
691 685 .sp
692 686 \fBWarning\fR: Removal of a device which has data that is currently being used
693 687 will cause unpredictable results. Users should attempt to hotplug normally
694 688 (without \fB-F\fR) first, only resorting to this option when sure of the
695 689 consequences of overriding normal hotplugging checks.
696 690 .RE
697 691
698 692 .RE
699 693
700 694 .sp
701 695 .ne 2
702 696 .na
703 697 \fB\fBreserve\fR \fIpathname\fR\fR
704 698 .ad
705 699 .sp .6
706 700 .RS 4n
707 701 Reserve the specified disk for exclusive use by the issuing host. The pathname
708 702 used should be the physical or logical pathname for the disk.
709 703 .sp
710 704 This subcommand is included for historical and diagnostic purposes only.
711 705 .RE
712 706
713 707 .sp
714 708 .ne 2
715 709 .na
716 710 \fB\fBset_boot_dev\fR [ \fB-y\fR ] \fIpathname\fR\fR
717 711 .ad
718 712 .sp .6
719 713 .RS 4n
720 714 Set the boot-device variable in the system \fBPROM\fR to the physical device
721 715 name specified by \fIpathname\fR, which can be a block special device or the
722 716 pathname of the directory on which the boot file system is mounted. The command
723 717 normally runs interactively requesting confirmation for setting the default
724 718 boot-device in the \fBPROM\fR. The \fB-y\fR option can be used to run it
725 719 non-interactively, in which case no confirmation is requested or required.
726 720 .RE
727 721
728 722 .sp
729 723 .ne 2
730 724 .na
731 725 \fB\fBstart\fR \fIpathname\fR\fR
732 726 .ad
733 727 .sp .6
734 728 .RS 4n
735 729 Spin up the specified disk(s) in a SENA.
736 730 .RE
737 731
738 732 .sp
↓ open down ↓ |
410 lines elided |
↑ open up ↑ |
739 733 .ne 2
740 734 .na
741 735 \fB\fBstop\fR \fIpathname\fR...\fR
742 736 .ad
743 737 .sp .6
744 738 .RS 4n
745 739 Spin down the specified disks in a SENA.
746 740 .RE
747 741
748 742 .SS "SENA, Sun Fire 880 Internal Storage Subsystem, and Individual FC_AL Drive Expert Mode Subcommands"
749 -.LP
750 743 The following subcommands are for expert use only, and are applicable only to
751 744 the \fBSENA\fR, Sun Fire 880 internal storage subsystem, and fiber channel
752 745 loops. They should only be used by users that are knowledgeable about the
753 746 \fBSENA\fR subsystem and fiber channel loops.
754 747 .sp
755 748 .LP
756 749 If you specify a disk to an expert subcommand that operates on a bus, the
757 750 subcommand operates on the bus to which the specified disk is attached.
758 751 .sp
759 752 .ne 2
760 753 .na
761 754 \fB\fB-e\fR \fBbypass\fR \fB[\fR\fB-ab\fR\fB]\fR \fIenclosure\fR,\fIdev\fR\fR
762 755 .ad
763 756 .br
764 757 .na
765 758 \fB\fB-e\fR \fBbypass\fR \fB-f\fR \fIenclosure\fR\fR
766 759 .ad
767 760 .sp .6
768 761 .RS 4n
769 762 Request the enclosure services controller to set the LRC (Loop Redundancy
770 763 Circuit) to the bypassed state for the port and device specified.
771 764 .sp
772 765 This subcommand supports the following options:
773 766 .sp
774 767 .ne 2
775 768 .na
776 769 \fB\fB-a\fR\fR
777 770 .ad
778 771 .RS 6n
779 772 Bypass port \fBa\fR of the device specified.
780 773 .RE
781 774
782 775 .sp
783 776 .ne 2
784 777 .na
785 778 \fB\fB-b\fR\fR
786 779 .ad
787 780 .RS 6n
788 781 Bypass port \fBb\fR of the device specified.
789 782 .RE
790 783
791 784 .RE
792 785
793 786 .sp
794 787 .ne 2
795 788 .na
796 789 \fB\fB-e\fR \fBdump_map\fR \fIfibre_channel_HBA_port\fR\fR
797 790 .ad
798 791 .sp .6
799 792 .RS 4n
800 793 Display WWN data for a target device or host bus adapter on the specified fibre
801 794 channel port. If there are no target devices on the specified port, an error is
802 795 returned.
803 796 .RE
804 797
805 798 .sp
806 799 .ne 2
807 800 .na
808 801 \fB\fB-e\fR \fBenable\fR \fB[\fR\fB-ab\fR\fB]\fR \fIenclosure\fR,\fIdev\fR\fR
809 802 .ad
810 803 .br
811 804 .na
812 805 \fB\fB-e\fR \fBenable\fR \fB-f\fR \fIenclosure\fR\fR
813 806 .ad
814 807 .sp .6
815 808 .RS 4n
816 809 Request the enclosure services controller to set the LRC (Loop Redundancy
817 810 Circuit) to the enabled state for the port and device specified.
818 811 .sp
819 812 This subcommand supports the following options:
820 813 .sp
821 814 .ne 2
822 815 .na
823 816 \fB\fB-a\fR\fR
824 817 .ad
825 818 .RS 6n
826 819 Enable port \fBa\fR of the device specified.
827 820 .RE
828 821
829 822 .sp
830 823 .ne 2
831 824 .na
832 825 \fB\fB-b\fR\fR
833 826 .ad
834 827 .RS 6n
835 828 Enable port \fBb\fR of the device specified.
836 829 .RE
837 830
838 831 .RE
839 832
840 833 .sp
841 834 .ne 2
842 835 .na
843 836 \fB\fB\fR\fB-e\fR \fBforcelip\fR \fIenclosure\fR[\fB,\fR\fIdev\fR] \|.\|.\|. |
844 837 \fIpathname\fR\|.\|.\|.\fR
845 838 .ad
846 839 .sp .6
847 840 .RS 4n
848 841 Force the link to reinitialize, using the Loop Initialization Primitive
849 842 (\fBLIP\fR) sequence. The enclosure or pathname can specify any device on the
850 843 loop. Use the pathname to specify a specific path for multiple loop
851 844 configurations.
852 845 .sp
853 846 This is an expert only command and should be used with caution. It will reset
854 847 all ports on the loop.
855 848 .RE
856 849
857 850 .sp
858 851 .ne 2
859 852 .na
↓ open down ↓ |
100 lines elided |
↑ open up ↑ |
860 853 \fB\fB\fR\fB-e\fR \fBrdls\fR \fIenclosure\fR[\fB,\fR\fIdev\fR] \|.\|.\|. |
861 854 \fIpathname\fR\|.\|.\|.\fR
862 855 .ad
863 856 .sp .6
864 857 .RS 4n
865 858 Read and display the link error status information for all available devices on
866 859 the loop that contains the device specified by the enclosure or pathname.
867 860 .RE
868 861
869 862 .SS "Other Expert Mode Subcommands"
870 -.LP
871 863 See \fBNOTES\fR for limitations of these subcommands. They should only be used
872 864 by users that are knowledgeable about the systems they are managing.
873 865 .sp
874 866 .LP
875 867 These commands do not apply to the Sun Fire 880 internal storage subsystem.
876 868 .sp
877 869 .ne 2
878 870 .na
879 871 \fB\fB\fR\fB-e\fR \fBbus_getstate\fR \fIpathname\fR\fR
880 872 .ad
881 873 .RS 29n
882 874 Get and display the state of the specified bus.
883 875 .RE
884 876
885 877 .sp
886 878 .ne 2
887 879 .na
888 880 \fB\fB\fR\fB-e\fR \fBbus_quiesce\fR \fIpathname\fR\fR
889 881 .ad
890 882 .RS 29n
891 883 Quiesce the specified bus.
892 884 .RE
893 885
894 886 .sp
895 887 .ne 2
896 888 .na
897 889 \fB\fB\fR\fB-e\fR \fBbus_reset\fR \fIpathname\fR\fR
898 890 .ad
899 891 .RS 29n
900 892 Reset the specified bus only.
901 893 .RE
902 894
903 895 .sp
904 896 .ne 2
905 897 .na
906 898 \fB\fB\fR\fB-e\fR \fBbus_resetall\fR \fIpathname\fR\fR
907 899 .ad
908 900 .RS 29n
909 901 Reset the specified bus and all devices.
910 902 .RE
911 903
912 904 .sp
913 905 .ne 2
914 906 .na
915 907 \fB\fB\fR\fB-e\fR \fBbus_unquiesce\fR \fIpathname\fR\fR
916 908 .ad
917 909 .RS 29n
918 910 Unquiesce the specified bus. the specified device.
919 911 .RE
920 912
921 913 .sp
922 914 .ne 2
923 915 .na
924 916 \fB\fB\fR\fB-e\fR \fBdev_getstate\fR \fIpathname\fR\fR
925 917 .ad
926 918 .RS 29n
927 919 Get and display the state of the specified device.
928 920 .RE
929 921
930 922 .sp
931 923 .ne 2
932 924 .na
933 925 \fB\fB\fR\fB-e\fR \fBdev_reset\fR \fIpathname\fR\fR
934 926 .ad
935 927 .RS 29n
936 928 Reset the specified device.
937 929 .RE
938 930
939 931 .sp
940 932 .ne 2
941 933 .na
942 934 \fB\fB\fR\fB-e\fR \fBoffline\fR \fIpathname\fR\fR
943 935 .ad
944 936 .RS 29n
945 937 Take the specified device offline.
946 938 .RE
947 939
↓ open down ↓ |
67 lines elided |
↑ open up ↑ |
948 940 .sp
949 941 .ne 2
950 942 .na
951 943 \fB\fB\fR\fB-e\fR \fBonline\fR \fIpathname\fR\fR
952 944 .ad
953 945 .RS 29n
954 946 Put the specified device online.
955 947 .RE
956 948
957 949 .SH EXAMPLES
958 -.LP
959 950 \fBExample 1 \fRDisplaying the \fBSENA\fRs and Individual FC_AL Devices on a
960 951 System
961 952 .sp
962 953 .LP
963 954 The following example finds and displays all of the \fBSENA\fRs and individual
964 955 \fBFC_AL\fR devices on a system:
965 956
966 957 .sp
967 958 .in +2
968 959 .nf
969 960 example% \fBluxadm probe\fR
970 961 .fi
971 962 .in -2
972 963 .sp
973 964
974 965 .LP
975 966 \fBExample 2 \fRDisplaying a \fBSENA\fR or Sun Fire 880 Internal Storage
976 967 Subsystem
977 968 .sp
978 969 .LP
979 970 The following example displays a \fBSENA\fR or Sun Fire 880 internal storage
980 971 subsystem:
981 972
982 973 .sp
983 974 .in +2
984 975 .nf
985 976 example% \fBluxadm display /dev/es/ses0\fR
986 977 .fi
987 978 .in -2
988 979 .sp
989 980
990 981 .LP
991 982 \fBExample 3 \fRDisplaying Two Subsystems
992 983 .sp
993 984 .LP
994 985 The following example displays two subsystems using the enclosure names:
995 986
996 987 .sp
997 988 .in +2
998 989 .nf
999 990 example% \fBluxadm display BOB system1\fR
1000 991 .fi
1001 992 .in -2
1002 993 .sp
1003 994
1004 995 .LP
1005 996 \fBExample 4 \fRDisplaying Information about the First Disk
1006 997 .sp
1007 998 .LP
1008 999 The following example displays information about the first disk in the front of
1009 1000 the enclosure named \fBBOB.\fR Use \fBf\fR to specify the front disks. Use
1010 1001 \fBr\fR to specify the rear disks.
1011 1002
1012 1003 .sp
1013 1004 .in +2
1014 1005 .nf
1015 1006 example% \fBluxadm display BOB,f0\fR
1016 1007 .fi
1017 1008 .in -2
1018 1009 .sp
1019 1010
1020 1011 .LP
1021 1012 \fBExample 5 \fRDisplaying Information on a Sun Fire 880 Internal Storage
1022 1013 Subsystem
1023 1014 .sp
1024 1015 .LP
1025 1016 The Sun Fire 880 internal storage subsystem has only one set of disks. In this
1026 1017 case, use \fIs\fR to specify the slot:
1027 1018
1028 1019 .sp
1029 1020 .in +2
1030 1021 .nf
1031 1022 example% \fBluxadm display BOB,s0\fR
1032 1023 .fi
1033 1024 .in -2
1034 1025 .sp
1035 1026
1036 1027 .LP
1037 1028 \fBExample 6 \fRDisplaying Information about a \fBSENA\fR disk, an Enclosure,
1038 1029 or an Individual \fBFC_AL\fR Drive
1039 1030 .sp
1040 1031 .LP
1041 1032 The following example displays information about a \fBSENA\fR disk, an
1042 1033 enclosure, or an individual \fBFC_AL\fR drive with the port \fBWWN\fR of
1043 1034 \fB2200002037001246\fR:
1044 1035
1045 1036 .sp
1046 1037 .in +2
1047 1038 .nf
1048 1039 example% \fBluxadm display 2200002037001246\fR
1049 1040 .fi
1050 1041 .in -2
1051 1042 .sp
1052 1043
1053 1044 .LP
1054 1045 \fBExample 7 \fRUsing Unique Characters to Issue a Subcommand
1055 1046 .sp
1056 1047 .LP
1057 1048 The following example uses only as many characters as are required to uniquely
1058 1049 identify a subcommand:
1059 1050
1060 1051 .sp
1061 1052 .in +2
1062 1053 .nf
1063 1054 example% \fBluxadm disp BOB\fR
1064 1055 .fi
1065 1056 .in -2
1066 1057 .sp
1067 1058
1068 1059 .LP
1069 1060 \fBExample 8 \fRDisplaying Error Information
1070 1061 .sp
1071 1062 .LP
1072 1063 The following example displays error information about the loop that the
1073 1064 enclosure \fBBOB\fR is on:
1074 1065
1075 1066 .sp
1076 1067 .in +2
1077 1068 .nf
1078 1069 example% \fBluxadm display \fR\fB-r\fR\fB BOB\fR
1079 1070 .fi
1080 1071 .in -2
1081 1072 .sp
1082 1073
1083 1074 .LP
1084 1075 \fBExample 9 \fRDownloading New Firmware into the Interface Board
1085 1076 .sp
1086 1077 .LP
1087 1078 The following example downloads new firmware into the Interface Board in the
1088 1079 enclosure named \fBBOB\fR (using the default path for the file to download):
1089 1080
1090 1081 .sp
1091 1082 .in +2
1092 1083 .nf
1093 1084 example% \fBluxadm download \fR\fB-s\fR\fB BOB\fR
1094 1085 .fi
1095 1086 .in -2
1096 1087 .sp
1097 1088
1098 1089 .LP
1099 1090 \fBExample 10 \fRDisplaying Information from the \fBSCSI\fR Inquiry Command
1100 1091 .sp
1101 1092 .LP
1102 1093 The following example displays information from the \fBSCSI\fR inquiry command
1103 1094 from all individual disks on the system, using only as many characters as
1104 1095 necessary to uniquely identify the inquiry subcommand:
1105 1096
1106 1097 .sp
1107 1098 .in +2
1108 1099 .nf
1109 1100 example% \fBluxadm inq /dev/rdsk/c?t?d?s2\fR
1110 1101 .fi
1111 1102 .in -2
1112 1103 .sp
1113 1104
1114 1105 .LP
1115 1106 \fBExample 11 \fRHotplugging
1116 1107 .sp
1117 1108 .LP
1118 1109 The following example hotplugs a new drive into the first slot in the front of
1119 1110 the enclosure named \fBBOB:\fR
1120 1111
1121 1112 .sp
1122 1113 .in +2
1123 1114 .nf
1124 1115 example% \fBluxadm insert_device BOB,f0\fR
1125 1116 .fi
1126 1117 .in -2
1127 1118 .sp
1128 1119
1129 1120 .sp
1130 1121 .LP
1131 1122 The following example hotplugs a new drive into the first slot in the Sun Fire
1132 1123 880 internal storage subsystem named SF880-1:
1133 1124
1134 1125 .sp
1135 1126 .in +2
1136 1127 .nf
1137 1128 example% \fBluxadm insert_device SF880-1,s0\fR
1138 1129 .fi
1139 1130 .in -2
1140 1131 .sp
1141 1132
1142 1133 .LP
1143 1134 \fBExample 12 \fRRunning an Expert Subcommand
1144 1135 .sp
1145 1136 .LP
1146 1137 The following example runs an expert subcommand. The subcommand forces a loop
1147 1138 initialization on the loop that the enclosure \fBBOB\fR is on:
1148 1139
1149 1140 .sp
1150 1141 .in +2
1151 1142 .nf
1152 1143 example% \fBluxadm \fR\fB-e\fR\fB forcelip BOB\fR
1153 1144 .fi
1154 1145 .in -2
1155 1146 .sp
1156 1147
1157 1148 .LP
1158 1149 \fBExample 13 \fRUsing the Expert Mode Hot Plugging Subcommands
1159 1150 .sp
1160 1151 .LP
1161 1152 An example of using the expert mode hot plugging subcommands to hot remove a
1162 1153 disk follows. See \fBNOTES\fR for hot plugging limitations.
1163 1154
1164 1155 .sp
1165 1156 .LP
1166 1157 The first step reserves the SCSI device so that it can't be accessed by way of
1167 1158 its second SCSI bus:
1168 1159
1169 1160 .sp
1170 1161 .in +2
1171 1162 .nf
1172 1163 example# \fBluxadm reserve /dev/rdsk/c1t8d0s2\fR
1173 1164 .fi
1174 1165 .in -2
1175 1166 .sp
1176 1167
1177 1168 .LP
1178 1169 \fBExample 14 \fRTaking the Disk to be Removed Offline
1179 1170 .sp
1180 1171 .LP
1181 1172 The next two steps take the disk to be removed offline then quiesce the bus:
1182 1173
1183 1174 .sp
1184 1175 .in +2
1185 1176 .nf
1186 1177 example# \fBluxadm \fR\fB-e\fR\fB offline /dev/rdsk/c1t8d0s2\fR
1187 1178 example# \fBluxadm -e bus_quiesce /dev/rdsk/c1t8d0s2\fR
1188 1179 .fi
1189 1180 .in -2
1190 1181 .sp
1191 1182
1192 1183 .LP
1193 1184 \fBExample 15 \fRUnquiescing the Bus
1194 1185 .sp
1195 1186 .LP
1196 1187 The user then removes the disk and continues by unquiescing the bus, putting
1197 1188 the disk back online, then unreserving it:
1198 1189
1199 1190 .sp
↓ open down ↓ |
231 lines elided |
↑ open up ↑ |
1200 1191 .in +2
1201 1192 .nf
1202 1193 example# \fBluxadm \fR\fB-e\fR\fB bus_unquiesce /dev/rdsk/c1t8d0s2\fR
1203 1194 example# \fBluxadm \fR\fB-e\fR\fB online /dev/rdsk/c1t8d0s2\fR
1204 1195 example# \fBluxadm release /dev/rdsk/c1t8d0s2\fR
1205 1196 .fi
1206 1197 .in -2
1207 1198 .sp
1208 1199
1209 1200 .SH ENVIRONMENT VARIABLES
1210 -.LP
1211 1201 See \fBenviron\fR(5) for a description of the \fBLANG\fR environment variable
1212 1202 that affects the execution of \fBluxadm\fR.
1213 1203 .SH EXIT STATUS
1214 -.LP
1215 1204 The following exit values are returned:
1216 1205 .sp
1217 1206 .ne 2
1218 1207 .na
1219 1208 \fB\fB0\fR\fR
1220 1209 .ad
1221 1210 .RS 9n
1222 1211 Successful completion.
1223 1212 .RE
1224 1213
1225 1214 .sp
1226 1215 .ne 2
↓ open down ↓ |
2 lines elided |
↑ open up ↑ |
1227 1216 .na
1228 1217 \fB\fB\(mi1\fR\fR
1229 1218 .ad
1230 1219 .RS 9n
1231 1220 An error occurred.
1232 1221 .RE
1233 1222
1234 1223 .SH FILES
1235 1224 .ne 2
1236 1225 .na
1237 -\fB\fBusr/lib/firmware/fc_s/fc_s_fcode\fR\fR
1226 +\fB\fB/usr/lib/firmware/fc_s/fc_s_fcode\fR\fR
1238 1227 .ad
1239 1228 .sp .6
1240 1229 .RS 4n
1241 1230
1242 1231 .RE
1243 1232
1244 1233 .sp
1245 1234 .ne 2
1246 1235 .na
1247 -\fB\fBusr/lib/locale/C/LC_MESSAGES/ibfirmware\fR\fR
1236 +\fB\fB/usr/lib/locale/C/LC_MESSAGES/ibfirmware\fR\fR
1248 1237 .ad
1249 1238 .sp .6
1250 1239 .RS 4n
1251 1240
1252 1241 .RE
1253 1242
1254 1243 .SH SEE ALSO
1255 -.LP
1256 1244 \fBdevlinks\fR(1M), \fBdisks\fR(1M), \fBattributes\fR(5), \fBenviron\fR(5),
1257 1245 \fBses\fR(7D)
1258 1246 .SH NOTES
1259 -.LP
1260 1247 Currently, only some device drivers
1261 1248 support hot plugging. If hot plugging is attempted on a disk or bus where it is
1262 1249 not supported, an error message of the form:
1263 1250 .sp
1264 1251 .in +2
1265 1252 .nf
1266 1253 luxadm: can't acquire "PATHNAME": No such file or directory
1267 1254 .fi
1268 1255 .in -2
1269 1256 .sp
1270 1257
1271 1258 .sp
1272 1259 .LP
1273 1260 will be displayed.
1274 1261 .sp
1275 1262 .LP
1276 1263 You must be careful not to quiesce a bus that contains the root or the
1277 1264 \fB/usr\fR filesystems or any swap data. If you do quiesce such a bus a
1278 1265 deadlock can result, requiring a system reboot.
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX