Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

smp_conf_general (8)

Name

smp_conf_general - invoke CONFIGURE GENERAL SMP function

Synopsis

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]

Description

SMP_CONF_GENERAL(8)                SMP_UTILS               SMP_CONF_GENERAL(8)



NAME
       smp_conf_general - invoke CONFIGURE GENERAL SMP function

SYNOPSIS
       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]

DESCRIPTION
       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.

OPTIONS
       Mandatory  arguments to long options are mandatory for short options as
       well.

       -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
              specific.

       -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.

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

AUTHORS
       Written by Douglas Gilbert.

REPORTING BUGS
       Report bugs to <dgilbert at interlog dot com>.

COPYRIGHT
       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-
       POSE.


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


       +---------------+--------------------------+
       |ATTRIBUTE TYPE |     ATTRIBUTE VALUE      |
       +---------------+--------------------------+
       |Availability   | system/storage/smp_utils |
       +---------------+--------------------------+
       |Stability      | Uncommitted              |
       +---------------+--------------------------+
SEE ALSO
       smp_utils, smp_rep_general(smp_utils)



NOTES
       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)