'\"macro stdmacro
.if n .pH g1a.finc @(#)finc	40.6 of 10/10/89
.\" Copyright 1989 AT&T
.nr X
.if \nX=0 .ds x} finc 1M "Cartridge Tape Utilities" "\&"
.if \nX=1 .ds x} finc 1M "Cartridge Tape Utilities"
.if \nX=2 .ds x} finc 1M "" "\&"
.if \nX=3 .ds x} finc "" "" "\&"
.TH \*(x}
.SH NAME
\f4finc\f1 \- fast incremental backup 
.SH SYNOPSIS
\f4/usr/sbin/finc\f1
[\f2selection-criteria\fP] \f2file-system raw-tape\fP
.SH DESCRIPTION
\f4finc\fP
selectively copies the input \f2file-system\f1 to the output \f2raw-tape\f1.
The cautious will want to mount the input
.I file-system\^
read-only to ensure an accurate backup,
although acceptable results can be obtained in read-write mode.
The tape must be previously labelled by \f4labelit\fP.
The selection is controlled by the 
.IR "selection-criteria" ,
accepting only those inodes/files for whom the conditions are true.
.PP
It is recommended that production of a
\f4finc\fP
tape be preceded by the
\f4ff\fP
command, and the output of
\f4ff\fP
be saved as an index of the tape's contents.
Files on a
\f4finc\fP
tape may be recovered with the
\f4frec\fP
command.
.PP
The argument
.I n\^
in the \f2selection-criteria\fP which follow is used 
as a decimal integer (optionally signed), where
\f4+\f2n\f1
means
more than
.IR n ,
\f4\-\f2n\f1
means
less than
.IR n ,
and 
.I n\^
means exactly
.IR n .
A day is defined as a period of 24 hours.
.TP 16
\f4\-a\f2 n\f1
True if the file has been accessed in
.I n
days.
.TP 16
\f4\-m\f2 n\f1
True if the file has been modified in
.I n\^
days.
.TP 16
\f4\-c\f2 n\f1
True if the i-node has been changed in 
.I n\^
days.
.TP 16
\f4\-n\f2 file\f1
True for any file which has been modified more recently than the argument
.IR file .
.SH EXAMPLES
To write a tape consisting of all files from file-system
\f4/usr\f1
modified in the last 48 hours:
.P
.RS
\f4finc  \|\-m  \|\-2  \|/dev/rdsk/c1d0s2  \|/dev/rSA/ctape1\fP
.RE
.SH "SEE ALSO"
\f4ff\fP(1M),
\f4frec\fP(1M),
\f4labelit\fP(1M).
.br
\f4cpio\fP(1) in the
\f2User's Reference Manual\f1.
.SH NOTE
The raw device is required when providing both the file system
and the tape to \f4finc\fP.  Failure to do so will cause an error. 
.\"	@(#)finc.1m	5.2 of 5/18/82
.Ee
