smp_rep_self_conf_stat(8)

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

NAME

6       smp_rep_self_conf_stat  -  invoke  REPORT SELF-CONFIGURATION STATUS SMP
7       function
8

SYNOPSIS

10       smp_rep_self_conf_stat   [--brief]   [--help]   [--hex]   [--index=SDI]
11       [--interface=PARAMS]  [--last]  [--one] [--raw] [--sa=SAS_ADDR] [--ver‐
12       bose] [--version] SMP_DEVICE[,N]
13

DESCRIPTION

15       Sends a SAS Serial Management Protocol (SMP) REPORT  SELF-CONFIGURATION
16       STATUS  function request to an SMP target. The SMP target is identified
17       by the SMP_DEVICE and the --sa=SAS_ADDR. Depending  on  the  interface,
18       the SAS_ADDR may be deduced from the SMP_DEVICE. The mpt interface uses
19       SMP_DEVICE to identify a HBA (an SMP initiator)  and  needs  the  addi‐
20       tional ,N to differentiate between HBAs if there are multiple present.
21

OPTIONS

23       Mandatory  arguments to long options are mandatory for short options as
24       well.
25
26       -b, --brief
27              lessen the amount of header information output and compress each
28              self confuration status descriptor to one line of output.
29
30       -h, --help
31              output the usage message then exit.
32
33       -H, --hex
34              output the response (less the CRC field) in hexadecimal.
35
36       -i, --index=SDI
37              SDI  is the starting self-configuration status descriptor index,
38              an integer in the range 0 to 65535. The default value is 1 .  If
39              SDI is 0 then no descriptors are placed in the response plus the
40              "starting self-configuration status descriptor index" and "total
41              number  of  self-configuration status descriptors" fields in the
42              response are both set to 0. That makes setting SDI to  0  a  lot
43              less useful tha it could have been. SDI may be decimal (default)
44              or hexadecimal prefixed by '0x' (or '0X') or with a 'h' (or 'H')
45              suffix.
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       -l, --last
53              Sends a REPORT SELF-CONFIGURATION STATUS request to find out the
54              contents  of  the  "last  self-configuration  status  descriptor
55              index"  field  in the response. If it is different from SDI then
56              it re-issues that request with the "starting  self-configuration
57              status  descriptor  index"  field set to the "last" value. Often
58              only the last (i.e.  most  recent)  recorded  descriptor  is  of
59              interest  and  that  is  what  this option should show. In cases
60              there may be more than  one  descriptor  starting  at  the  last
61              index.
62
63       -o, --one
64              If  multiple  self-configuration  status  descriptors are found,
65              then only output the first one.
66
67       -r, --raw
68              send the response (less the CRC field) to stdout in binary.  All
69              error messages are sent to stderr.
70
71       -s, --sa=SAS_ADDR
72              specifies  the  SAS  address  of  the SMP target device. The mpt
73              interface  needs  this  option  and  it  will  typically  be  an
74              expander's  SAS address. The SAS_ADDR is in decimal but most SAS
75              addresses are shown in hexadecimal.  To give a number  in  hexa‐
76              decimal either prefix it with '0x' or put a trailing 'h' on it.
77
78       -v, --verbose
79              increase  the  verbosity  of  the  output.  Can be used multiple
80              times.
81
82       -V, --version
83              print the version string and then exit.
84

NOTES

86       The "last self-configuration status  descriptor  index"  field  in  the
87       response  may indicate the lowest index of the last recorded (i.e. most
88       recent) "clump" of status descriptors placed in the expander's storage.
89
90       This utility  flags  the  "last  self-configuration  status  descriptor
91       index" descriptor in its output with a ">>>" indication. For brief out‐
92       put the descriptor line starts with ">>>" while for normal output (i.e.
93       when --brief not given) the index has ">>>" placed in front of it.
94

CONFORMING TO

96       The  SMP  REPORT  SELF-CONFIGURATION  STATUS function was introduced in
97       SAS-2 .
98

AUTHORS

100       Written by Douglas Gilbert.
101

REPORTING BUGS

103       Report bugs to <dgilbert at interlog dot com>.
104

COPYRIGHT

106       Copyright © 2011 Douglas Gilbert
107       This software is distributed under a FreeBSD license. There is NO  war‐
108       ranty;  not  even  for MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR‐
109       POSE.
110