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]     [--raw]
11       [--sa=SAS_ADDR] [--verbose] [--version] SMP_DEVICE[,N]
12

DESCRIPTION

14       Sends  a  SAS Management Protocol (SMP) CONFIGURE GENERAL request func‐
15       tion to a SMP target. The SMP target is identified  by  the  SMP_DEVICE
16       and  the --sa=SAS_ADDR. Depending on the interface, the SAS_ADDR may be
17       deduced  from  the  SMP_DEVICE.   With  one  interface  there  is   one
18       SMP_DEVICE  per machine so the SMP_DEVICE,N syntax is needed to differ‐
19       entiate 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       -c, --connect=CO
26              sets  the  "update  STP maximum connect time limit" flag and the
27              corresponding "STP maximum connect time limit" field to CO. Unit
28              of CO is 100 microseconds. A CO of zero is taken to mean no max‐
29              imum connection time limit.
30
31       -E, --expected=EX
32              set the 'expected  expander  change  count'  field  in  the  SMP
33              request.  The value EX is from 0 to 65535 inclusive with 0 being
34              the default value. When EX is greater  than  zero  then  if  the
35              value  doesn't match the expander change count of the SMP target
36              (i.e. the expander) when the request  arrives  then  the  target
37              ignores  the  request  and  sets  a  function result of "invalid
38              expander change count" in the response.
39
40       -h, --help
41              output the usage message then exit.
42
43       -H, --hex
44              output the response in hexadecimal.
45
46       -i, --inactivity=IN
47              sets the "update STP bus inactivity time  limit"  flag  and  the
48              corresponding  "STP bus inactivity time limit" field to IN. Unit
49              of IN is 100 microseconds. A IN of zero is taken to mean no  bus
50              inactivity time limit.
51
52       -I, --interface=PARAMS
53              interface  specific  parameters. In this case "interface" refers
54              to the path through the operating system to the  SMP  initiator.
55              See the smp_utils man page for more information.
56
57       -n, --nexus=NE
58              sets  the "update STP SMP I_T nexus loss time" flag and the cor‐
59              responding "STP SMP I_T nexus loss time" field to NE. Unit of NE
60              is  one millisecond. A NE of zero is taken to mean a vendor spe‐
61              cific amount of time; a NE of 65535 means the port  shall  never
62              recognize an I_T nexus loss.
63
64       -r, --raw
65              send  the  response  to stdout in binary. All error messages are
66              sent to stderr.
67
68       -s, --sa=SAS_ADDR
69              specifies the SAS address of the SMP  target  device.  Typically
70              this  is  an  expander.  This  option  may  not be needed if the
71              SMP_DEVICE has the target's SAS address within it. The  SAS_ADDR
72              is  in  decimal but most SAS addresses are shown in hexadecimal.
73              To give a number in hexadecimal either prefix it  with  '0x'  or
74              put a trailing 'h' on it.
75
76       -v, --verbose
77              increase the verbosity of the output. Can be used multiple times
78
79       -V, --version
80              print the version string and then exit.
81

CONFORMING TO

83       The SMP CONFIGURE GENERAL function was introduced in 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 © 2006-2008 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