afclient.8.in

一套客户/服务器模式的备份系统代码,跨平台,支持linux,AIX, IRIX, FreeBSD, Digital Unix (OSF1), Solaris and HP-UX.

to or receiving from a backup server in verbose
mode in combination with -n:
printout server name and port number at the
beginning of the line, e. g.: orion%2988!
.TP
.B -N <file>    
while archiving: ignore files with a modification
time before the one of the given file, only save
newer files or such with the same age in seconds
.TP
.B -n           
for each packed or unpacked filename, if sending
to or receiving from a backup server in verbose
mode:
printout cartridge and tape file number at the
beginning of the line, e. g.: 7.15: <filename>
.br
In combination with -X: precede each line of
output received from the remotely started program
with the identifier of the remote host and a
colon, e. g.:  darkstar: Full backup finished.
.TP
.B -O           
for each packed file creating a backup in verbose
mode: printout the user-ID of the file owner at
the beginning of the line prefixed with a bar |
eventually behind cartridge and file number
.TP
.B -o <uid>     
archive or extract only files owned by the user
with the given user-ID (an integer)
.TP  
.B -p <portno>  
use a different port number for communicating with
the backup server. Default is TCP-Port 2988
.TP  
.B -R           
pack or extract directories recursively with all
of their contents
.TP  
.B -r           
use filenames relative to the current directory,
whether they start with a slash or not. If -r
is given more then 1 time, also let symlinks
originally pointing to absolute paths now point
to paths relative to the directory, where the
symlink will be created
.TP
.B -S <cartset> 
The cartridge set to use, where <cartset> is the
number of a valid cartridge set on the server
side. Default is 1. This option makes sense only
when creating backups with 
.B -c
.TP
.B -s <filepat> 
do not attempt processing on files matching the
given filename pattern. This parameter may
appear several times
.TP
.B -T <file>    
read the filenames to process from the <file>.
The filenames must be separated by whitespace.
If whitespace is part of a filename, it has to
be enclosed by double quotes. Double quotes or
backslashes within the filename have to be
preceded by a backslash. In combination with
-D: the tape files to be copied are temporarily
stored in the given directory instead of the
default directory /tmp
.TP
.B -U          
for each packed file creating a backup in verbose
mode: printout the modification time of the file
in seconds since 1970/1/1 0:00 at the beginning
of the line prefixed with a tilde ~ eventually
behind cartridge number, file number and owner
.TP  
.B -u           
while extracting: remove existing files with the
same name as found in the archive. Otherwise
no existing files are overwritten
.TP  
.B -V <file>    
write a report containing statistics at the end of
a backup to the <file>
.TP
.B -v           
verbose mode: print the filenames while creating
or extracting, be a little more verbose while
listing contents. If -v is the only given flag:
print out software name and version
.TP  
.B -z <z> <uz>  
use <z> as the command, that is used to process
files, <uz> for the corresponding unprocess.
The command has to read from stdin and to write
to stdout. If arguments have to be supplied to
<z> and/or <uz>, don't forget to use quotes. If
built-in compression is desired, the command for
processing has to start with a dot (.), followed
by a space and a number ranging from 1 to 9, that
specifies the compression level. If an additional
external command should process the data, it may
follow, separated from the compression level by
whitespace. The order of processing is: First the
external program processes the data, then built-in
compression is applied. An empty string has to be
supplied for <uz> (or any other dummy is ok), if
only built-in compression is desired.
Examples for <z>:
.IP
.br
 gzip       (run external command gzip),
 "gzip -2"  (the same with an argument),
 ". 8"      (only built-in compression level 8),
 ". 3 __descrpt -k /my/key" (run command __descrpt
            and apply built-in compression level 3)
.fi
.TP  
.B -Z           
while printing out the contents: check those files
in the archive that are processed for integrity.
While creating an archive: write a CRC32 checksum
for each file, file contents or command output to
the backup stream
.TP  
.B -?           
to printout this text
.SH FILENAMES
The names of the files and directories, that have to be put
into or extracted from an archive are by default read from the
standard input. If you supply filenames in the command line or
enter the 
.B -a 
flag when extracting, standard input is not read.
The same applies, when filenames are read from a file with the
.B -T 
option. When reading the names from a file or from standard
input, they must be given one per line. If a name contains
special characters (like newline or nonprintable ones), they
have to be specified using backslash-sequences like in C-code,
e.g. \\n for newline.
In save mode (
.B -c
) filenames can be prefixed with character
sequences, that have special meanings (no space between prefix
and filename):
.TP
/../
The file is not saved with all attributes present
in the inode, but only the contents are saved.
This might be useful for saving raw-devices
.TP
//../
With /../ the configured processing is not
applied to the file contents for safety reasons.
With this prefix processing can be forced
nonetheless
.TP
|||
and a mandatory space character indicates, that
the following characters up to (but not including)
another triple bar ||| should be interpreted as a
shell command, that is started and whose standard
output is written to the backup. At restore time
the command following the second triple bar is
started and the data stream read at backup time is
written to it's standard input. This might be
useful for saving e.g. databases. The second
command may be terminated by a triple sharp ###,
that starts an optional comment.
Example:
.IP
.nf
||| pg_dumpall ||| psql db_tmpl ### Store Postgres DBs
.fi
.SH STATUS REPORTS
The -w option reports one of the following states,
separated by the plus character + :
.TP
.B READY
the device is not in use by any program and the
server side is ready to service requests
.TP
.B BUSY
the device is in use and currently operated by the
afbackup service
.TP
.B DEVINUSE
the streamer device is in use by some program, that
is not part of the afbackup service
.TP
.B UNAVAIL
the streamer device is not accessible or in some
other way occupied
.TP
.B UNLOADED
the device is not busy, but there is no tape loaded
.TP
.B CHANGEABLE
when reported together with UNLOADED, a tape can be
loaded quickly e.g. using the afclient command with
option -C <cartno>. It is not considered quickly,
if a human operator must put the cartridge into the
drive, so in this case only UNLOADED is reported.
When reported with READY, the tape can be changed
quickly (same understanding as before).
.SH DESTINATION
The destination tape for the duplicate operation can be given
in two ways: either with the options -h, -p, -C and -k following
the -D immediately without space and enclosed in quotes, so that
they appear as an own argument list in one real argument, e.g.:
.LP
.nf
 -D' -C 5 -h targethost -p targetport'
(double quotes are of course also possible ...).
.fi
.PP
The second format is as follows:
.LP
.nf
 [<targetcart>][@<targethost>][%targetport>][:<targetcryptkeyfile>]
.fi
.LP
At least one of the specifiers must be present. Examples:
.LP
.nf
 5@otherhost
 5%2990:/keyfile/for/target/server
 @otherhost%2970
.fi
.LP
If one of the specifiers is omitted, it is assumed identical with
the copy source specified in the normal options -h, -p, -C and -k.
Copying a tape to itself is prevented.
.SH FILES
.IP @clientconfdir@/@clientconf@
Client configuration file
.IP @clientlogdir@
The directory for logging the client backups
.IP @clientvardir@
Some internal state information of the client backups.
.SH SEE ALSO
afclientconfig(8), xafclientconfig(8), full_backup(8),
incr_backup(8), afverify(8), afrestore(8), xafrestore(8),
afserver(8), afmserver(8),
copy_tape(8), afclient.conf(8), afserver.conf(8),
update_indexes(8), tar(1) 
.SH AUTHOR
.B afbackup 
was written by Albert Fluegel ([e-mail]). This manpage was
extracted from the text docs by Christian Meder 
([e-mail]).