damage(1M)

NAME
     damage - Marks archive entries as damaged

SYNOPSIS
     /opt/SUNWsamfs/sbin/damage [-a] -c copy_no [-f]
     [-m media_type [-v vsn]] [-M] [-o] filename ...

     /opt/SUNWsamfs/sbin/damage [-a] [-c copy_no] [-f]
     -m media_type [-v vsn] [-M] [-o] filename ...

     /opt/SUNWsamfs/sbin/damage [-a] -c copy_no [-f]
     [-m media_type [-v vsn]] [-M] [-o] -r dirname ...  filename
     ...

     /opt/SUNWsamfs/sbin/damage [-a] [-c copy_no] [-f]
     -m media_type [-v vsn] [-M] [-o] -r dirname ...  filename
     ...

AVAILABILITY
     SUNWsamtp

DESCRIPTION
     The damage command marks archive copies as damaged.  The
     command marks copies of one or more files or directories as
     damaged based on the archive copy number and/or the media
     type and VSN specified.  There are several ways to mark one
     or more archive copies as damaged.  These ways are as
     follows:

     o  By copy number

     o  By copy number, media type, and VSN

     o  By copy number and media type

     o  By media type

     o  By media type and VSN

     If a fatal error is detected when staging an archive copy,
     that archive copy is marked as damaged.  An archive copy
     that is damaged is not selected for staging.

OPTIONS
     This command accepts the following options:

     -a        Rearchives the damaged copy.

     -c copy_no
               Marks the specified archive copy number as
               damaged.  If one or more -c options are are
               specified, only those archive copies (copies 1, 2,

               3, or 4) are marked as damaged.  Specify 1, 2, 3,
               or 4 for copy_no.  Either a -c or a -m option must
               be specified.

     -f        Suppresses errors.

     -m media_type
               Marks all copies from the specified media_type as
               damaged.  For the list of possible media_type
               specifications, see the mcf(4) man page.  Either a
               -c or a -m option must be specified.  If you
               specify a -m option, you can also specify a -v
               option.

     -M        Marks only metadata as damaged.  This includes
               directories, the segment index, and
               removable-media files.  Regular files are not
               marked as damaged.  If you are marking a directory
               as damaged, you must specify the -M option.

     -o        Specifies that the file must be online before it
               is marked as damaged.  If the file is offline, the
               damage command stages the file to disk before
               deleting any entries.

     -r dirname ...
               Recursively marks one or more specified dirnames
               and subdirectories as damaged.  The archive
               entries of files in the directories and
               subdirectories are marked as damaged.

     -v vsn    Marks the archive copies on vsn as damaged.  For
               vsn, specify a volume serial name (VSN).  If you
               specify a -v option, you must also specify a -m
               option.

     filename ...
               Marks the archive copies for one or more specified
               filename arguments as damaged.

SEE ALSO
     mcf(4).