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 "April 9, 2016"
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]
47 The \fBsasinfo\fR utility is a command line interface that collects
48 administrative information on Serial Attached SCSI-2 (SAS-2) host bus adapter
49 (HBA) that supports the Storage Management HBA API (SM-HBA). The utility
50 reports attributes of HBA ports and of expander devices and SCSI target devices
51 that might be connected to those HBA ports.
54 \fBsasinfo\fR is implemented as a set of subcommands, described below.
57 The following subcommands are supported by \fBsasinfo\fR.
65 Lists information for the HBA referenced by the specified \fIHBA_name\fR. If
66 \fIHBA_name\fR is not specified, all HBAs on the host will be listed.
76 Lists information for the HBA port referenced by the specified
77 \fIHBA_port_Name\fR. If \fIHBA_port_Name\fR is not specified, all HBA ports on
78 the host will be listed. Note that HBA ports can be dynamically
79 configured/unconfigured so that the number of HBA ports on an HBA can change as
80 connections to target devices are established. With no connections to a storage
81 device, no HBA port is configured.
91 Lists hierarchical view of the expander referenced by the specified
92 \fIExpander_SAS_Addr\fR. If no argument is specified, all expanders that are
93 visible across all HBA ports on the host will be listed.
99 \fB\fBtarget-port\fR\fR
103 Lists information for those target ports referenced by
104 \fITarget_port_SAS_Addr\fR address. If no argument is specified, all target
105 ports that are visible on the host will be listed.
111 \fB\fBlogical-unit\fR | \fBlu\fR\fR
115 Lists the logical unit referenced by the specified \fIdevice_path\fR. If
116 \fIdevice_path\fR is not specified, all SAS logical units will be listed,
117 including the SAS Management Protocol (SMP) target port.
122 The following options are supported.
126 \fB\fB-?\fR, \fB--help\fR\fR
130 Displays usage information
136 \fB\fB-a\fR, \fB--hba\fR \fIHBA_Name\fR\fR
140 Retrieve HBA port information from the \fIHBA_Name\fR of an HBA on the host.
141 The \fB-a\fR option can only be used with the \fBhba-port\fR subcommand.
147 \fB\fB-l\fR, \fB--phy-linkstat\fR\fR
151 Lists the link error statistics information for the \fBphy\fRs on the HBA port
152 referenced by the specified \fIHBA_port_Name\fR or all HBA ports if no HBA port
153 is specified. This option is used only with the \fBhba-port\fR subcommand.
159 \fB\fB-p\fR \fIHBA_port_SAS_Addr\fR, \fB--port\fR \fIHBA_port_SAS_Addr\fR\fR
163 Retrieve remote port information from the \fIHBA_port_SAS_Addr\fR of the local
164 HBA port on the host. The \fB-p\fR option can be used only with the
165 \fBexpander\fR subcommand.
171 \fB\fB-s\fR, \fB--scsi\fR\fR
175 Lists SCSI attributes for target ports that are requested for display. This
176 option is only used for the \fBtarget-port\fR subcommand.
182 \fB\fB-v\fR, \fB--verbose\fR\fR
186 Display details on hardware information, such as SAS address, topology device,
187 and so forth, based on which subcommand is invoked.
193 \fB\fB-V\fR, \fB--version\fR\fR
197 Displays the version information.
203 \fB\fB-y\fR, \fB--phy\fR\fR
207 Lists the \fBphy\fR information on the HBA port specified by
208 \fIHBA_port_Name\fR or all HBA ports if no HBA port is specified. This option
209 is used only with the \fBhba-port\fR subcommand.
214 \fBExample 1 \fRListing All HBAs
217 The following command lists all HBAs on the host.
223 HBA Name: SUNW-pmcs-0
224 HBA Name: SUNW-pmcs-1
230 \fBExample 2 \fRListing All HBAs with Details
233 The following command lists all HBAs on the host, along with related details.
234 Note that each HBA has two HBA ports configured, with each HBA port connected
240 # \fBsasinfo hba -v\fR
241 HBA Name: SUNW-pmcs-0
244 Firmware Version: 1.1
245 FCode/BIOS Version: 1.1
246 Serial Number: 111-11111
249 Number of HBA Ports: 2
250 HBA Name: SUNW-pmcs-1
253 Firmware Version: 1.1
254 FCode/BIOS Version: 1.1
255 Serial Number: 111-11111
258 Number of HBA Ports: 2
264 \fBExample 3 \fRListing All HBA Ports
267 The following command lists all HBA ports on the host.
272 # \fBsasinfo hba-port\fR
273 HBA Name: SUNW-pmcs-0
274 HBA Port Name: /dev/cfg/c1
275 HBA Port Name: /dev/cfg/c2
276 HBA Name: SUNW-pmcs-1
277 HBA Port Name: /dev/cfg/c3
278 HBA Port Name: /dev/cfg/c4
284 \fBExample 4 \fRListing all HBA Ports with Details
287 The following command lists all HBA ports, with accompanying details.
292 # \fBsasinfo hba-port -v\fR
293 HBA Name: SUNW-pmcs-0
294 HBA Port Name: /dev/cfg/c1
297 Local SAS Address: 5000c50000d756aa
298 Attached Port SAS Address: 50800201a5a502bf
300 HBA Port Name: /dev/cfg/c25000c50000d756cc
303 Local SAS Address: 5000c50000d756aa
304 Attached Port SAS Address: 50800201a5a503bf
306 HBA Name: SUNW-pmcs-1
307 HBA Port Name: /dev/cfg/c3
310 Local SAS Address: 5000c50000d756cc
311 Attached Port SAS Address: 50800201a5a504bf
313 HBA Port Name: /dev/cfg/c4
316 Local SAS Address: 5000c50000d756cc
317 Attached Port SAS Address: 50800201a5a505bf
324 \fBExample 5 \fRListing \fBphy\fR Information for All HBA Ports
327 The following command lists \fBphy\fR information for all HBA ports.
332 # \fBsasinfo hba-port -y\fR
333 HBA Name: SUNW-pmcs-0
334 HBA Port Name: /dev/cfg/c1
338 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
339 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
340 NegotiatedLinkRate: 3Gbit
343 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
344 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
345 NegotiatedLinkRate: 3Gbit
348 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
349 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
350 NegotiatedLinkRate: 3Gbit
353 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
354 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
355 NegotiatedLinkRate: 3Gbit
356 HBA Port Name: /dev/cfg/c2
360 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
361 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
362 NegotiatedLinkRate: 3Gbit
365 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
366 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
367 NegotiatedLinkRate: 3Gbit
370 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
371 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
372 NegotiatedLinkRate: 3Gbit
375 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
376 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
377 NegotiatedLinkRate: 3Gbit
378 HBA Name: SUNW-pmcs-1
379 HBA Port Name: /dev/cfg/c3
383 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
384 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
385 NegotiatedLinkRate: 3Gbit
388 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
389 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
390 NegotiatedLinkRate: 3Gbit
393 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
394 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
395 NegotiatedLinkRate: 3Gbit
398 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
399 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
400 NegotiatedLinkRate: 3Gbit
401 HBA Port Name: /dev/cfg/c4
405 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
406 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
407 NegotiatedLinkRate: 3Gbit
410 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
411 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
412 NegotiatedLinkRate: 3Gbit
415 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
416 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
417 NegotiatedLinkRate: 3Gbit
420 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
421 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
422 NegotiatedLinkRate: 3Gbit
428 \fBExample 6 \fRListing \fBphy\fR Link Error Statistics for a Specific HBA Port
431 The following command lists \fBphy\fR link error statistics for a particular
437 # \fBsasinfo hba-port -ly /dev/cfg/c1\fR
438 HBA Name: SUNW-pmcs-0
439 HBA Port Name: /dev/cfg/c1
443 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
444 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
445 NegotiatedLinkRate: 3Gbit
446 Link Error Statistics:
448 Running Disparity Error: 0
449 Loss of Dword Sync: 0
453 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
454 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
455 NegotiatedLinkRate: 3Gbit
456 Link Error Statistics:
458 Running Disparity Error: 0
459 Loss of Dword Sync: 0
463 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
464 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
465 NegotiatedLinkRate: 3Gbit
466 Link Error Statistics:
468 Running Disparity Error: 0
469 Loss of Dword Sync: 0
473 HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
474 ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
475 NegotiatedLinkRate: 3Gbit
476 Link Error Statistics:
478 Running Disparity Error: 0
479 Loss of Dword Sync: 0
486 \fBExample 7 \fRListing Expanders Connected to an HBA Port
489 The following command lists all expanders that are visible through the
495 # \fBsasinfo expander -p /dev/cfg/c1\fR
496 HBA Name: SUNW-pmcs-0
497 HBA Port Name: /dev/cfg/c1
498 Expander SAS Address(Tier 1): 50800201a5a502bf
499 Expander SAS Address(Tier 2): 50800201a5a50233
500 Expander SAS Address(Tier 2); 5000c5000d2da812
501 Expander SAS Address(Tier 1): 50800201a5a503bf
502 Expander SAS Address(Tier 2): 50800201a5a502d2
503 Expander SAS Address(Tier 2); 5000c5000d2da823
509 \fBExample 8 \fRListing Detailed Information on Expanders
512 The following command lists detailed information on all expanders that are
513 visible through the specified HBA port.
518 # \fBsasinfo expander -v -p /dev/cfg/c1\fR
519 HBA Name: SUNW-pmcs-0
520 HBA Port Name: /dev/cfg/c1
521 Expander SAS Address(Tier 1): 50800201a5a502bf
522 OS Device Name: /dev/smp/expd0
524 Expander SAS Address(Tier 2): 50800201a5a50233
525 OS Device Name: /dev/smp/expd2
527 Expander SAS Address(Tier 2); 5000c5000d2da812
528 OS Device Name: /dev/smp/expd3
530 Expander SAS Address(Tier 1): 50800201a5a503bf
531 OS Device Name: /dev/smp/expd1
533 Expander SAS Address(Tier 2): 50800201a5a502d2
534 OS Device Name: /dev/smp/expd3
536 Expander SAS Address(Tier 2); 5000c5000d2da823
537 OS Device Name: /dev/smp/expd4
544 \fBExample 9 \fRListing Target Ports Attached to Expanders
547 The following command lists all target ports that are attached to expanders
548 connected to a specified HBA port.
553 # \fBsasinfo expander -t -p /dev/cfg/c1\fR
554 HBA Name: SUNW-pmcs-0
555 HBA Port Name: /dev/cfg/c1
556 Expander SAS Address(Tier 1): 50800201a5a502bf
557 Target Port SAS Address: 50800201a5a504f1
558 Expander SAS Address(Tier 2): 50800201a5a50233
559 Target Port SAS Address: 50800201a5a502be
560 Target Port SAS Address: 5000c5000d2da8b2
561 Expander SAS Address(Tier 2); 5000c5000d2da812
562 Target Port SAS Address: 50800201a5a502be
563 Target Port SAS Address: 50800201a5a508b2
564 Expander SAS Address(Tier 1): 50800201a5a503bf
565 Target Port SAS Address: 50800201a5a50421
566 Expander SAS Address(Tier 2): 50800201a5a502d2
567 Target Port SAS Address: 50800201a5a503be
568 Target Port SAS Address: 5000c5000d2da7be
569 Expander SAS Address(Tier 2); 5000c5000d2da823
570 Target Port SAS Address: 50800201a5a503be
571 Target Port SAS Address: 5000c5000d2da7be
577 \fBExample 10 \fRListing Target Port Information
580 The following command lists all target ports discovered on the host.
585 # \fBsasinfo target-port\fR
586 Target Port SAS Address: 5000c5000bae4009
587 Target Port SAS Address: 5000c5000baef4b1
588 Target Port SAS Address: 5000c5000bae3fe1
589 Target Port SAS Address: 5000c5000bae49d9
590 Target Port SAS Address: 5000c5000bae36c5
596 \fBExample 11 \fRListing Target Port Information with Topology Details
599 The following command lists all target ports with the HBA port and expander
600 that they are connected to.
605 # \fBsasinfo target-port -v\fR
606 Target Port SAS Address: 5000c5000bae4009
608 HBA Port Name: /dev/cfg/c7
609 Expander Device SAS Address: 500e004aaaaaaa3f
610 HBA Port Name: /dev/cfg/c5
611 Expander Device SAS Address: 500e004aaaaaaa3f
612 Target Port SAS Address: 5000c5000baef4b1
614 HBA Port Name: /dev/cfg/c7
615 Expander Device SAS Address: 500e004aaaaaaa3f
616 HBA Port Name: /dev/cfg/c5
617 Expander Device SAS Address: 500e004aaaaaaa3f
618 Target Port SAS Address: 5000c5000bae3fe1
620 HBA Port Name: /dev/cfg/c7
621 Expander Device SAS Address: 500e004aaaaaaa3f
622 HBA Port Name: /dev/cfg/c5
623 Expander Device SAS Address: 500e004aaaaaaa3f
624 Target Port SAS Address: 5000c5000bae49d9
626 HBA Port Name: /dev/cfg/c7
627 Expander Device SAS Address: 500e004aaaaaaa3f
628 HBA Port Name: /dev/cfg/c5
629 Expander Device SAS Address: 500e004aaaaaaa3f
630 Target Port SAS Address: 5000c5000bae36c5
632 HBA Port Name: /dev/cfg/c7
633 Expander Device SAS Address: 500e004aaaaaaa3f
634 HBA Port Name: /dev/cfg/c5
635 Expander Device SAS Address: 500e004aaaaaaa3f
641 \fBExample 12 \fRListing Target Ports with SCSI Information
644 The following command lists all target port details, including SCSI information
645 for each target port.
650 # \fBsasinfo target-port -s 5000c5000bae4009\fR
651 Target Port SAS Address: 5000c5000bae4009
653 HBA Port Name: /dev/cfg/c7
654 Expander Device SAS Address: 500e004aaaaaaa3f
656 OS Device Name : /dev/rdsk/c6t5000C5000BAE400Bd0s2
660 HBA Port Name: /dev/cfg/c5
661 Expander Device SAS Address: 500e004aaaaaaa3f
663 OS Device Name : /dev/rdsk/c6t5000C5000BAE400Bd0s2
672 \fBExample 13 \fRListing the Logical Units
675 The following command lists the logical units on a host.
680 # \fBsasinfo logical-unit\fR
681 OS Device Name: /dev/rdsk/c4t50020F2300B4904Ed0s2
682 OS Device Name: /dev/rdsk/c4t50020F230000B4AFd0s2
688 \fBExample 14 \fRListing Additional Information on Logical Units
691 The following command displays additional logical unit information using the
692 \fB-v\fR option for device \fB/dev/rmt/On\fR.
697 # \fBsasinfo lu -v\fR
698 OS Device Name: /dev/rdsk/c4t50020F2300B4904Ed0s2
699 HBA Port Name: /dev/cfg/c1
700 Target Port SAS Address: 50020f2300b4904e
705 OS Device Name: /dev/rdsk/c4t50020F230000B4AFd0s2
706 HBA Port Name: /dev/cfg/c1
707 Target Port SAS Address: 50020f230063100b
718 See \fBattributes\fR(5) for descriptions of the following attributes:
726 ATTRIBUTE TYPE ATTRIBUTE VALUE
728 Interface Stability Committed