Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Wednesday, February 9, 2022

smp_conf_general (8)


smp_conf_general - invoke CONFIGURE GENERAL SMP function


smp_conf_general   [--connect=CO]   [--expected=EX]   [--help]  [--hex]
[--inactivity=IN]   [--interface=PARAMS]    [--nexus=NE]    [--open=OP]
[--power=PD] [--raw] [--reduced=RE] [--sa=SAS_ADDR] [--verbose] [--ver-
sion] SMP_DEVICE[,N]


SMP_CONF_GENERAL(8)                SMP_UTILS               SMP_CONF_GENERAL(8)

       smp_conf_general - invoke CONFIGURE GENERAL SMP function

       smp_conf_general   [--connect=CO]   [--expected=EX]   [--help]  [--hex]
       [--inactivity=IN]   [--interface=PARAMS]    [--nexus=NE]    [--open=OP]
       [--power=PD] [--raw] [--reduced=RE] [--sa=SAS_ADDR] [--verbose] [--ver-
       sion] SMP_DEVICE[,N]

       Sends a SAS Serial Management Protocol (SMP) CONFIGURE GENERAL function
       request  to  an  SMP  target.  The  SMP  target  is  identified  by the
       SMP_DEVICE and the  --sa=SAS_ADDR.  Depending  on  the  interface,  the
       SAS_ADDR  may  be  deduced from the SMP_DEVICE.  The mpt interface uses
       SMP_DEVICE to identify a HBA (an SMP initiator)  and  needs  the  addi-
       tional ,N to differentiate between HBAs if there are multiple present.

       Mandatory  arguments to long options are mandatory for short options as

       -c, --connect=CO
              sets the "update STP maximum connect time limit"  flag  and  the
              corresponding "STP maximum connect time limit" field to CO. Unit
              of CO is 100 microseconds. A CO of zero is taken to mean no max-
              imum connection time limit.

       -E, --expected=EX
              set  the  'expected  expander  change  count'  field  in the SMP
              request.  The value EX is from 0 to 65535 inclusive with 0 being
              the  default  value.  When  EX  is greater than zero then if the
              value doesn't match the expander change count of the SMP  target
              (i.e.  the  expander)  when  the request arrives then the target
              ignores the request and  sets  a  function  result  of  "invalid
              expander change count" in the response.

       -h, --help
              output the usage message then exit.

       -H, --hex
              output the response (less the CRC field) in hexadecimal.

       -i, --inactivity=IN
              sets  the  "update  STP  bus inactivity time limit" flag and the
              corresponding "STP bus inactivity time limit" field to IN.  Unit
              of  IN is 100 microseconds. A IN of zero is taken to mean no bus
              inactivity time limit.

       -I, --interface=PARAMS
              interface specific parameters. In this case  "interface"  refers
              to  the  path through the operating system to the SMP initiator.
              See the smp_utils man page for more information.

       -n, --nexus=NE
              sets the "update STP SMP I_T nexus loss time" flag and the  cor-
              responding "STP SMP I_T nexus loss time" field to NE. Unit of NE
              is one millisecond. A NE of zero is taken to mean a vendor  spe-
              cific  amount  of time; a NE of 65535 means the port shall never
              recognize an I_T nexus loss.

       -o, --open=OP
              sets the "update STP reject to open limit" flag and  the  corre-
              sponding  "STP  reject to open limit" field to OP. Unit of OP is
              10 microseconds.

       -p, --power=PD
              sets the "update power done timeout" flag and the  corresponding
              "power  doen  timeout" field to PD. Unit of PD is 1 second. A PD
              value of 0 is interpreted as don't change the current value. The
              maximum  value  of  PD is 255 and means the time limit is vendor

       -r, --raw
              send the response (less the CRC field) to stdout in binary.  All
              error messages are sent to stderr.

       -R, --reduced=RE
              sets the "update Initial time to reduced functionality" flag and
              the corresponding "Initial time to reduced functionality"  field
              to RE.  Unit of RE is 100 milliseconds. The maximum permitted RE
              value is 255 which corresponds to 25.5 seconds.

       -s, --sa=SAS_ADDR
              specifies the SAS address of the SMP  target  device.  Typically
              this  is  an  expander.  This  option  may  not be needed if the
              SMP_DEVICE has the target's SAS address within it. The  SAS_ADDR
              is  in  decimal but most SAS addresses are shown in hexadecimal.
              To give a number in hexadecimal either prefix it  with  '0x'  or
              put a trailing 'h' on it.

       -v, --verbose
              increase the verbosity of the output. Can be used multiple times

       -V, --version
              print the version string and then exit.

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

       Written by Douglas Gilbert.

       Report bugs to <dgilbert at interlog dot com>.

       Copyright (C) 2006-2011 Douglas Gilbert
       This  software is distributed under a FreeBSD license. There is NO war-
       ranty; not even for MERCHANTABILITY or FITNESS FOR  A  PARTICULAR  PUR-

       See attributes(7) for descriptions of the following attributes:

       |Availability   | system/storage/smp_utils |
       |Stability      | Uncommitted              |

       smp_utils, smp_rep_general(smp_utils)

       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source was downloaded from  http://sg.danny.cz/sg/p/smp_utils-0.98.tgz.

       Further information about this software can be found on the open source
       community website at http://sg.danny.cz/sg/smp_utils.html.

smp_utils-0.96                     June 2011               SMP_CONF_GENERAL(8)