Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Wednesday, July 27, 2022

smp_rep_phy_event_list (8)


smp_rep_phy_event_list - invoke REPORT PHY EVENT LIST SMP function


smp_rep_phy_event_list   [--desc]   [--enumerate]   [--force]  [--help]
[--hex] [--index=IN]  [--interface=PARAMS]  [--long]  [--nonz]  [--raw]
[--sa=SAS_ADDR] [--verbose] [--version] [--zero] SMP_DEVICE[,N]



       smp_rep_phy_event_list - invoke REPORT PHY EVENT LIST SMP function

       smp_rep_phy_event_list   [--desc]   [--enumerate]   [--force]  [--help]
       [--hex] [--index=IN]  [--interface=PARAMS]  [--long]  [--nonz]  [--raw]
       [--sa=SAS_ADDR] [--verbose] [--version] [--zero] SMP_DEVICE[,N]

       Sends  a  SAS  Serial  Management  Protocol (SMP) REPORT PHY EVENT LIST
       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.

       Reports zero or more phy event list descriptors. Each  descriptor  con-
       tains  a phy identifier, a phy event source, a phy event (i.e. a count)
       and a peak value detector theshold. At least one phy  event  should  be
       maintained for each phy.

       Mandatory  arguments to long options are mandatory for short options as

       -d, --desc
              precede each phy event descriptor with  a  line  announcing  its
              descriptor index number. Index numbers start at 1.

       -e, --enumerate
              enumerate  all of the known Phy Event Source names, one per line
              preceded by its value in hex. Ignores SMP_DEVICE if it is given;
              most  other options are also ignored. Exits after displaying the

       -f, --force
              force the report to continue after the last descriptor index has
              been  exceeded.  The  default action is too stop the report when
              the last descriptor index has been exceeded.  at 1.

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

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

       -i, --index=IN
              starting phy event list descriptor index. IN is a value  between
              0  and  65535.  The  default  is 1. If IN is 0 then the response
              should contain no phy event list descriptors but the  'last  phy
              event  list  descriptor  index'  and  'phy event list descriptor
              length' fields in the response should be set appropriately.  The
              last point was clarified in SPL-2 revision 3.

       -l, --long
              prefix  each phy event source string with its numeric identifier
              in hex.  Also place "phy_id=" in front  of  the  phy  identifier
              number.  For example: "phy_id=3: [0x1]: Invalid word count: 29";
              without this option this line would be: "3: Invalid word  count:

       -n, --nonz
              only  show  phy  events with non-zero counts or peak values. The
              default is to show all phy events in the response.

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

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

       |Availability   | system/storage/smp_utils |
       |Stability      | Uncommitted              |

       Similar information is maintained for SAS SSP target phys  (e.g.  on  a
       SAS  disk). It can be obtained from the Protocol Specific Port log page
       with the sg_logs utility.

       Similar information may be obtained for SAS initiator phys (e.g.  on  a
       SAS  HBA). As an example in Linux 2.6.28 error information can be found
       in this directory /sys/class/sas_phy/phy-4:0 (for the phy 0 in SCSI/SAS
       host 4).

       Similar  information  may  be  obtained for SATA device phys (e.g. on a
       SATA disk). If there is a SAT layer between OS and the SATA device then
       the sg_sat_phy_event utility can fetch the information.

       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-

       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.

       The SMP REPORT PHY EVENT LIST function was introduced in SAS-2 .

       Written by Douglas Gilbert.

       Report bugs to <dgilbert at interlog dot com>.

       Copyright (C) 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-

       smp_utils,   smp_phy_control,   smp_rep_phy_event(smp_utils)   sg_logs,

smp_utils-0.97                   December 2011       SMP_REP_PHY_EVENT_LIST(8)