System Administration Guide: Basic Administration

Options and Arguments for the ufsdump Command

This section describes in detail the options and arguments for the ufsdump command. The syntax for the ufsdump command is as follows:


/usr/sbin/ufsdump options arguments filenames 

options

Is a single string of one-letter option names. 

arguments

Identifies option arguments and might be multiple strings. The option letters and the arguments that go with them must be in the same order. 

filenames

Identifies the files to back up. These arguments must always come last. 

Default ufsdump Options

If you run the ufsdump command without any options, use this syntax:


# ufsdump filenames

The ufsdump command uses these options and arguments, by default:


ufsdump 9uf /dev/rmt/0 filenames

These options do a level 9 incremental backup to the default tape drive at its preferred density.

Options for the ufsdump Command

The following table describes the options for the ufsdump command.

Table 49–1 Options for the ufsdump Command

Option 

Description 

0–9

Dump level. Level 0 is for a full backup of the complete file system that is specified by filenames. Levels 1–9 are for incremental backups of files that have changed since the last lower-level backup.

a archive-file

Archive file. Stores (archives) a backup table of contents in a specified file on the disk. The file can be understood only by the ufsrestore command, which uses it to determine whether a file to be restored is present in a backup file, and if so, on which volume of the media it resides.

b factor

Blocking factor. Specifies the number of 512-byte blocks to write to tape at a time. 

c

Cartridge. Back up to cartridge tape. When end-of-media detection applies, this option sets the block size to 126. 

d bpi

Tape density. Use this option only when the ufsdump command cannot detect the end of the media.

D

Diskette. Backs up to diskette. 

f dump-file

Dump file. Writes the files to the destination that is specified by dump-file instead of the default device. If the file is specified as user@system:device, the ufsdump command attempts to execute as the specified user on the remote system. The specified user must have a /.rhosts file on the remote system that allows the user who is invoking the command on the local system to access the remote system.

l

Autoload. Use this option if you have an autoloading (stackloader) tape drive. When the end of a tape is reached, this option takes the drive offline and waits up to two minutes for the tape drive to be ready again. If the drive is ready within two minutes, it continues. If the drive is not ready after two minutes, it prompts the operator to load another tape. 

n

Notify. When intervention is needed, this option sends a message to all terminals of all users in the sys group.

o

Offline. When finished with a tape or diskette, this option takes the drive offline, rewinds (if tape), and if possible removes the media (for example, ejects a diskette or removes an 8-mm autoloaded tape). 

s size

Size. Specifies the length of tapes in feet or for diskettes, the number of 1024-byte blocks. Use this option only when the ufsdump command cannot detect the end of the media.

S

Estimates the size of the backup. Determines the amount of space that is needed to perform the backup, without actually doing it, and outputs a single number that indicates the estimated size of the backup in bytes. 

t tracks

Tracks. Specifies the number of tracks for a 1/4-inch cartridge tape. Use this option only when the ufsdump command cannot detect the end of the media.

u

Updates the dump record. A completed backup of a file system adds an entry to the /etc/dumpdates file. The entry indicates the device name for the file system's disk slice, the dump level (0–9), and the date. No record is written when you do not use the u option or when you back up individual files or directories. If a record already exists for a backup at the same level, it is replaced.

v

Verify. After each tape or diskette is written, verifies the contents of the media against the source file system. If any discrepancies occur, prompts the operator to mount new media, then repeats the process. Use this option only on an unmounted file system, because any activity in the file system causes the ufsdump command to report discrepancies.

w

Warning. Lists the file systems that appear in the /etc/dumpdates file that have not been backed up within a day. When you use this option, all other options are ignored.

W

Warning with highlight. Shows all the file systems that appear in the /etc/dumpdates file and highlights those file systems that have not been backed up within a day. When you use this option, all other options are ignored.


Note –

The /etc/vfstab file does not contain information about how often to back up a file system.