smp_rep_phy_sata(8)

1SMP_REP_PHY_SATA(8)                SMP_UTILS               SMP_REP_PHY_SATA(8)
2
3
4

NAME

6       smp_rep_phy_sata - invoke REPORT PHY SATA SMP function
7

SYNOPSIS

9       smp_rep_phy_sata    [--affiliation=AC]   [--help]   [--hex]   [--inter‐
10       face=PARAMS] [--phy=ID] [--raw] [--sa=SAS_ADDR] [--verbose] [--version]
11       [--zero] SMP_DEVICE[,N]
12

DESCRIPTION

14       Sends  a  SAS  Serial Management Protocol (SMP) REPORT PHY SATA request
15       function to an  SMP  target.  The  SMP  target  is  identified  by  the
16       SMP_DEVICE  and  the SAS_ADDR. Depending on the interface, the SAS_ADDR
17       may be deduced from the SMP_DEVICE. The mpt interface  uses  SMP_DEVICE
18       to  identify  an  HBA (an SMP initiator) and needs the additional ,N to
19       differentiate between HBAs if there are multiple present.
20
21       -a, --affiliation=AC
22              where AC is the affiliation context relative identifier that  is
23              placed in request (new in sas2r08). Defaults to 0.
24
25       -h, --help
26              output the usage message then exit.
27
28       -H, --hex
29              output the response (less the CRC field) in hexadecimal.
30
31       -I, --interface=PARAMS
32              interface  specific  parameters. In this case "interface" refers
33              to the path through the operating system to the  SMP  initiator.
34              See the smp_utils man page for more information.
35
36       -p, --phy=ID
37              phy identifier. ID is a value between 0 and 254. Default is 0.
38
39       -r, --raw
40              send  the response (less the CRC field) to stdout in binary. All
41              error messages are sent to stderr.
42
43       -s, --sa=SAS_ADDR
44              specifies the SAS address of the SMP  target  device.  Typically
45              this  is  an  expander.  This  option  may  not be needed if the
46              SMP_DEVICE has the target's SAS address within it. The  SAS_ADDR
47              is  in  decimal but most SAS addresses are shown in hexadecimal.
48              To give a number in hexadecimal either prefix it  with  '0x'  or
49              put a trailing 'h' on it.
50
51       -v, --verbose
52              increase the verbosity of the output. Can be used multiple times
53
54       -V, --version
55              print the version string and then exit.
56
57       -z, --zero
58              zero  the  Allocated  Response Length field in the request. This
59              option also zeros the Request Length field in the request.  This
60              is  required  for strict SAS-1.1 compliance. However this option
61              should not be given in SAS-2  and  later;  if  it  is  given  an
62              abridged response may result.
63

EXAMPLES

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

CONFORMING TO

68       The  SMP  REPORT  PHY  SATA  function  was  introduced  in SAS-1 .  The
69       "Expander change count", "STP I_T  nexus  loss  occurred"  and  several
70       other fields were added in SAS-2 .
71

AUTHORS

73       Written by Douglas Gilbert.
74

REPORTING BUGS

76       Report bugs to <dgilbert at interlog dot com>.
77

COPYRIGHT

79       Copyright © 2006-2011 Douglas Gilbert
80       This  software is distributed under a FreeBSD license. There is NO war‐
81       ranty; not even for MERCHANTABILITY or FITNESS FOR  A  PARTICULAR  PUR‐
82       POSE.
83