smp_rep_exp_route_tbl(8)

1SMP_REP_EXP_ROUTE_TBL(8)           SMP_UTILS          SMP_REP_EXP_ROUTE_TBL(8)
2
3
4

NAME

6       smp_rep_exp_route_tbl  -  invoke  REPORT  EXPANDER ROUTE TABLE LIST SMP
7       function
8

SYNOPSIS

10       smp_rep_exp_route_tbl [--brief] [--help] [--hex] [--index=IN] [--inter‐
11       face=PARAMS] [--num=NUM] [--phy=ID] [--raw] [--sa=SAS_ADDR] [--verbose]
12       [--version] SMP_DEVICE[,N]
13

DESCRIPTION

15       Sends a SAS Serial Management Protocol (SMP) REPORT EXPANDER ROUTE  TA‐
16       BLE  LIST  function request to an SMP target and decodes or outputs the
17       response. The SMP target  is  identified  by  the  SMP_DEVICE  and  the
18       SAS_ADDR.  Depending on the interface, the SAS_ADDR may be deduced from
19       the SMP_DEVICE. The mpt interface uses SMP_DEVICE to identify a HBA (an
20       SMP  initiator)  and  needs  the additional ,N to differentiate between
21       HBAs if there are multiple present.
22
23       There are two expander route table types: phy-based and expander-based.
24       The  expander-based  route table was introduced in SAS-2 and supersedes
25       the phy-based route tables. The REPORT EXPANDER ROUTE TABLE LIST  func‐
26       tion is associated with an expander-based route table. There is no cor‐
27       responding CONFIGURE function because a expander-based route  table  is
28       self-configured.
29

OPTIONS

31       Mandatory  arguments to long options are mandatory for short options as
32       well.
33
34       -b, --brief
35              reduce the decoded response output.
36
37       -h, --help
38              output the usage message then exit.
39
40       -H, --hex
41              output the response (less the CRC field) in hexadecimal.
42
43       -i, --index=IN
44              IN is the starting routed SAS address index. The  default  value
45              is 0.
46
47       -I, --interface=PARAMS
48              interface  specific  parameters. In this case "interface" refers
49              to the path through the operating system to the  SMP  initiator.
50              See the smp_utils man page for more information.
51
52       -n, --num=NUM
53              maximum  number  of  descriptors  to fetch (default is 62). Note
54              that maximum SMP frame size is 1028 bytes (including a  trailing
55              4 byte CRC) so 62 descriptors is the maximum number that can fit
56              in one response.
57
58       -p, --phy=ID
59              starting phy identifier within bitmap. ID should  be  one  of  0
60              (the default), or a multiple of 48. Note there is only one expn‐
61              der route table per expander, not one per phy.
62
63       -r, --raw
64              send the response (less the CRC field) to stdout in binary.  All
65              error messages are sent to stderr.
66
67       -s, --sa=SAS_ADDR
68              specifies  the  SAS  address of the SMP target device. Typically
69              this is an expander. This  option  may  not  be  needed  if  the
70              SMP_DEVICE  has the target's SAS address within it. The SAS_ADDR
71              is in decimal but most SAS addresses are shown  in  hexadecimal.
72              To  give  a  number in hexadecimal either prefix it with '0x' or
73              put a trailing 'h' on it.
74
75       -v, --verbose
76              increase the verbosity of the output. Can be used multiple times
77
78       -V, --version
79              print the version string and then exit.
80

CONFORMING TO

82       The SMP REPORT EXPANDER ROUTE TABLE LIST  function  was  introduced  in
83       SAS-2 .
84

AUTHORS

86       Written by Douglas Gilbert.
87

REPORTING BUGS

89       Report bugs to <dgilbert at interlog dot com>.
90

COPYRIGHT

92       Copyright © 2007-2011 Douglas Gilbert
93       This  software is distributed under a FreeBSD license. There is NO war‐
94       ranty; not even for MERCHANTABILITY or FITNESS FOR  A  PARTICULAR  PUR‐
95       POSE.
96