.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
-.\" 3. All advertising materials mentioning features or use of this software
-.\" must display the following acknowledgement:
-.\" This product includes software developed by the University of
-.\" California, Berkeley and its contributors.
-.\" 4. Neither the name of the University nor the names of its contributors
+.\" 3. Neither the name of the University nor the names of its contributors
.\" may be used to endorse or promote products derived from this software
.\" without specific prior written permission.
.\"
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $Id: dump.8.in,v 1.45 2002/09/02 12:43:12 stelian Exp $
+.\" $Id: dump.8.in,v 1.52 2003/03/31 09:42:57 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]
[\fB\-Q \fIfile\fR]
[\fB\-s \fIfeet\fR]
[\fB\-T \fIdate\fR]
+[\fB\-y\fR]
[\fB\-z\fIcompression level\fR]
.I files-to-dump
.PP
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
.BR RMT .
.TP
.BI \-F " script"
-Run script at the end of each tape. The device name and the current volume
-number are passed on the command line. The script must return 0 if
+Run script at the end of each tape (except for the last one).
+The device name and the current volume number are passed on the
+command line. The script must return 0 if
.B dump
should continue without asking the user to change the tape, 1 if
.B dump
.B dump
on an active filesystem where read errors simply indicate an inconsistency
between the mapping and dumping passes.
+.IP
+A value of 0 means that all read errors will be ignored.
.TP
.BI \-j "compression level"
Compress every block to be written on the tape using bzlib library. This option
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
+.BI \-y
+Compress every block to be written to the tape using the lzo library.
+This doesn't compress as well as the zlib library but it's much faster.
+This option will work only when dumping to a file or pipe or, when dumping to
+a tape drive, if the tape drive is capable of writing variable length blocks.
+You will need at least the 0.4b34 version of
+.B restore
+in order to extract compressed tapes. Tapes written using compression will not
+be compatible with the BSD tape format.
+.TP
.BI \-z "compression level"
Compress every block to be written on the tape using zlib library. This option
will work only when dumping to a file or pipe or, when dumping to a tape drive,
.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
git.wh0rd.org / dump.git / blobdiff