2 .\" Copyright (c) 2009, 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. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
4 .\" 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
5 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH SASINFO 1M "Jul 10, 2009"
8 sasinfo \- Serial Attached SCSI HBA port command line interface
12 \fBsasinfo\fR hba [\fB-v\fR] [\fIHBA_Name\fR]...
17 \fBsasinfo\fR hba-port [\fB-lvy\fR] [\fB-a\fR \fIHBA_Name\fR] [\fIHBA_port_nam\fR]...
22 \fBsasinfo\fR expander [\fB-vt\fR] [\fB-p\fR \fIHBA_port_Name\fR] [\fIExpander_SAS_Addr\fR]...
27 \fBsasinfo\fR target-port [\fB-s\fR | \fB-v\fR] [\fITarget_port_SAS_Addr\fR]...
32 \fBsasinfo\fR logical-unit | lu [\fB-v\fR] [\fIdevice_path\fR]...
37 \fBsasinfo\fR [\fB-V\fR]
42 \fBsasinfo\fR [\fB-?\fR]
48 The \fBsasinfo\fR utility is a command line interface that collects
49 administrative information on Serial Attached SCSI-2 (SAS-2) host bus adapter
50 (HBA) that supports the Storage Management HBA API (SM-HBA). The utility
51 reports attributes of HBA ports and of expander devices and SCSI target devices
52 that might be connected to those HBA ports.
55 \fBsasinfo\fR is implemented as a set of subcommands, described below.
59 The following subcommands are supported by \fBsasinfo\fR.
67 Lists information for the HBA referenced by the specified \fIHBA_name\fR. If
68 \fIHBA_name\fR is not specified, all HBAs on the host will be listed.
78 Lists information for the HBA port referenced by the specified
79 \fIHBA_port_Name\fR. If \fIHBA_port_Name\fR is not specified, all HBA ports on
80 the host will be listed. Note that HBA ports can be dynamically
81 configured/unconfigured so that the number of HBA ports on an HBA can change as
82 connections to target devices are established. With no connections to a storage
83 device, no HBA port is configured.
93 Lists hierarchical view of the expander referenced by the specified
94 \fIExpander_SAS_Addr\fR. If no argument is specified, all expanders that are
95 visible across all HBA ports on the host will be listed.
101 \fB\fBtarget-port\fR\fR
105 Lists information for those target ports referenced by
106 \fITarget_port_SAS_Addr\fR address. If no argument is specified, all target
107 ports that are visible on the host will be listed.
113 \fB\fBlogical-unit\fR | \fBlu\fR\fR
117 Lists the logical unit referenced by the specified \fIdevice_path\fR. If
118 \fIdevice_path\fR is not specified, all SAS logical units will be listed,
119 including the SAS Management Protocol (SMP) target port.
125 The following options are supported.
129 \fB\fB-?\fR, \fB--help\fR\fR
133 Displays usage information
139 \fB\fB-a\fR, \fB--hba\fR \fIHBA_Name\fR\fR
143 Retrieve HBA port information from the \fIHBA_Name\fR of an HBA on the host.
144 The \fB-a\fR option can only be used with the \fBhba-port\fR subcommand.
150 \fB\fB-l\fR, \fB--phy-linkstat\fR\fR
154 Lists the link error statistics information for the \fBphy\fRs on the HBA port
155 referenced by the specified \fIHBA_port_Name\fR or all HBA ports if no HBA port
156 is specified. This option is used only with the \fBhba-port\fR subcommand.
162 \fB\fB-p\fR \fIHBA_port_SAS_Addr\fR, \fB--port\fR \fIHBA_port_SAS_Addr\fR\fR
166 Retrieve remote port information from the \fIHBA_port_SAS_Addr\fR of the local
167 HBA port on the host. The \fB-p\fR option can be used only with the
168 \fBexpander\fR subcommand.
174 \fB\fB-s\fR, \fB--scsi\fR\fR
178 Lists SCSI attributes for target ports that are requested for display. This
179 option is only used for the \fBtarget-port\fR subcommand.
185 \fB\fB-v\fR, \fB--verbose\fR\fR
189 Display details on hardware information, such as SAS address, topology device,
190 and so forth, based on which subcommand is invoked.
196 \fB\fB-V\fR, \fB--version\fR\fR
200 Displays the version information.
206 \fB\fB-y\fR, \fB--phy\fR\fR
210 Lists the \fBphy\fR information on the HBA port specified by
211 \fIHBA_port_Name\fR or all HBA ports if no HBA port is specified. This option
212 is used only with the \fBhba-port\fR subcommand.
217 \fBExample 1 \fRListing All HBAs
220 The following command lists all HBAs on the host.
226 HBA Name: SUNW-pmcs-0
227 HBA Name: SUNW-pmcs-1
233 \fBExample 2 \fRListing All HBAs with Details
236 The following command lists all HBAs on the host, along with related details.
237 Note that each HBA has two HBA ports configured, with each HBA port connected
243 # \fBsasinfo hba -v\fR
244 HBA Name: SUNW-pmcs-0
247 Firmware Version: 1.1
248 FCode/BIOS Version: 1.1
249 Serial Number: 111-11111
252 Number of HBA Ports: 2
253 HBA Name: SUNW-pmcs-1
256 Firmware Version: 1.1
257 FCode/BIOS Version: 1.1
258 Serial Number: 111-11111
261 Number of HBA Ports: 2
267 \fBExample 3 \fRListing All HBA Ports
270 The following command lists all HBA ports on the host.
275 # \fBsasinfo hba-port\fR
276 HBA Name: SUNW-pmcs-0
277 HBA Port Name: /dev/cfg/c1
278 HBA Port Name: /dev/cfg/c2
279 HBA Name: SUNW-pmcs-1
280 HBA Port Name: /dev/cfg/c3
281 HBA Port Name: /dev/cfg/c4
287 \fBExample 4 \fRListing all HBA Ports with Details
290 The following command lists all HBA ports, with accompanying details.
295 # \fBsasinfo hba-port -v\fR
296 HBA Name: SUNW-pmcs-0
297 HBA Port Name: /dev/cfg/c1
300 Local SAS Address: 5000c50000d756aa
301 Attached Port SAS Address: 50800201a5a502bf
303 HBA Port Name: /dev/cfg/c25000c50000d756cc
306 Local SAS Address: 5000c50000d756aa
307 Attached Port SAS Address: 50800201a5a503bf
309 HBA Name: SUNW-pmcs-1
310 HBA Port Name: /dev/cfg/c3
313 Local SAS Address: 5000c50000d756cc
314 Attached Port SAS Address: 50800201a5a504bf
316 HBA Port Name: /dev/cfg/c4
319 Local SAS Address: 5000c50000d756cc
320 Attached Port SAS Address: 50800201a5a505bf
327 \fBExample 5 \fRListing \fBphy\fR Information for All HBA Ports
330 The following command lists \fBphy\fR information for all HBA ports.
335 # \fBsasinfo hba-port -y\fR
336 HBA Name: SUNW-pmcs-0
337 HBA Port Name: /dev/cfg/c1
341 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
342 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
343 NegotiatedLinkRate: 3Gbit
346 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
347 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
348 NegotiatedLinkRate: 3Gbit
351 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
352 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
353 NegotiatedLinkRate: 3Gbit
356 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
357 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
358 NegotiatedLinkRate: 3Gbit
359 HBA Port Name: /dev/cfg/c2
363 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
364 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
365 NegotiatedLinkRate: 3Gbit
368 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
369 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
370 NegotiatedLinkRate: 3Gbit
373 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
374 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
375 NegotiatedLinkRate: 3Gbit
378 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
379 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
380 NegotiatedLinkRate: 3Gbit
381 HBA Name: SUNW-pmcs-1
382 HBA Port Name: /dev/cfg/c3
386 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
387 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
388 NegotiatedLinkRate: 3Gbit
391 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
392 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
393 NegotiatedLinkRate: 3Gbit
396 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
397 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
398 NegotiatedLinkRate: 3Gbit
401 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
402 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
403 NegotiatedLinkRate: 3Gbit
404 HBA Port Name: /dev/cfg/c4
408 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
409 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
410 NegotiatedLinkRate: 3Gbit
413 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
414 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
415 NegotiatedLinkRate: 3Gbit
418 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
419 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
420 NegotiatedLinkRate: 3Gbit
423 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
424 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
425 NegotiatedLinkRate: 3Gbit
431 \fBExample 6 \fRListing \fBphy\fR Link Error Statistics for a Specific HBA Port
434 The following command lists \fBphy\fR link error statistics for a particular
440 # \fBsasinfo hba-port -ly /dev/cfg/c1\fR
441 HBA Name: SUNW-pmcs-0
442 HBA Port Name: /dev/cfg/c1
446 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
447 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
448 NegotiatedLinkRate: 3Gbit
449 Link Error Statistics:
451 Running Disparity Error: 0
452 Loss of Dword Sync: 0
456 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
457 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
458 NegotiatedLinkRate: 3Gbit
459 Link Error Statistics:
461 Running Disparity Error: 0
462 Loss of Dword Sync: 0
466 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
467 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
468 NegotiatedLinkRate: 3Gbit
469 Link Error Statistics:
471 Running Disparity Error: 0
472 Loss of Dword Sync: 0
476 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
477 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
478 NegotiatedLinkRate: 3Gbit
479 Link Error Statistics:
481 Running Disparity Error: 0
482 Loss of Dword Sync: 0
489 \fBExample 7 \fRListing Expanders Connected to an HBA Port
492 The following command lists all expanders that are visible through the
498 # \fBsasinfo expander -p /dev/cfg/c1\fR
499 HBA Name: SUNW-pmcs-0
500 HBA Port Name: /dev/cfg/c1
501 Expander SAS Address(Tier 1): 50800201a5a502bf
502 Expander SAS Address(Tier 2): 50800201a5a50233
503 Expander SAS Address(Tier 2); 5000c5000d2da812
504 Expander SAS Address(Tier 1): 50800201a5a503bf
505 Expander SAS Address(Tier 2): 50800201a5a502d2
506 Expander SAS Address(Tier 2); 5000c5000d2da823
512 \fBExample 8 \fRListing Detailed Information on Expanders
515 The following command lists detailed information on all expanders that are
516 visible through the specified HBA port.
521 # \fBsasinfo expander -v -p /dev/cfg/c1\fR
522 HBA Name: SUNW-pmcs-0
523 HBA Port Name: /dev/cfg/c1
524 Expander SAS Address(Tier 1): 50800201a5a502bf
525 OS Device Name: /dev/smp/expd0
527 Expander SAS Address(Tier 2): 50800201a5a50233
528 OS Device Name: /dev/smp/expd2
530 Expander SAS Address(Tier 2); 5000c5000d2da812
531 OS Device Name: /dev/smp/expd3
533 Expander SAS Address(Tier 1): 50800201a5a503bf
534 OS Device Name: /dev/smp/expd1
536 Expander SAS Address(Tier 2): 50800201a5a502d2
537 OS Device Name: /dev/smp/expd3
539 Expander SAS Address(Tier 2); 5000c5000d2da823
540 OS Device Name: /dev/smp/expd4
547 \fBExample 9 \fRListing Target Ports Attached to Expanders
550 The following command lists all target ports that are attached to expanders
551 connected to a specified HBA port.
556 # \fBsasinfo expander -t -p /dev/cfg/c1\fR
557 HBA Name: SUNW-pmcs-0
558 HBA Port Name: /dev/cfg/c1
559 Expander SAS Address(Tier 1): 50800201a5a502bf
560 Target Port SAS Address: 50800201a5a504f1
561 Expander SAS Address(Tier 2): 50800201a5a50233
562 Target Port SAS Address: 50800201a5a502be
563 Target Port SAS Address: 5000c5000d2da8b2
564 Expander SAS Address(Tier 2); 5000c5000d2da812
565 Target Port SAS Address: 50800201a5a502be
566 Target Port SAS Address: 50800201a5a508b2
567 Expander SAS Address(Tier 1): 50800201a5a503bf
568 Target Port SAS Address: 50800201a5a50421
569 Expander SAS Address(Tier 2): 50800201a5a502d2
570 Target Port SAS Address: 50800201a5a503be
571 Target Port SAS Address: 5000c5000d2da7be
572 Expander SAS Address(Tier 2); 5000c5000d2da823
573 Target Port SAS Address: 50800201a5a503be
574 Target Port SAS Address: 5000c5000d2da7be
580 \fBExample 10 \fRListing Target Port Information
583 The following command lists all target ports discovered on the host.
588 # \fBsasinfo target-port\fR
589 Target Port SAS Address: 5000c5000bae4009
590 Target Port SAS Address: 5000c5000baef4b1
591 Target Port SAS Address: 5000c5000bae3fe1
592 Target Port SAS Address: 5000c5000bae49d9
593 Target Port SAS Address: 5000c5000bae36c5
599 \fBExample 11 \fRListing Target Port Information with Topology Details
602 The following command lists all target ports with the HBA port and expander
603 that they are connected to.
608 # \fBsasinfo target-port -v\fR
609 Target Port SAS Address: 5000c5000bae4009
611 HBA Port Name: /dev/cfg/c7
612 Expander Device SAS Address: 500e004aaaaaaa3f
613 HBA Port Name: /dev/cfg/c5
614 Expander Device SAS Address: 500e004aaaaaaa3f
615 Target Port SAS Address: 5000c5000baef4b1
617 HBA Port Name: /dev/cfg/c7
618 Expander Device SAS Address: 500e004aaaaaaa3f
619 HBA Port Name: /dev/cfg/c5
620 Expander Device SAS Address: 500e004aaaaaaa3f
621 Target Port SAS Address: 5000c5000bae3fe1
623 HBA Port Name: /dev/cfg/c7
624 Expander Device SAS Address: 500e004aaaaaaa3f
625 HBA Port Name: /dev/cfg/c5
626 Expander Device SAS Address: 500e004aaaaaaa3f
627 Target Port SAS Address: 5000c5000bae49d9
629 HBA Port Name: /dev/cfg/c7
630 Expander Device SAS Address: 500e004aaaaaaa3f
631 HBA Port Name: /dev/cfg/c5
632 Expander Device SAS Address: 500e004aaaaaaa3f
633 Target Port SAS Address: 5000c5000bae36c5
635 HBA Port Name: /dev/cfg/c7
636 Expander Device SAS Address: 500e004aaaaaaa3f
637 HBA Port Name: /dev/cfg/c5
638 Expander Device SAS Address: 500e004aaaaaaa3f
644 \fBExample 12 \fRListing Target Ports with SCSI Information
647 The following command lists all target port details, including SCSI information
648 for each target port.
653 # \fBsasinfo target-port -s 5000c5000bae4009\fR
654 Target Port SAS Address: 5000c5000bae4009
656 HBA Port Name: /dev/cfg/c7
657 Expander Device SAS Address: 500e004aaaaaaa3f
659 OS Device Name : /dev/rdsk/c6t5000C5000BAE400Bd0s2
663 HBA Port Name: /dev/cfg/c5
664 Expander Device SAS Address: 500e004aaaaaaa3f
666 OS Device Name : /dev/rdsk/c6t5000C5000BAE400Bd0s2
675 \fBExample 13 \fRListing the Logical Units
678 The following command lists the logical units on a host.
683 # \fBsasinfo logical-unit\fR
684 OS Device Name: /dev/rdsk/c4t50020F2300B4904Ed0s2
685 OS Device Name: /dev/rdsk/c4t50020F230000B4AFd0s2
691 \fBExample 14 \fRListing Additional Information on Logical Units
694 The following command displays additional logical unit information using the
695 \fB-v\fR option for device \fB/dev/rmt/On\fR.
700 # \fBsasinfo lu -v\fR
701 OS Device Name: /dev/rdsk/c4t50020F2300B4904Ed0s2
702 HBA Port Name: /dev/cfg/c1
703 Target Port SAS Address: 50020f2300b4904e
708 OS Device Name: /dev/rdsk/c4t50020F230000B4AFd0s2
709 HBA Port Name: /dev/cfg/c1
710 Target Port SAS Address: 50020f230063100b
722 See \fBattributes\fR(5) for descriptions of the following attributes:
730 ATTRIBUTE TYPE ATTRIBUTE VALUE
732 Interface Stability Committed