smp_rep_zone_man_pass(8)

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

NAME

6       smp_rep_zone_man_pass - invoke REPORT ZONE MANAGER PASSWORD function
7

SYNOPSIS

9       smp_rep_zone_man_pass    [--fpass=FP]    [--help]   [--hex]   [--inter‐
10       face=PARAMS] [--phex] [--raw] [--report=RT] [--sa=SAS_ADDR] [--verbose]
11       [--version] SMP_DEVICE[,N]
12

DESCRIPTION

14       Sends  a SAS Serial Management Protocol (SMP) REPORT ZONE MANAGER PASS‐
15       WORD function requests 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

OPTIONS

22       Mandatory arguments to long options are mandatory for short options  as
23       well.
24
25       -F, --fpass=FP
26              where  FP is the name of a file which the password will be writ‐
27              ten to.  The default action (in the absence of this  option)  is
28              to write the password to stdout.
29
30       -h, --help
31              output the usage message then exit.
32
33       -H, --hex
34              output the response (less the CRC field) in hexadecimal. To only
35              see the password in hexadecimal use the --phex option.
36
37       -I, --interface=PARAMS
38              interface specific parameters. In this case  "interface"  refers
39              to  the  path through the operating system to the SMP initiator.
40              See the smp_utils man page for more information.
41
42       -p, --phex
43              Output the password in comma separated hexadecimal bytes. In the
44              absence  of  this  option  the  password is output in ASCII sur‐
45              rounded by single quotes.  Note the hexadecimal bytes are output
46              with a hex indication (i.e. there is nos leading "0x" nor trail‐
47              ing "h").
48
49       -r, --raw
50              send the response (less the CRC field) to stdout in binary.  All
51              error messages are sent to stderr.
52
53       -R, --report=RT
54              set  the  'report  type'  field  in the SMP request. RT may take
55              these values: 0 for report the  current  zone  manager  password
56              (default);  1  is  reserved; 2 for report the saved zone manager
57              password; 3 for report the default zone manager password.
58
59       -s, --sa=SAS_ADDR
60              specifies the SAS address of the  SMP  target  device.  The  mpt
61              interface  needs  this  option  and  it  will  typically  be  an
62              expander's SAS address. The SAS_ADDR is in decimal but most  SAS
63              addresses  are  shown in hexadecimal.  To give a number in hexa‐
64              decimal either prefix it with '0x' or put a trailing 'h' on it.
65
66       -v, --verbose
67              increase the verbosity of  the  output.  Can  be  used  multiple
68              times.
69
70       -V, --version
71              print the version string and then exit.
72

CONFORMING TO

74       The SMP REPORT ZONE MANAGER PASSWORD function was introduced in SAS-2 .
75

AUTHORS

77       Written by Douglas Gilbert.
78

REPORTING BUGS

80       Report bugs to <dgilbert at interlog dot com>.
81

COPYRIGHT

83       Copyright © 2011 Douglas Gilbert
84       This  software is distributed under a FreeBSD license. There is NO war‐
85       ranty; not even for MERCHANTABILITY or FITNESS FOR  A  PARTICULAR  PUR‐
86       POSE.
87