smp_conf_zone_phy_info(8)

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

NAME

6       smp_conf_zone_phy_info - invoke CONFIGURE ZONE PHY INFORMATION function
7

SYNOPSIS

9       smp_conf_zone_phy_info   [--expected=EX]   [--help]  [--hex]  [--inter‐
10       face=PARAMS] --pconf=FN [--raw]  [--sa=SAS_ADDR]  [--save=SAV]  [--ver‐
11       bose] [--version] SMP_DEVICE[,N]
12

DESCRIPTION

14       Sends  a SAS Serial Management Protocol (SMP) CONFIGURE ZONE PHY INFOR‐
15       MATION function request to an SMP target. The SMP target is  identified
16       by  the  SMP_DEVICE  and the --sa=SAS_ADDR. Depending on the interface,
17       the SAS_ADDR may be deduced from the SMP_DEVICE. The mpt interface uses
18       SMP_DEVICE  to  identify  a  HBA (an SMP initiator) and needs the addi‐
19       tional ,N to differentiate between HBAs if there are multiple present.
20
21       Each zone phy configuration descriptor is 4 bytes long. The first  byte
22       is  a (expander) phy identifier. The second byte has 3 modifiable bits:
23       bit 5 is "inside ZPSDS persistent"; bit 4 is "requested inside  ZPSDS";
24       and bit 2 is "zone group persistent". The other bits in the second byte
25       are reserved and should be 0. The third byte is reserved and should  be
26       0. The fourth byte is the zone group.
27

OPTIONS

29       Mandatory  arguments to long options are mandatory for short options as
30       well.
31
32       -E, --expected=EX
33              set the 'expected  expander  change  count'  field  in  the  SMP
34              request.  The value EX is from 0 to 65535 inclusive with 0 being
35              the default value. When EX is greater  than  zero  then  if  the
36              value  doesn't match the expander change count of the SMP target
37              (i.e. the expander) when the request  arrives  then  the  target
38              ignores  the  request  and  sets  a  function result of "invalid
39              expander change count" in the response.
40
41       -h, --help
42              output the usage message then exit.
43
44       -H, --hex
45              output the response (less the CRC field) in hexadecimal.
46
47       -I, --interface=PARAMS
48              interface specific parameters. In this case  "interface"  refers
49              to  the  path through the operating system to the SMP initiator.
50              See the smp_utils man page for more information.
51
52       -p, --pconf=FN
53              FN is a file containing zone phy  configuration  descriptors  in
54              ASCII  hexadecimal;  either  as  bytes  separated by space, tab,
55              comma or newline, or as longer strings of hexadecimal  bytes  in
56              which  every  2  digits represents a byte. Empty lines and those
57              starting with "#" are ignored.  Since each zone  phy  configura‐
58              tion  descriptor  is  4 bytes long, the number of bytes in FN is
59              expected to be a multiple of 4.
60
61       -r, --raw
62              send the response (less the CRC field) to stdout in binary.  All
63              error messages are sent to stderr.
64
65       -s, --sa=SAS_ADDR
66              specifies  the  SAS  address  of  the SMP target device. The mpt
67              interface  needs  this  option  and  it  will  typically  be  an
68              expander's  SAS address. The SAS_ADDR is in decimal but most SAS
69              addresses are shown in hexadecimal.  To give a number  in  hexa‐
70              decimal either prefix it with '0x' or put a trailing 'h' on it.
71
72       -S, --save=SAV
73              set the 'save' field in the SMP request. SAV may take these val‐
74              ues: 0 for updating the shadow values (default), 1 for  updating
75              the  saved values, 2 for updating shadow values and if available
76              the saved values, 3 for updating both saved and shadow values.
77
78       -v, --verbose
79              increase the verbosity of  the  output.  Can  be  used  multiple
80              times.
81
82       -V, --version
83              print the version string and then exit.
84

NOTES

86       The  expander phys that make up a wide port (2 or more attached to phys
87       with the same SAS address) must be set to the same zone phy  configura‐
88       tion settings (other than the phy id).
89
90       Zone  phy information can be read back from an expander and placed in a
91       file with the smp_discover_list utility's --zpi=FN option.  The  format
92       of that file should be suitable for this utility's --pconf=FN option.
93

CONFORMING TO

95       The SMP CONFIGURE ZONE PHY INFORMATION function was introduced in SAS-2
96       .
97

AUTHORS

99       Written by Douglas Gilbert.
100

REPORTING BUGS

102       Report bugs to <dgilbert at interlog dot com>.
103

COPYRIGHT

105       Copyright © 2011 Douglas Gilbert
106       This software is distributed under a FreeBSD license. There is NO  war‐
107       ranty;  not  even  for MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR‐
108       POSE.
109