smp_conf_general(8)

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

NAME

6       smp_conf_general - invoke CONFIGURE GENERAL SMP function
7

SYNOPSIS

9       smp_conf_general   [--connect=CO]   [--expected=EX]   [--help]  [--hex]
10       [--inactivity=IN]   [--interface=PARAMS]    [--nexus=NE]    [--open=OP]
11       [--power=PD] [--raw] [--reduced=RE] [--sa=SAS_ADDR] [--ssp=CTL] [--ver‐
12       bose] [--version] SMP_DEVICE[,N]
13

DESCRIPTION

15       Sends a SAS Serial Management Protocol (SMP) CONFIGURE GENERAL function
16       request  to  an  SMP  target.  The  SMP  target  is  identified  by the
17       SMP_DEVICE and the  --sa=SAS_ADDR.  Depending  on  the  interface,  the
18       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       -c, --connect=CO
27              sets the "update STP maximum connect time limit"  flag  and  the
28              corresponding "STP maximum connect time limit" field to CO. Unit
29              of CO is 100 microseconds. A CO of zero is taken to mean no max‐
30              imum connection time limit.
31
32       -E, --expected=EX
33              set  the  'expected  expander  change  count'  field  in the SMP
34              request.  The value EX is from 0 to 65535 inclusive with 0 being
35              the  default  value.  When  EX  is greater than zero then if the
36              value doesn't match the expander change count of the SMP  target
37              (i.e.  the  expander)  when  the request arrives then the target
38              ignores the request and  sets  a  function  result  of  "invalid
39              expander change count" in the response.
40
41       -h, --help
42              output the usage message then exit.
43
44       -H, --hex
45              output the response (less the CRC field) in hexadecimal.
46
47       -i, --inactivity=IN
48              sets  the  "update  STP  bus inactivity time limit" flag and the
49              corresponding "STP bus inactivity time limit" field to IN.  Unit
50              of  IN is 100 microseconds. A IN of zero is taken to mean no bus
51              inactivity time limit.
52
53       -I, --interface=PARAMS
54              interface specific parameters. In this case  "interface"  refers
55              to  the  path through the operating system to the SMP initiator.
56              See the smp_utils man page for more information.
57
58       -n, --nexus=NE
59              sets the "update STP SMP I_T nexus loss time" flag and the  cor‐
60              responding "STP SMP I_T nexus loss time" field to NE. Unit of NE
61              is one millisecond. A NE of zero is taken to mean a vendor  spe‐
62              cific  amount  of time; a NE of 65535 means the port shall never
63              recognize an I_T nexus loss.
64
65       -o, --open=OP
66              sets the "update STP reject to open limit" flag and  the  corre‐
67              sponding  "STP  reject to open limit" field to OP. Unit of OP is
68              10 microseconds.
69
70       -p, --power=PD
71              sets the "update power done timeout" flag and the  corresponding
72              "power  doen  timeout" field to PD. Unit of PD is 1 second. A PD
73              value of 0 is interpreted as don't change the current value. The
74              maximum  value  of  PD is 255 and means the time limit is vendor
75              specific.
76
77       -r, --raw
78              send the response (less the CRC field) to stdout in binary.  All
79              error messages are sent to stderr.
80
81       -R, --reduced=RE
82              sets the "update Initial time to reduced functionality" flag and
83              the corresponding "Initial time to reduced functionality"  field
84              to RE.  Unit of RE is 100 milliseconds. The maximum permitted RE
85              value is 255 which corresponds to 25.5 seconds.
86
87       -s, --sa=SAS_ADDR
88              specifies the SAS address of the SMP  target  device.  Typically
89              this  is  an  expander.  This  option  may  not be needed if the
90              SMP_DEVICE has the target's SAS address within it. The  SAS_ADDR
91              is  in  decimal but most SAS addresses are shown in hexadecimal.
92              To give a number in hexadecimal either prefix it  with  '0x'  or
93              put a trailing 'h' on it.
94
95       -S, --ssp=CTL
96              sets the "update SSP time limit" flag and the corresponding "SSP
97              maximum connect time limit" field to CTL. Unit  of  CTL  is  100
98              microseconds.   A  CTL  of zero is taken to meanthat there is no
99              SSP connect time limit.
100
101       -v, --verbose
102              increase the verbosity of the output. Can be used multiple times
103
104       -V, --version
105              print the version string and then exit.
106

CONFORMING TO

108       The SMP CONFIGURE GENERAL function was introduced in SAS-2 .
109

AUTHORS

111       Written by Douglas Gilbert.
112

REPORTING BUGS

114       Report bugs to <dgilbert at interlog dot com>.
115

COPYRIGHT

117       Copyright © 2006-2015 Douglas Gilbert
118       This software is distributed under a FreeBSD license. There is NO  war‐
119       ranty;  not  even  for MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR‐
120       POSE.
121