usr/src/man/man1m/cfgadm_sata.1m

   1 '\" te
   2 .\" Copyright (c) 2007 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 CFGADM_SATA 1M "Aug 27, 2007"
   7 .SH NAME
   8 cfgadm_sata \- SATA hardware-specific commands for cfgadm
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/sbin/cfgadm\fR [\fB-f\fR] [\fB-y\fR | \fB-n\fR] [\fB-v\fR] [\fB-o\fR \fIhardware_options\fR]
  13      \fB-c\fR \fIfunction\fR \fIap_id\fR...
  14 .fi
  15
  16 .LP
  17 .nf
  18 \fB/usr/sbin/cfgadm\fR [\fB-f\fR] [\fB-y\fR | \fB-n\fR] [\fB-v\fR] [\fB-o\fR \fIhardware_options\fR]
  19      \fB-x\fR \fIhardware_function\fR \fIap_id\fR...
  20 .fi
  21
  22 .LP
  23 .nf
  24 \fB/usr/sbin/cfgadm\fR [\fB-v\fR] [\fB-a\fR] [\fB-s\fR \fIlisting_options\fR]
  25      [\fB-o\fR \fIhardware_options\fR] [\fB-l\fR [\fIap_id\fR | \fIap_type\fR]...]
  26 .fi
  27
  28 .LP
  29 .nf
  30 \fB/usr/sbin/cfgadm\fR [\fB-v\fR] [\fB-o\fR \fIharware_options\fR] \fB-t\fR \fIap_id\fR...
  31 .fi
  32
  33 .LP
  34 .nf
  35 \fB/usr/sbin/cfgadm\fR [\fB-v\fR] [\fB-o\fR \fIhardware_options\fR] \fB-h\fR [\fIap_id\fR]...
  36 .fi
  37
  38 .SH DESCRIPTION
  39 .sp
  40 .LP
  41 The \fBSATA\fR hardware specific library, \fB/usr/lib/cfgadm/sata.so.1\fR,
  42 provides the functionality for \fBSATA\fR hot plugging through the \fBcfgadm\fR
  43 command. \fBcfgadm\fR operates on attachment points, which are locations in the
  44 system where hardware resources can be dynamically reconfigured. See
  45 \fBcfgadm\fR(1M) for information regarding attachment points.
  46 .sp
  47 .LP
  48 Each \fBSATA\fR controller's and port multiplier's device port is represented
  49 by an attachment point in the device tree. \fBSATA\fR devices, connected and
  50 configured in the system are shown as the attachment point name extension. The
  51 terms "attachment point" and "\fBSATA\fR port" are used interchangeably in the
  52 following description.
  53 .sp
  54 .LP
  55 Attachment points are named through \fBap_id\fRs. All the \fBSATA\fR attachment
  56 points \fBap_id\fR consist of a string in the following form:
  57 .sp
  58 .in +2
  59 .nf
  60 sataX/P[.M][::dsk/cXtYd0]
  61 .fi
  62 .in -2
  63
  64 .sp
  65 .LP
  66 where
  67 .sp
  68 .ne 2
  69 .na
  70 \fBX\fR
  71 .ad
  72 .RS 14n
  73 is the \fBSATA\fR controller number
  74 .RE
  75
  76 .sp
  77 .ne 2
  78 .na
  79 \fBP\fR
  80 .ad
  81 .RS 14n
  82 is the \fBSATA\fR controller's device port number (0 to 31)
  83 .RE
  84
  85 .sp
  86 .ne 2
  87 .na
  88 \fBM\fR
  89 .ad
  90 .RS 14n
  91 is the port multiplier's device port number (0 to 14) the port multiplier host
  92 port number (15). It is used only when the port multiplier is attached to the
  93 \fBSATA\fR controller's device port.
  94 .RE
  95
  96 .sp
  97 .ne 2
  98 .na
  99 \fBdev/cXtYd0\fR
 100 .ad
 101 .RS 14n
 102 identifies the attached \fBSATA\fR device
 103 .RE
 104
 105 .sp
 106 .ne 2
 107 .na
 108 \fBY\fR
 109 .ad
 110 .RS 14n
 111 is a target number
 112 .RE
 113
 114 .sp
 115 .LP
 116 In general, the device identifier is derived from the corresponding logical
 117 link for the device in /\fIdev\fR. Because only one \fBLUN\fR (\fBLUN\fR 0) is
 118 supported by the \fBSATA\fR device, the "d" component of the device string will
 119 always have number 0 (zero).
 120 .sp
 121 .LP
 122 For example, the logical \fBap_id\fR of the device port 4 of the port
 123 multiplier connected to the device port 5 of the \fBSATA\fR controller 2 would
 124 be:
 125 .sp
 126 .in +2
 127 .nf
 128 sata2/5.4
 129 .fi
 130 .in -2
 131
 132 .sp
 133 .LP
 134 If the \fBSATA\fR disk or \fBCD\fR/\fBDVD\fR device is connected to this
 135 attachment point, and the device is configured, the \fIap_id\fR would be:
 136 .sp
 137 .in +2
 138 .nf
 139 sata2/5.4::dsk/c2t645d0
 140 .fi
 141 .in -2
 142
 143 .sp
 144 .LP
 145 The \fIcXtYd0\fR string identifying a device has one-to-one correspondence to
 146 the device attachment point.
 147 .sp
 148 .LP
 149 A simple listing of attachment points in the system will include all \fBSATA\fR
 150 device ports and attached devices. For example:
 151 .sp
 152 .in +2
 153 .nf
 154 #\fBcfgadm -l\fR
 155 Ap_Id                     Type        Receptacle   Occupant     Condition
 156   sata0/0::dev/c0t0d0     disk        connected    configured   ok
 157   sata0/1::dev/c0t1d0     disk        connected    configured   ok
 158   sata0/2::dev/c0t2d0     cd-dvd      connected    configured   ok
 159   sata0/3                 sata-port   empty        unconfigured ok
 160   sata1/0                 sata-port   disconnected unconfigured unknown
 161   sata1/1                 sata port   disconnected unconfigured unknown
 162   sata1/2                 sata port   empty        unconfigured ok
 163   sata1/3.15              sata-pmult  connected    configured   ok
 164   sata1/3.0::dev/c0t512d0 disk        connected    configured   ok
 165   sata1/3.1               sata-port   empty        unconfigured ok
 166   sata1/3.2               sata-port   empty        unconfigured ok
 167   sata1/3.3               sata-port   empty        unconfigured ok
 168   usb0/1                  unknown     empty        unconfigured ok
 169   usb0/2                  unknown     empty        unconfigured ok
 170 .fi
 171 .in -2
 172 .sp
 173
 174 .sp
 175 .LP
 176 See \fBcfgadm\fR(1M)for more information regarding listing of attachment
 177 points.
 178 .sp
 179 .LP
 180 The receptacle state for attachment point at the \fBSATA\fR port have the
 181 following meanings:
 182 .sp
 183 .ne 2
 184 .na
 185 \fBempty\fR
 186 .ad
 187 .RS 16n
 188 The \fBSATA\fR port is powered-on and enabled. No device presence was detected
 189 on this port.
 190 .RE
 191
 192 .sp
 193 .ne 2
 194 .na
 195 \fBdisconnected\fR
 196 .ad
 197 .RS 16n
 198 The \fBSATA\fR port is not enabled or the \fBSATA\fR device presence was
 199 detected but no communication with the device was established, or the port has
 200 failed.
 201 .RE
 202
 203 .sp
 204 .ne 2
 205 .na
 206 \fBconnected\fR
 207 .ad
 208 .RS 16n
 209 The \fBSATA\fR device is detected on the port the communication with the device
 210 is established.
 211 .RE
 212
 213 .sp
 214 .LP
 215 The occupant (device attached to the \fBSATA\fR port) state have the following
 216 meanings:
 217 .sp
 218 .ne 2
 219 .na
 220 \fBconfigured\fR
 221 .ad
 222 .RS 16n
 223 The attached \fBSATA\fR device is configured and ready to use by the operating
 224 system.
 225 .RE
 226
 227 .sp
 228 .ne 2
 229 .na
 230 \fBunconfigured\fR
 231 .ad
 232 .RS 16n
 233 No device is attached, or the \fBSATA\fR device attached to the \fBSATA\fR port
 234 was not yet configured. To configure it, run the command "\fBcfgadm -c
 235 configure ap_id\fR".
 236 .RE
 237
 238 .sp
 239 .LP
 240 The attachment point (\fBSATA\fR port) condition have the following meanings:
 241 .sp
 242 .ne 2
 243 .na
 244 \fBok\fR
 245 .ad
 246 .RS 11n
 247 The \fBSATA\fR port is powered-on and enabled, and is ready for use.
 248 .RE
 249
 250 .sp
 251 .ne 2
 252 .na
 253 \fBfailed\fR
 254 .ad
 255 .RS 11n
 256 The \fBSATA\fR port failed. It may be disabled and/or powered-off by the
 257 system. It is unusable and its condition is unknown. It may be due to the
 258 device plugged-in.
 259 .RE
 260
 261 .sp
 262 .ne 2
 263 .na
 264 \fBunknown\fR
 265 .ad
 266 .RS 11n
 267 The \fBSATA\fR port is disabled and its condition is unknown.
 268 .RE
 269
 270 .sp
 271 .LP
 272 A "state table" is the combination of an attachment point receptacle state, an
 273 occupant state, and an attachment point (\fBSATA\fR port) condition. The valid
 274 states are:
 275 .sp
 276 .ne 2
 277 .na
 278 \fBempty/unconfigured/ok\fR
 279 .ad
 280 .sp .6
 281 .RS 4n
 282 The \fBSATA\fR port is enabled and active. No device presence was detected.
 283 .RE
 284
 285 .sp
 286 .ne 2
 287 .na
 288 \fBdisconnected/unconfigured/ok\fR
 289 .ad
 290 .sp .6
 291 .RS 4n
 292 The \fBSATA\fR port is enabled and a device presence was detected but no
 293 communications with the device was established.
 294 .RE
 295
 296 .sp
 297 .ne 2
 298 .na
 299 \fBdisconnected/unconfigured/unknown\fR
 300 .ad
 301 .sp .6
 302 .RS 4n
 303 The \fBSATA\fR Port is disabled and its condition is unknown.
 304 .RE
 305
 306 .sp
 307 .ne 2
 308 .na
 309 \fBdisconnected/unconfigured/failed\fR
 310 .ad
 311 .sp .6
 312 .RS 4n
 313 The \fBSATA\fR Port is disabled and unusable. The port was disabled by the
 314 system due to a system-detected failure.
 315 .RE
 316
 317 .sp
 318 .ne 2
 319 .na
 320 \fBconnected/unconfigured/ok\fR
 321 .ad
 322 .sp .6
 323 .RS 4n
 324 The \fBSATA\fR Port is enabled and active. A device presence was detected and
 325 the communication with a device was established. The device is not configured
 326 to be used by the \fBOS\fR.
 327 .RE
 328
 329 .sp
 330 .ne 2
 331 .na
 332 \fBconnected/configured/ok\fR
 333 .ad
 334 .sp .6
 335 .RS 4n
 336 The device is present and configured, and is ready to use by the \fBOS\fR.
 337 .RE
 338
 339 .SH OPTIONS
 340 .sp
 341 .LP
 342 \fBcfgadm\fR defines several types of operations besides listing (\fB-l\fR).
 343 These operations include testing, (\fB-t\fR), invoking configuration state
 344 changes, (\fB-c\fR), invoking hardware specific functions (\fB-x\fR), and
 345 obtaining configuration administration help messages (\fB-h\fR).
 346 .sp
 347 .ne 2
 348 .na
 349 \fB\fB-c\fR \fIfunction\fR\fR
 350 .ad
 351 .sp .6
 352 .RS 4n
 353 The following generic \fIfunction\fRs are defined for the \fBSATA\fR hardware
 354 specific library. For \fBSATA\fR port attachment point, the following
 355 configuration state change operations are supported:
 356 .sp
 357 .ne 2
 358 .na
 359 \fBconnect\fR
 360 .ad
 361 .sp .6
 362 .RS 4n
 363 Enable (activate) the \fBSATA\fR port and establish the communication with an
 364 attached device. This operation implies powering-on the port if necessary.
 365 .RE
 366
 367 .sp
 368 .ne 2
 369 .na
 370 \fBdisconnect\fR
 371 .ad
 372 .sp .6
 373 .RS 4n
 374 Unconfigure the attached device, if it is not already unconfigured, and disable
 375 (deactivate) the \fBSATA\fR port. A subsequent "\fBconnect\fR" command enables
 376 \fBSATA\fR port operation but does not bring a device to the "configured"
 377 state.
 378 .RE
 379
 380 For a \fBSATA\fR device attached to the \fBSATA\fR port following state change
 381 operations are supported:
 382 .sp
 383 .ne 2
 384 .na
 385 \fBconfigure\fR
 386 .ad
 387 .RS 15n
 388 Configure new device for use by the operating system if it is not already
 389 configured. This command also implies connect operation, if necessary.
 390 .RE
 391
 392 .sp
 393 .ne 2
 394 .na
 395 \fBunconfigure\fR
 396 .ad
 397 .RS 15n
 398 Unconfigure the device connected to the \fBSATA\fR port if it is not already
 399 unconfigured.
 400 .RE
 401
 402 The \fBconfigure\fR and \fBunconfigure\fR operations cannot be used for an
 403 attachment point where the port multiplier is connected. Port multipliers are
 404 configured and unconfigured automatically by the system. However, configure and
 405 unconfigure operations apply to all \fBSATA\fR devices connected to the port
 406 multiplier's device ports.
 407 .RE
 408
 409 .sp
 410 .ne 2
 411 .na
 412 \fB\fB-f\fR\fR
 413 .ad
 414 .sp .6
 415 .RS 4n
 416 Not supported.
 417 .RE
 418
 419 .sp
 420 .ne 2
 421 .na
 422 \fB\fB-h\fR \fIap_id\fR\fR
 423 .ad
 424 .sp .6
 425 .RS 4n
 426 \fBSATA\fR specific help can be obtained by using the help option with any
 427 \fBSATA\fR attachment point.
 428 .RE
 429
 430 .sp
 431 .ne 2
 432 .na
 433 \fB\fB-l\fR [\fB-v\fR]\fR
 434 .ad
 435 .sp .6
 436 .RS 4n
 437 The \fB-l\fR option works as described in \fBcfgadm\fR(1M). When paired with
 438 the \fB-v\fR option, the "Information" field contains the following
 439 \fBSATA\fR-specific information:
 440 .RS +4
 441 .TP
 442 .ie t \(bu
 443 .el o
 444 Mfg: manufacturer string
 445 .RE
 446 .RS +4
 447 .TP
 448 .ie t \(bu
 449 .el o
 450 Product: product string
 451 .RE
 452 .RS +4
 453 .TP
 454 .ie t \(bu
 455 .el o
 456 No: product Serial Number
 457 .RE
 458 .RE
 459
 460 .sp
 461 .ne 2
 462 .na
 463 \fB\fB-o\fR \fIhardware_options\fR\fR
 464 .ad
 465 .sp .6
 466 .RS 4n
 467 No hardware specific options are currently defined.
 468 .RE
 469
 470 .sp
 471 .ne 2
 472 .na
 473 \fB\fB-s\fR \fIlisting_options\fR\fR
 474 .ad
 475 .sp .6
 476 .RS 4n
 477 Attachment points of class \fBSATA\fR can be listed by using the select
 478 suboption. See \fBcfgadm\fR(1M).
 479 .RE
 480
 481 .sp
 482 .ne 2
 483 .na
 484 \fB\fB-t\fR \fIap_id\fR\fR
 485 .ad
 486 .sp .6
 487 .RS 4n
 488 Perform self-test of the \fBSATA\fR port, if supported by the \fBSATA\fR
 489 controller. If a port self-test operation is not supported by the \fBSATA\fR
 490 controller, an error message is issued.
 491 .RE
 492
 493 .sp
 494 .ne 2
 495 .na
 496 \fB\fB-x\fR \fIhardware_function\fR\fR
 497 .ad
 498 .sp .6
 499 .RS 4n
 500 Perform hardware specific function.
 501 .sp
 502 Some of the following commands used on the \fBSATA\fR ports or the \fBSATA\fR
 503 controller may affect any \fBSATA\fR devices that have been attached, as noted.
 504 \fBap_id\fR refers to \fBSATA\fR port or the entire \fBSATA\fR controller, as
 505 noted. If the operation implies unconfiguring a device, but it cannot be
 506 unconfigured (that is, the device contains a mounted filesystem), an error
 507 message is issued and the operation is not performed. An error message will be
 508 also issued if the \fBSATA\fR controller does not support specified operation.
 509 .sp
 510 .ne 2
 511 .na
 512 \fBsata_reset_device ap_id\fR
 513 .ad
 514 .sp .6
 515 .RS 4n
 516 Reset the \fBSATA\fR device attached to \fBap_id\fR \fBSATA\fR port. The
 517 \fBSATA\fR port state does not change.
 518 .RE
 519
 520 .sp
 521 .ne 2
 522 .na
 523 \fBsata_reset_port ap_id\fR
 524 .ad
 525 .sp .6
 526 .RS 4n
 527 Reset the \fBSATA\fR port specified by \fBap_id\fR. If a \fBSATA\fR device is
 528 attached to the port, it is also reset. This operation may be also performed on
 529 the port to which a port multiplier is connected. If a port multiplier is
 530 connected to the \fBSATA\fR controller port, the \fBSATA\fR devices attached to
 531 the port multiplier may not be reset
 532 .RE
 533
 534 .sp
 535 .ne 2
 536 .na
 537 \fBsata_reset_all ap_id\fR
 538 .ad
 539 .sp .6
 540 .RS 4n
 541 Reset \fBSATA\fR controller specified by the controller number part in
 542 \fBap_id\fR and all attached devices and re-enumerate all connected devices,
 543 including port multipliers and devices connected to port multipliers' device
 544 ports.
 545 .sp
 546 This operations implies unconfiguring all attached devices prior to the
 547 operation. Any newly enumerated devices will be left unconfigured.
 548 .RE
 549
 550 .sp
 551 .ne 2
 552 .na
 553 \fBsata_port_deactivate ap_id\fR
 554 .ad
 555 .sp .6
 556 .RS 4n
 557 Force the deactivation of the port when all else fails. This is meant as an
 558 emergency step; use with caution.
 559 .RE
 560
 561 .sp
 562 .ne 2
 563 .na
 564 \fBsata_port_activate ap_id\fR
 565 .ad
 566 .sp .6
 567 .RS 4n
 568 Force the activation of a port. This is meant for emergency situations on a
 569 port which was deactivated to recover from errors.
 570 .RE
 571
 572 .sp
 573 .ne 2
 574 .na
 575 \fBsata_port_self_test ap_id\fR
 576 .ad
 577 .sp .6
 578 .RS 4n
 579 Perform self-test operation on the \fBSATA\fR controller. This operation
 580 implies unconfiguring all devices and resetting the \fBSATA\fR controller.
 581 .RE
 582
 583 .RE
 584
 585 .sp
 586 .ne 2
 587 .na
 588 \fB\fB-v\fR\fR
 589 .ad
 590 .sp .6
 591 .RS 4n
 592 Execute in verbose mode.
 593 .sp
 594 The following Transitions table reports the state transitions resulting from
 595 the \fB-c\fR operations and hotplugging actions:
 596 .sp
 597 .in +2
 598 .nf
 599 current state     operation       possible new state
 600 -------------     ---------       ------------------
 601 empty/
 602 unconfigured/ok   device plug-in  connected/unconfigured/ok, or
 603                                   disconnected/unconfigured/ok, or
 604                                   disconnected/unconfigured/failed
 605
 606 empty/
 607 unconfigured/ok   -c unconfigure  error message, no state change
 608
 609 empty/
 610 unconfigured/ok   -c configure    error message, no state change
 611
 612 empty/
 613 unconfigured/ok   -c connect      error message, no state change
 614
 615 empty/
 616 unconfigured/ok   -c disconnect   disconnected/unconfigured/unknown, or
 617                                   disconnected/unconfigured/failed
 618
 619 disconnected/
 620 unconfigured/ok   device unplug   no state change
 621
 622 disconnected/
 623 unconfigured/ok   -c unconfigure  error message, no state change
 624
 625 disconnected/
 626 unconfigured/ok   -c configure    error message, no state change
 627
 628 disconnected/
 629 unconfigured/ok   -c connect      error message, no state change
 630
 631 disconnected/
 632 unconfigured/ok   -c disconnect   error message, no state change
 633
 634 disconnected/
 635 unconfigured/
 636 unknown
 637 (no disk plugged) -c configure    error message, state change to
 638                                   empty/unconfigured/ok, or
 639                                   disconnected/unconfigured/failed
 640
 641 disconnected/
 642 unconfigured/
 643 unknown           -c configure    state change to
 644 (disk plugged)                    connected/configured/ok or,
 645                                   connected/unconfigured/ok, or
 646                                   disconnected/unconfigured/failed and
 647                                   possible error message
 648
 649 disconnected/
 650 unconfigured/
 651 unknown           -c connect      empty/unconfigured/ok, or
 652                                   connected/unconfigured/ok, or
 653                                   disconnected/unconfigured/ok, or
 654                                   disconnected/unconfigured/unknown, or
 655                                   disconnected/unconfigured/failed
 656
 657 disconnected/
 658 unconfigured/
 659 unknown           -c disconnect   error message, no state change
 660
 661 disconnected/
 662 unconfigured/
 663 failed            any command     error message, no state change
 664                   other than
 665                   -x commands
 666
 667 connected/
 668 unconfigured/ok   disk unplug     error message and state:
 669                                   empty/unconfigured/ok, or
 670                                   disconnected/unconfigured/failed
 671
 672 connected/
 673 unconfigured/ok   -c configure    connected/unconfigured/ok, or
 674                                   connected/configured/ok, or
 675                                   disconnected/unconfigured/ok, or
 676                                   disconnected/unconfigured/failed
 677
 678 connected/
 679 unconfigured/ok   -c unconfigure  error message, no state change
 680
 681 connected/
 682 unconfigured/ok   -c connect      error message, no state change
 683
 684 connected/
 685 unconfigured/ok   -c disconnect   disconnected/unconfigured/unknown, or
 686                                   disconnected/unconfigured/failed
 687
 688 connected/
 689 configured/ok     disk unplug     error message and state:
 690                                   empty/unconfigured/ok, or
 691                                   disconnected/unconfigured/failed
 692
 693 connected/
 694 configured/ok     -c configure    error message, no state change
 695
 696 connected/
 697 configured/ok     -c unconfigure  error message, if device cannot be
 698                                   unconfigured, no state change, or
 699                                   connected/unconfigured/ok, or
 700                                   disconnected/unconfigured/ok, or
 701                                   disconnected/unconfigured/failed
 702
 703 connected/
 704 configured/ok     -c connect      error message, no state change
 705
 706 connected/
 707 configured/ok     -c disconnect   error message, if device cannot be
 708                                   unconfigured, no state change, or
 709                                   disconnected/unconfigured/unknown, or
 710                                   disconnected/unconfigured/failed
 711 .fi
 712 .in -2
 713 .sp
 714
 715 .RE
 716
 717 .SH EXAMPLES
 718 .LP
 719 \fBExample 1 \fRConfiguring a Disk
 720 .sp
 721 .LP
 722 The following command configures a disk attached to \fBSATA\fR controller 0,
 723 port 0:
 724
 725 .sp
 726 .in +2
 727 .nf
 728 example# \fBcfgadm -c configure sata0/0\fR
 729 .fi
 730 .in -2
 731 .sp
 732
 733 .sp
 734 .LP
 735 This command should be issued only when there is a device connected to the
 736 \fBSATA\fR port.
 737
 738 .LP
 739 \fBExample 2 \fRUnconfiguring a Disk
 740 .sp
 741 .LP
 742 The following command unconfigures a disk attached to \fBSATA\fR controller 0,
 743 port 3:
 744
 745 .sp
 746 .in +2
 747 .nf
 748 example# \fBcfgadm -c unconfigure sata0/3::dsk/c0t3d0\fR
 749 .fi
 750 .in -2
 751 .sp
 752
 753 .sp
 754 .LP
 755 The device identifying string is shown when the attachment point receptacle
 756 state is "connected" and occupant state is "configured".
 757
 758 .LP
 759 \fBExample 3 \fREncountering a Mounted File System While Unconfiguring a Disk
 760 .sp
 761 .LP
 762 The following command illustrates encountering a mounted file system while
 763 unconfiguring a disk:
 764
 765 .sp
 766 .in +2
 767 .nf
 768 example# \fBcfgadm -c unconfigure sata1/5::dsk/c01t35d0\fR
 769 .fi
 770 .in -2
 771 .sp
 772
 773 .sp
 774 .LP
 775 The system responds with the following:
 776
 777 .sp
 778 .in +2
 779 .nf
 780 cfgadm: Component system is busy, try again: failed to offline:
 781 /devices/pci@0,0/pci8086,244e@1e/pci1095,3124@1/sd@5,0
 782      Resource              Information
 783 ------------------  --------------------------
 784 /dev/dsk/c1t5d0s0   mounted filesystem "/mnt"
 785 .fi
 786 .in -2
 787 .sp
 788
 789 .SH FILES
 790 .sp
 791 .ne 2
 792 .na
 793 \fB/usr/lib/cfgadm/sata.so.1\fR
 794 .ad
 795 .RS 29n
 796 Hardware specific library for generic \fBSATA\fR hot plugging.
 797 .RE
 798
 799 .SH SEE ALSO
 800 .sp
 801 .LP
 802 \fBcfgadm\fR(1M), \fBconfig_admin\fR(3CFGADM), \fBlibcfgadm\fR(3LIB),
 803 \fBattributes\fR(5)
 804 .SH NOTES
 805 .sp
 806 .LP
 807 The emergency "sata_port_deactivate" operation is not supported on ports with
 808 attached disks containing critical partitions such as root (/), /usr, swap, or
 809 /var. The deactivate operation should not be attempted on such ports. Incorrect
 810 usage can result in a system hang and require a reboot.
 811 .sp
 812 .LP
 813 Hotplugging operations are not supported by all \fBSATA\fR controllers.
 814 .sp
 815 .LP
 816 If \fBSATA\fR connectors are the hot-pluggable type and the \fBSATA\fR
 817 controller supports hotplugging, a \fBSATA\fR device can be hotplugged at any
 818 time. The system detects the event and establishes the communication with the
 819 device. The device has to be configured by the explicit "\fBcfgadm -c configure
 820 ap_id\fR" command.
 821 .sp
 822 .LP
 823 If the \fBSATA\fR connectors are the hot-pluggable type and the \fBSATA\fR
 824 controller supports hotplugging, unplugging a device without unconfiguring it
 825 may result in system hang or data loss. If a device is unconfigured but
 826 receptacle state is not in a disconnected state, unplugging a device from the
 827 \fBSATA\fR port will result in error message.
 828 .SH WARNINGS
 829 .sp
 830 .LP
 831 The connectors on some \fBSATA\fR devices do not conform to \fBSATA\fR hotplug
 832 specifications. Performing hotplug operations on such devices can cause damage
 833 to the \fBSATA\fR controller and/or the \fBSATA\fR device.