Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

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

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
       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)