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
       request to an SMP target. The SMP target	is identified by  the  SMP_DE-
       VICE  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 iden-
       tify a HBA (an SMP initiator) and needs the additional ,N to  differen-
       tiate 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 RE-
	      PORT 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 ad-
       ditions 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.

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

home | help