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

NAME

6       smp_zone_lock - invoke ZONE LOCK SMP function
7

SYNOPSIS

9       smp_zone_lock [--expected=EX] [--fpass=FP] [--help] [--hex] [--inactiv‐
10       ity=TL] [--interface=PARAMS]  [--password=PA]  [--raw]  [--sa=SAS_ADDR]
11       [--verbose] [--version] SMP_DEVICE[,N]
12

DESCRIPTION

14       Sends a SAS Serial Management Protocol (SMP) ZONE LOCK function request
15       to an SMP target. The SMP target is identified by  the  SMP_DEVICE  and
16       the  --sa=SAS_ADDR.  Depending  on  the  interface, the SAS_ADDR may be
17       deduced from the SMP_DEVICE. The mpt interface uses SMP_DEVICE to iden‐
18       tify  a HBA (an SMP initiator) and needs the additional ,N to differen‐
19       tiate between HBAs if there are multiple present.
20

OPTIONS

22       Mandatory arguments to long options are mandatory for short options  as
23       well.
24
25       -E, --expected=EX
26              set  the  'expected  expander  change  count'  field  in the SMP
27              request.  The value EX is from 0 to 65535 inclusive with 0 being
28              the  default  value.  When  EX  is greater than zero then if the
29              value doesn't match the expander change count of the SMP  target
30              (i.e.  the  expander)  when  the request arrives then the target
31              ignores the request and  sets  a  function  result  of  "invalid
32              expander change count" in the response.
33
34       -F, --fpass=FP
35              where  FP is the name of a file which contains the password. The
36              password may be in ASCII in which case it is on  one  line  sur‐
37              rounded by either single quotes are double quotes. Alternatively
38              the password may be given in ASCII hexadecimal; either as  bytes
39              separated  by space, tab, comma or newline, or as longer strings
40              of hexadecimal bytes in which every 2 digits represents a  byte.
41              Empty lines and those starting with "#" are ignored.
42
43       -h, --help
44              output the usage message then exit.
45
46       -H, --hex
47              output the response (less the CRC field) in hexadecimal.
48
49       -i, --inactivity=TL
50              sets  the  zone lock inactivity time limit to TL which has units
51              of 100 milliseconds. The default value is  0  which  implies  no
52              time limit.
53
54       -I, --interface=PARAMS
55              interface  specific  parameters. In this case "interface" refers
56              to the path through the operating system to the  SMP  initiator.
57              See the smp_utils man page for more information.
58
59       -P, --password=PA
60              where  PA  is  the  zone  manager password which may be up to 32
61              bytes long.  This  option  cannot  be  give  together  with  the
62              --fpass=FP option. The default password is 32 NULLs (zero bytes)
63              and PA is padded with NULLs to the right (to make  it  32  bytes
64              long in the request).
65
66       -r, --raw
67              send  the response (less the CRC field) to stdout in binary. All
68              error messages are sent to stderr.
69
70       -s, --sa=SAS_ADDR
71              specifies the SAS address of the  SMP  target  device.  The  mpt
72              interface  needs  this  option  and  it  will  typically  be  an
73              expander's SAS address. The SAS_ADDR is in decimal but most  SAS
74              addresses  are  shown in hexadecimal.  To give a number in hexa‐
75              decimal either prefix it with '0x' or put a trailing 'h' on it.
76
77       -v, --verbose
78              increase the verbosity of  the  output.  Can  be  used  multiple
79              times.
80
81       -V, --version
82              print the version string and then exit.
83

CONFORMING TO

85       The SMP ZONE LOCK function was introduced in SAS-2 .
86

AUTHORS

88       Written by Douglas Gilbert.
89

REPORTING BUGS

91       Report bugs to <dgilbert at interlog dot com>.
92
94       Copyright © 2011 Douglas Gilbert
95       This  software is distributed under a FreeBSD license. There is NO war‐
96       ranty; not even for MERCHANTABILITY or FITNESS FOR  A  PARTICULAR  PUR‐
97       POSE.
98

SEE ALSO

100       smp_utils,    smp_zone_activate,    smp_zone_unlock,   smp_ena_dis_zon‐
101       ing(smp_utils)
102
103
104
105smp_utils-0.96                     June 2011                  SMP_ZONE_LOCK(8)
Impressum