Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   14857 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

SMP_PHY_TEST(8)			   SMP_UTILS		       SMP_PHY_TEST(8)

NAME
       smp_phy_test - invoke PHY TEST FUNTION SMP function

SYNOPSIS
       smp_phy_test   [--control=CO]  [--dwords=DW]  [--expected=EX]  [--func‐
       tion=FN]	 [--help] [--hex] [--interface=PARAMS] [--linkrate=LR] [--pat‐
       tern=PA]	 [--phy=ID]  [--raw]  [--sa=SAS_ADDR]  [--verbose] [--version]
       SMP_DEVICE[,N]

DESCRIPTION
       Sends a SAS Management Protocol (SMP) PHY TEST FUNCTION	request	 to  a
       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. With one interface there is one SMP_DEVICE per machine
       so the SMP_DEVICE,N syntax is needed to differentiate between  HBAs  if
       there are multiple present.

       The  PHY TEST FUNCTION function can be used to start and stop test pat‐
       tern transmission. When a phy associated with a SMP target (most likely
       an expander) starts test pattern transmission then the attached phy (if
       there is one) sees a link down.

       SAS phys associated with SSP targets (e.g. a  SAS  disk)	 can  generate
       similar	test  patterns	by using the SEND DIAGNOSTIC SCSI command with
       page code 3fh . See the sg_senddiag utility.

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

       -c, --control=CO
	      set the 'phy test pattern dwords control' field. The argument CO
	      can be from 0 to 255 inclusive, the default is 0 (each  byte  in
	      'dwords'	sent  as  data	byte (Dxx.y) without scrambling). Only
	      active when 'pattern' is set to 40h (i.e. "two_dwords").

       -d, --dwords=DW
	      set the 'phy test pattern dwords' field which is 8  bytes	 long.
	      The  argument DW would normally be entered in hex with a leading
	      '0x' or a trailing 'h' (otherwise it  would  be  interpreted  as
	      decimal).	 Due  to a quirk in the command line parser, the argu‐
	      ment value ffffffffffffffffh (i.e. all bits sets)	 needs	to  be
	      entered as '-1'.

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

       -f, --function=FN
	      set  the	'phy  test  function' field in the SMP request. Values
	      between 0 and 255 are accepted with the  default	being  0.  The
	      value  0	stops the selected phy performing a phy test function.
	      The value 1 starts the selected phy transmitting the  test  pat‐
	      tern (and anything that the phy receives is discarded).

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

       -H, --hex
	      output the response 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.

       -l, --linkrate=LR
	      transmits	 the test pattern at the specified physical link rate:
	      8 -> 1.5 Gbps, 9 -> 3 Gbps, 10 -> 6 Gbps. Default value is 9.

       -P, --pattern=PA
	      specifies the type of test pattern to  transmit.	SAS-2  (rev15)
	      values  are:  1  ->  JTPAT,  2  ->  CJTPAT, 10h -> TRAIN, 11h ->
	      TRAIN_DONE,  12h	->  IDLE,   13h	  ->   SCRAMBLED_0,   40h   ->
	      "two_dwords".  Default value is 2.

       -p, --phy=ID
	      phy identifier. ID is a value between 0 and 127. Default is 0.

       -r, --raw
	      send  the	 response  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.

CONFORMING TO
       The  SMP	 PHY  TEST  function was introduced in SAS-1.1 and enhanced in
       SAS-2 .

AUTHORS
       Written by Douglas Gilbert.

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

COPYRIGHT
       Copyright © 2006-2008 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, sg_senddiag(sg3_utils)

smp_utils-0.93			 December 2008		       SMP_PHY_TEST(8)

Vote for polarhome