1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
|
Description
===========
This program is used to maintain archives on a backup server
host or in a file. Archives can be created, extracted or their
contents be listed. Almost one of the following flags has to
be supplied:
-c to create an archive
-x to extract from an archive
-t to list the contents of an archive
-d to verify (compare) the contents of an archive
-C to set a certain cartridge on the backup server
(makes only sense extracting or listing with -x or
-t, the writing position can't be changed by clients)
-F to set a certain file on the backup server's tape
(the same applies as for -C)
-q to printout the actual cartridge and tape file number
on the backup server
-Q to printout the cartridge and tape file number for the
the next write access on the backup server
-X followed by the full path name of a program to be started on
the client. This can be used to trigger a backup remotely.
If the program needs arguments, the command together with
the arguments has to be enclosed by quotes
-I to printout an index of the backups written to the actual
cartridge
-w to check the status of the streamer on the server side, e.g.
whether it is ready and waiting for requests to service
-c, -x, -t, -d, -X and -I are mutual exclusive. The other options
can be supplied as needed. To set the cartridge and/or the tape
file on the backup server is only making sense when not creating
an archive. The serial order of writing to tape is handled by
the server machine independently of the client.
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 -a flag when extracting, standard input is not read.
The same is valid, if filenames are read from a file with the
-T option. When reading the names from a file or from standard
input, filenames have to be separated by whitespace. If a name
is containing whitespace, it has to be enclosed in double
quotes ("). If a name contains double quotes or backslashes,
each has to be preceded by a backslash (so backslashes become
double backslashes).
More options in alphabetical order:
-A <time> process files (save or extract) modified after
the given time in seconds since 1.1.1970 00:00
-a in combination with -x: extract all files and
directories in the archive
-B <time> process files (save or extract) modified before
the given time in seconds since 1.1.1970 00:00
-b don't enter buffering mode
-e <errlog> Use the file <errlog> to write error messages to
instead of the standard error output
-f <file> write to or read from a file instead of querying
the backup server
-g while extracting/reading: ignore leading garbage,
suppress error messages at the beginning. This
is useful when extracting from tape files, that
are not the first ones of a whole archive.
-H <header> put the supplied informational header to the begin
of the backup
-h <host> use the backup server with the name <host>
default host is the machine with the name
backuphost
-i while extracting: ignore the stored ownership and
do not restore it
-k <file> use the contents of the given file as encryption
key for authenticating to the server
-l for each packed or unpacked filename, if sending
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!
-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
-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>
-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
-o <uid> archive or extract only files owned by the user
with the given user-ID (an integer)
-p <portno> use a different port number for communicating with
the backup server. Default is TCP-Port 2988
-R pack or extract directories recursively with all
of their contents
-r use filenames relative to the current directory,
whether they start with a slash or not
-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 -c
-s <filepat> do not attempt compression on files matching the
given filename pattern. This parameter may
appear several times
-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
-u while extracting: remove existing files with the
same name as found in the archive. Otherwise
no existing files are overwritten
-V <file> write a report containing statistics at the end of
a backup to the <file>
-v verbose mode: print the filenames while creating
or extracting, be a little more verbose while
listing contents
-z <z> <uz> use <z> as the command, that is used to compress
files, <uz> for the corresponding uncompress.
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
-Z while printing out the contents: check those files
in the archive that are compressed for integrity
-? to printout this text
|
