1SAS_DISCOVER(1)                    sasutils                    SAS_DISCOVER(1)
2
3
4

NAME

6       sas_discover - display Serial Attached SCSI (SAS) topology
7

SYNOPSIS

9       sas_discover [-h] [--verbose] [--addr] [--devices] [--counters]
10

DESCRIPTION

12       sas_discover  displays  the  SAS  topology  from the host initiator(s),
13       through any SAS expanders up to the SAS targets. Each link usually rep‐
14       resents  a  SAS port connection, whether it uses one or more PHYs.  The
15       number of PHYs per port is explicitly shown if greater  than  one  (eg.
16       "--4x--" for a 4-PHY wide port).  Please note that by default, sas_dis‐
17       cover tries to fold common devices (like disks), like  in  the  example
18       below:
19
20       -- 60 x end_device -- disk
21              60  x  1-PHY links, each connected to a SAS end_device target of
22              SCSI type disk
23
24       Host initiators, expanders and end devices are labelled with  the  same
25       name  used  in  sysfs.  If -v is provided, more descriptive information
26       will be displayed, but the topology will stay folded whenever possible.
27       sas_discover -v will also print SES-2 subenclosure nicknames, which are
28       useful to identify JBODs/SIMs and external SAS  switches  connected  to
29       the topology.
30
31       Use -vv to unfold the topology and display more information (eg. model,
32       size, bay identifier in enclosure).
33
34       Use -vvv to display additional low-level information for each  SAS  end
35       device.
36
37       Add --addr to also display the SAS address for each SAS component found
38       in the topology.
39

OPTIONS

41       optional arguments:
42
43              -h, --help
44                     show this help message and exit
45
46              --verbose, -v
47                     Verbosity level, repeat multiple times!
48
49              --addr Print SAS addresses
50
51              --devices
52                     Print associated devices
53
54              --counters
55                     Print I/O counters
56

EXIT STATUS

58       An exit status of zero indicates success of the  command,  and  failure
59       otherwise.
60

SEE ALSO

62       sas_counters(1), sas_devices(1), ses_report(1)
63

BUG REPORTS

65       Use the following URL to submit a bug report or feedback:
66          https://github.com/stanford-rc/sasutils/issues
67

AUTHOR

69       Stephane Thiell <sthiell@stanford.edu>
70
72       Apache License Version 2.0
73
74
75
76
770.5.0                             2023-10-01                   SAS_DISCOVER(1)
Impressum