Name

mspasswd — Change passwords for MSS files.

Synopsis

mspasswd [-project proj] [-R] (1) password options path...


(1) [-rpwd read_password] [-wpwd write_password] [-newr read_password] [-neww write_password]

Description

The mspasswd command can be used to change or remove the read password, write password or both of an MSS file.

Options

mspasswd specific options:

-p[roject] proj

Supply proj as the project number for charging. Currently, no charging is done for metadata operations, so this option is a placeholder for when charging might be imposed.

-R

Recursively set passwords. For each operand that names a directory, mspasswd will set the specified password(s) on all MSS files in the hierarchy.

The common password related options are:

-rpwd password

Supply the read password for the following MSS files. If another read password was specified prior to this point in this command line, and the following MSS files do no have a read password, a null password must be given: -rpwd ''. If the MSS files do not have a read password, this option must not be used.

-wpwd password

Supply the write password for the following MSS files. If another write password was specified prior to this point in this command line, and the following MSS files do no have a write password, a null password must be given: -wpwd ''. If the MSS files do not have a write password, this option must not be used.

-newr password

Supply the new read password for the following MSS files. If another new read password was specified prior to this point in this command line, and you do not want a new password set for the following MSS files, a null password must be given: -newr ''. If you want to turn off an existing read password, you must use: -newr OFF.

-neww password

Supply the new write password for the following MSS files. If another new write password was specified prior to this point in this command line, and you do not want a new password set for the following MSS files, a null password must be given: -neww ''. If you want to turn off an existing write password, you must use: -neww OFF.

Operands

path

A pathname of an MSS file whose password(s) will be modified. If the recursive option (-R) is set, then all MSS files contained within the directory hierarchy named by path will have their password(s) modified.

Examples

Example 25. Add a new write password.

mspasswd -neww SECRET myfile

Example 26. Add a new write password to all MSS files under a directory.

mspasswd -R -neww SECRET /USER/some/directory

Example 27. Remove the read password from some files.

mspasswd -rpwd old -newr OFF 'X123[A-C]'

Example 28. Change a write password and set a new read password.

Changes the write password and sets a new read password for all files that start with C in either directory /USER/DIRA or /USER/DIRB:

mspasswd -wpwd oldw -neww neww -newr newr '/USER/{DIRA,DIRB}/C*'

Environment Variables

See Environment Variables section of the Command Behavior and Envrionment chapter for details.

Exit Status

See Exit Status Codes section of the Command Behavior and Environment chapter for details.

See Also

msmv(1NCAR), msrcp(1NCAR)

Copyright

2008 University Corporation for Atmospheric Research, all rights reserved.