smp_ena_dis_zoning(8)

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

NAME

6       smp_ena_dis_zoning - invoke ENABLE DISABLE ZONING SMP function
7

SYNOPSIS

9       smp_ena_dis_zoning  [--disable] [--ena-dis=ED] [--expected=EX] [--help]
10       [--hex]  [--interface=PARAMS]  [--raw]   [--sa=SAS_ADDR]   [--save=SAV]
11       [--verbose] [--version] SMP_DEVICE[,N]
12

DESCRIPTION

14       Sends  a  SAS  Serial  Management  Protocol (SMP) ENABLE DISABLE ZONING
15       function request to an SMP target. The SMP target is identified by  the
16       SMP_DEVICE  and  the  --sa=SAS_ADDR.  Depending  on  the interface, the
17       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       If neither --disable nor --ena-dis=ED options  are  given  then  enable
22       zoning (i.e. "--ena-dis=1") is assumed.
23
24       This  function  does not change the state of the current zoning enabled
25       flag (as seen in the REPORT GENERAL response). Such a state change will
26       occur on a subsequent invocation of the ZONE ACTIVATE function.
27

OPTIONS

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

CONFORMING TO

88       The SMP ENABLE DISABLE ZONING function was introduced in SAS-2 .
89

AUTHORS

91       Written by Douglas Gilbert.
92

REPORTING BUGS

94       Report bugs to <dgilbert at interlog dot com>.
95

COPYRIGHT

97       Copyright © 2011 Douglas Gilbert
98       This software is distributed under a FreeBSD license. There is NO  war‐
99       ranty;  not  even  for MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR‐
100       POSE.
101