smp_rep_general(8)

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

NAME

6       smp_rep_general - invoke REPORT GENERAL SMP function
7

SYNOPSIS

9       smp_rep_general  [--brief]  [--changecount]  [--help] [--hex] [--inter‐
10       face=PARAMS] [--raw] [--sa=SAS_ADDR] [--verbose]  [--version]  [--zero]
11       SMP_DEVICE[,N]
12

DESCRIPTION

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

OPTIONS

22       Mandatory arguments to long options are mandatory for short options  as
23       well.
24
25       -b, --brief
26              reports  (prints to stdout) only a few important fields from the
27              response.
28
29       -c, --changecount
30              reports (prints to stdout) the  value  of  the  expander  change
31              count  field  from the response. The value is printed in decimal
32              and is in the range 0 to 65535. Only  expanders  compliant  with
33              SAS-1.1  (and earlier) should yield 0. [Expanders compliant with
34              SAS-2 (and later) should set the  "long  response"  bit  in  the
35              REPORT GENERAL response to 1.]
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, --interface=PARAMS
44              interface  specific  parameters. In this case "interface" refers
45              to the path through the operating system to the  SMP  initiator.
46              See the smp_utils man page for more information.
47
48       -r, --raw
49              send  the response (less the CRC field) to stdout in binary. All
50              error messages are sent to stderr.
51
52       -s, --sa=SAS_ADDR
53              specifies the SAS address of the SMP  target  device.  Typically
54              this  is  an  expander.  This  option  may  not be needed if the
55              SMP_DEVICE has the target's SAS address within it. The  SAS_ADDR
56              is  in  decimal but most SAS addresses are shown in hexadecimal.
57              To give a number in hexadecimal either prefix it  with  '0x'  or
58              put a trailing 'h' on it.
59
60       -v, --verbose
61              increase the verbosity of the output. Can be used multiple times
62
63       -V, --version
64              print the version string and then exit.
65
66       -z, --zero
67              zero the Allocated Response Length field in the request. This is
68              required for strict  SAS-1.1  compliance.  However  this  option
69              should  not  be  given  in  SAS-2  and  later; if it is given an
70              abridged response may result.
71

EXAMPLES

73       See "Examples" section in http://sg.danny.cz/sg/smp_utils.html
74

CONFORMING TO

76       The SMP REPORT GENERAL function was introduced  in  SAS-1,  with  small
77       additions  in  SAS-1.1 . There have been a large number of additions in
78       SAS-2 .
79

AUTHORS

81       Written by Douglas Gilbert.
82

REPORTING BUGS

84       Report bugs to <dgilbert at interlog dot com>.
85

COPYRIGHT

87       Copyright © 2006-2011 Douglas Gilbert
88       This software is distributed under a FreeBSD license. There is NO  war‐
89       ranty;  not  even  for MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR‐
90       POSE.
91