Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

smp_rep_general (8)

Name

smp_rep_general - invoke REPORT GENERAL SMP function

Synopsis

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

Description

SMP_REP_GENERAL(8)                 SMP_UTILS                SMP_REP_GENERAL(8)



NAME
       smp_rep_general - invoke REPORT GENERAL SMP function

SYNOPSIS
       smp_rep_general  [--brief]  [--changecount]  [--help] [--hex] [--inter-
       face=PARAMS] [--raw] [--sa=SAS_ADDR] [--verbose]  [--version]  [--zero]
       SMP_DEVICE[,N]

DESCRIPTION
       Sends  a  SAS  Serial Management Protocol (SMP) REPORT GENERAL function
       request to  an  SMP  target.  The  SMP  target  is  identified  by  the
       SMP_DEVICE  and  the 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 additional ,N to
       differentiate between HBAs if there are multiple present.

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

       -b, --brief
              reports  (prints to stdout) only a few important fields from the
              response.

       -c, --changecount
              reports (prints to stdout) the  value  of  the  expander  change
              count  field  from the response. The value is printed in decimal
              and is in the range 0 to 65535. Only  expanders  compliant  with
              SAS-1.1  (and earlier) should yield 0. [Expanders compliant with
              SAS-2 (and later) should set the  "long  response"  bit  in  the
              REPORT GENERAL response to 1.]

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

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

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

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

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

       -z, --zero
              zero the Allocated Response Length field in the request. This is
              required for strict  SAS-1.1  compliance.  However  this  option
              should  not  be  given  in  SAS-2  and  later; if it is given an
              abridged response may result.

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

CONFORMING TO
       The SMP REPORT GENERAL function was introduced  in  SAS-1,  with  small
       additions  in  SAS-1.1 . There have been a large number of additions 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_discover(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                     May 2011                 SMP_REP_GENERAL(8)