NAME

ufsdump − incremental file system dump

SYNOPSIS

ufsdump [options] filesystem

DESCRIPTION

ufsdump backs up all files in filesystem, or files changed after a certain date, to magnetic tape; options is a string that specifies ufsdump options, as shown below. 

Filesystem may be specified as the full special file name, the full special file name without the leading ’/’, the suffix of the full special file name, the directory mount point on which filesystem is mounted, or the directory mount point on which filesystem is mounted without the leading ’/’.  The only requirement is that filesystem must exist in at least one of either mnttab or vfstab.  e.g.  Assuming that the appropriate entry is in at least one of mnttab or vfstab, any of the following are acceptable filesystem specifications:

•/usr2
•usr2
•/dev/dsk/m328_c0d0s6
•dev/dsk/m328_c0d0s6
•/dev/rdsk/m328_c0d0s6
•dev/rdsk/m328_c0d0s6
•m328_c0d0s6
•/dev/SA/disk1s6
•dev/SA/disk1s6
•/dev/rSA/disk1s6
•dev/rSA/disk1s6
•disk1s6

The options are:

−0−9 The “dump level.” All files in the filesystem that have been modified since the last ufsdump at a lower dump level are copied to the volume.  For instance, if you did a “level 2” dump on Monday, followed by a “level 4” dump on Tuesday, a subsequent “level 3” dump on Wednesday would contain all files modified or added since the “level 2” (Monday) backup.  A “level 0” dump copies the entire filesystem to the dump volume. 

−b factor
Blocking factor. Specify the blocking factor for tape writes. The default is 20 blocks per write. Note: the blocking factor is specified in terms of 512 bytes blocks, for compatibility with tar.  The default blocking factor for tapes of density 6250BPI and greater is 64.  The default blocking factor for cartridge tapes (−c option specified) is 126.  The highest blocking factor available with most tape drives is 126. 

−c Cartridge.  Use a cartridge instead of the standard half-inch reel.  This sets the density to 1000BPI and the blocking factor to 126.  The length is set to 425 feet.  This option is incompatible with the −d option, unless you specify a density of 1000BPI with that option. 

−d bpi
Tape density. The density of the tape, expressed in BPI, is taken from bpi. This is used to keep a running tab on the amount of tape used per reel. The default density is 1600 except for cartridge tape. Unless a higher density is specified explicitly, ufsdump uses its default density — even if the tape drive is capable of higher-density operation (for instance, 6250BPI).  Note: the density specified should correspond to the density of the tape device being used, or ufsdump will not be able to handle end-of-tape properly. 

−f dump-file
Dump file. Use dump-file as the file to dump to, instead of /dev/rmt/ctape1. If dump-file is specified as −, dump to the standard output. 

−n Notify all operators in the operator group that ufsdump requires attention by sending messages to their terminals, in a manner similar to that used by the wall command. 

−s size
Specify the size of the volume being dumped to.  When the specified size is reached, ufsdump waits for you to change the volume.  ufsdump interprets the specified size as the length in feet for tapes and cartridges.  The following are defaults:

tape 2300 feet

cartridge 425 feet

−t tracks
Specify the number of tracks for a cartridge tape. The default is 9 tracks. The −t option is not compatible with the −D option. 

−u Update the dump record.  Add an entry to the file /etc/dumpdates, for each filesystem successfully dumped that includes the filesystem name, date, and dump level.  This file can be edited by the super-user. 

−w List the file systems that need backing up.  This information is gleaned from the files /etc/dumpdates and /etc/vfstab.  When the −w option is used, all other options are ignored.  After reporting, ufsdump exits immediately. 

−W Similar to the −w option, except that the −W option includes all file systems that appear in /etc/dumpdates, along with information about their most recent dump dates and levels.  Filesystems that need backing up are highlighted. 

If no options are given, the default is −9u. 

NOTES

Fewer than 32 read errors on the filesystem are ignored. 

Each reel requires a new process, so parent processes for reels already written just hang around until the entire tape is written. 

It is recommended that incremental dumps also be performed with the system running in single-user mode. 

FILES

/dev/rmt/ctape1 default unit to dump to

/etc/dumpdates dump date record

/etc/group to find group operator

/etc/hosts

SEE ALSO

tar(1), wall(1), shutdown(1M), ufsrestore(1M).