Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
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 re-
     quest 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  re-
	    sponse.

     -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  er-
	    ror 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 re-
	    quired 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 addi-
     tions 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 warranty;
     not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO
     smp_utils, smp_discover(smp_utils)

smp_utils-0.96			    May 2011		      SMP_REP_GENERAL(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=smp_rep_general&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help