.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $Id: dump.8.in,v 1.47 2003/01/10 10:31:10 stelian Exp $
+.\" $Id: dump.8.in,v 1.50 2003/03/06 14:35:51 stelian Exp $
.\"
.TH DUMP 8 "version __VERSION__ of __DATE__" BSD "System management commands"
.SH NAME
[\fB\-B \fIrecords\fR]
[\fB\-b \fIblocksize\fR]
[\fB\-d \fIdensity\fR]
+[\fB\-D \fIfile\fR]
[\fB\-e \fIinode numbers\fR]
[\fB\-E \fIfile\fR]
[\fB\-f \fIfile\fR]
The default is 1600BPI. Specifying a tape density overrides the end-of-media
detection.
.TP
+.BI \-D " file"
+Set the path name of the file storing the information about the previous
+full and incremental dumps. The default location is
+.IR __DUMPDATES__ .
+.TP
.BI \-e " inodes"
Exclude
.I inodes
The format of
.I date
is the same as that of
-.BR ctime (3).
+.BR ctime (3)
+followed by an rfc822 timezone specification: either a plus or minus sign
+followed by two digits for the number of hours and two digits for the minutes.
+For example, -0800 for eight hours west of Greenwich or +0230 for two hours
+and a half east of Greenwich. This timezone offset takes into account
+daylight savings time (if applicable to the timezone): UTC offsets
+when daylight savings time is in effect will be different than offsets
+when daylight savings time is not in effect. For backward
+compatibility, if no timezone is specified, a local time is assumed.
This option is useful for automated dump scripts that wish to dump over a
specific period of time. The
.B \-T
is readable by people, consisting of one free format record per line:
filesystem name, increment level and
.BR ctime (3)
-format dump date. There may be only one entry per filesystem at each level. The
-file
+format dump date followed by a rfc822 timezone specification (see the
+.B \-u
+option for details). If no timezone offset is specified, times are interpreted
+as local. Whenever the file is written, all dates in the file are converted
+to the local time zone, without changing the UTC times. There
+may be only one entry per filesystem at each level. The file
.I __DUMPDATES__
may be edited to change any of the fields, if necessary.
.TP
to print out, for all file systems in
.I __DUMPDATES__ ,
and regognized file systems in
+.I /etc/mtab
+and
.IR /etc/fstab .
the most recent dump date and level, and highlights those that should be
dumped. If the
Is like
.BR \-W ,
but prints only recognized filesystems in
+.I /etc/mtab
+and
.I /etc/fstab
which need to be dumped.
.TP
.I /etc/fstab
dump table: file systems and frequency
.TP
+.I /etc/mtab
+dump table: mounted file systems
+.TP
.I /etc/group
to find group
.I operator
.BR rmt (8)
.SH DIAGNOSTICS
Many, and verbose.
+.SH COMPATIBILITY
+The format of the
+.I __DUMPDATES__
+file has changed in release 0.4b34, however, the file will be read
+correctly with either pre-0.4b34 or 0.4b34 and later versions of
+.B dump
+provided that the machine on which
+.B dump
+is run did not change timezones (which should be a fairly rare occurence).
.SH EXIT STATUS
.B Dump
exits with zero status on success. Startup errors are indicated with an exit