bshrink(ADM)

bshrink -- remove stored file lists from the online backup history

Syntax

bshrink [ -h hostname ] "filesystem backup_level days" [ ... ]

Description

The bshrink utility removes the stored file lists from the online backup history after they have aged a specified number of days. bshrink does not remove any other records in the backup history. To remove file lists automatically, call bshrink from the root crontab file. See ``Removing file lists from the backup history'' in the System Administration Guide.

bshrink accepts the following options:

hostname

The host to manage (optional). Unless specified, bshrink removes files from the local host.

filesystem

The filesystem device name (for example, /dev/u). For all filesystems, use ``ANY''.

backup_level

The backup level:

COMPLETE: Level 0 backup
INCR1: Incremental Level 1 backup
INCR2: Incremental Level 2 backup
ANY: any level backup

days

an integer defining the number of days to save the backup file lists for the given filesystem and level.

The bshrink utility accepts options in groups of three and processes the groups from left to right. Each group must consist of name of the filesystem, the backup level performed, and how long the file lists should be saved online (in days).

To exclude a filesystem name or backup level, precede it with the keyword ``NOT''. To include all filesystems or backup levels, replace the option with the keyword ``ANY''.

Exit values

If execution was successful, bshrink exits with a value of 0. If execution failed, bshrink exits with a non-zero number.

Examples

To remove the file lists for all backups (``ANY'' backup level and ``ANY'' filesystem) on the system that are older than 30 days, enter:

bshrink "ANY ANY 30"

To remove the file lists for all backups on the host pdxbox and the host scotty that are older than four months (120 days), enter:

bshrink -h pdxbox "ANY ANY 120"
bshrink -h scotty "ANY ANY 120"

To remove the file lists for all backups on the system that are older than 30 days, except the file lists for backups of the /dev/u filesystem, which should remain for 60 days, enter:

bshrink "NOT/dev/u ANY 30" "/dev/u ANY 60"

To remove the file lists for all Level 0 (Complete) backups that are older than 30 days and the file lists for all Level 1 and Level 2 backups that are older than 7 days:

bshrink "ANY COMPLETE 30" "ANY NOTCOMPLETE 7"

Files

/usr/bin/bshrink

Standards conformance

bshrink is not part of any currently supported standard; it is an extension of AT&T System V provided by The Santa Cruz Operation, Inc.