smp_rep_zone_man_pass - invoke REPORT ZONE MANAGER PASSWORD function
smp_rep_zone_man_pass [--fpass=FP] [--help] [--hex] [--inter- face=PARAMS] [--phex] [--raw] [--report=RT] [--sa=SAS_ADDR] [--verbose] [--version] SMP_DEVICE[,N]
SMP_REP_ZONE_MAN_PASS(8) SMP_UTILS SMP_REP_ZONE_MAN_PASS(8) NAME smp_rep_zone_man_pass - invoke REPORT ZONE MANAGER PASSWORD function SYNOPSIS smp_rep_zone_man_pass [--fpass=FP] [--help] [--hex] [--inter- face=PARAMS] [--phex] [--raw] [--report=RT] [--sa=SAS_ADDR] [--verbose] [--version] SMP_DEVICE[,N] DESCRIPTION Sends a SAS Serial Management Protocol (SMP) REPORT ZONE MANAGER PASS- WORD function requests to an SMP target. The SMP target is identified by the SMP_DEVICE and the --sa=SAS_ADDR. Depending on the interface, the SAS_ADDR may be deduced from the SMP_DEVICE. The mpt interface uses SMP_DEVICE to identify a HBA (an SMP initiator) and needs the addi- tional ,N to differentiate between HBAs if there are multiple present. OPTIONS Mandatory arguments to long options are mandatory for short options as well. -F, --fpass=FP where FP is the name of a file which the password will be writ- ten to. The default action (in the absence of this option) is to write the password to stdout. -h, --help output the usage message then exit. -H, --hex output the response (less the CRC field) in hexadecimal. To only see the password in hexadecimal use the --phex option. -I, --interface=PARAMS interface specific parameters. In this case "interface" refers to the path through the operating system to the SMP initiator. See the smp_utils man page for more information. -p, --phex Output the password in comma separated hexadecimal bytes. In the absence of this option the password is output in ASCII sur- rounded by single quotes. Note the hexadecimal bytes are output with a hex indication (i.e. there is nos leading "0x" nor trail- ing "h"). -r, --raw send the response (less the CRC field) to stdout in binary. All error messages are sent to stderr. -R, --report=RT set the 'report type' field in the SMP request. RT may take these values: 0 for report the current zone manager password (default); 1 is reserved; 2 for report the saved zone manager password; 3 for report the default zone manager password. -s, --sa=SAS_ADDR specifies the SAS address of the SMP target device. The mpt interface needs this option and it will typically be an expander's SAS address. The SAS_ADDR is in decimal but most SAS addresses are shown in hexadecimal. To give a number in hexa- decimal either prefix it with '0x' or put a trailing 'h' on it. -v, --verbose increase the verbosity of the output. Can be used multiple times. -V, --version print the version string and then exit. CONFORMING TO The SMP REPORT ZONE MANAGER PASSWORD function was introduced in SAS-2 . AUTHORS Written by Douglas Gilbert. REPORTING BUGS Report bugs to <dgilbert at interlog dot com>. COPYRIGHT Copyright (C) 2011 Douglas Gilbert This software is distributed under a FreeBSD license. There is NO war- ranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR- POSE. ATTRIBUTES See attributes(7) for descriptions of the following attributes: +---------------+--------------------------+ |ATTRIBUTE TYPE | ATTRIBUTE VALUE | +---------------+--------------------------+ |Availability | system/storage/smp_utils | +---------------+--------------------------+ |Stability | Uncommitted | +---------------+--------------------------+ SEE ALSO smp_utils, smp_conf_zone_man_pass, smp_zone_lock(smp_utils) NOTES Source code for open source software components in Oracle Solaris can be found at https://www.oracle.com/downloads/opensource/solaris-source- code-downloads.html. This software was built from source available at https://github.com/oracle/solaris-userland. The original community source was downloaded from http://sg.danny.cz/sg/p/smp_utils-0.98.tgz. Further information about this software can be found on the open source community website at http://sg.danny.cz/sg/smp_utils.html. smp_utils-0.96 May 2011 SMP_REP_ZONE_MAN_PASS(8)