Name

msrm — Remove MSS files.

Synopsis

msrm [-project proj] [-Rf] [-rf1tim time] (1) password options path...


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

Description

The msrm utility removes the specified MSS files. When an MSS file is removed, it is placed into the trash, and may be recovered with msrecover for a period of 30 days.

Options

msrm specific options:

-R

Recursively remove files (and directories). For each operand that names a directory, msrm will remove everything in that directory tree.

-f

Do not issue error messages or modify the exit status in case of nonexistent operands.

-rf1tim time

Only remove the MSS file(s) if their last reference time matches time, which is of the format YYYYMMDDhhmmss. This time can be obtained from the output of either msallinfo(1NCAR) (the "Ref1 Time" value), msls(1NCAR) (in the date and time fields with the -cT option), or msrawinfo(1NCAR) (the MFDB_RF1TIM field).

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

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.

Operands

path

A pathname of an MSS file (or directory) to remove.

Example

Example 38. Remove a MSS file that has a write password.

msrm -wpwd yoyo mydata

Example 39. Remove MSS files that match a shell pattern.

This example removes all MSS files that start with the letter Q in the current MSS working directory:

msrm 'Q*'

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

msallinfo(1NCAR), msfind(1NCAR), msls(1NCAR), msrawinfo(1NCAR), msrecover(1NCAR)

Copyright

2008 University Corporation for Atmospheric Research, all rights reserved.