File: core

package info (click to toggle)
afbackup 3.1beta1-1
  • links: PTS
  • area: main
  • in suites: slink
  • size: 1,500 kB
  • ctags: 1,685
  • sloc: ansic: 22,406; csh: 3,597; tcl: 964; sh: 403; makefile: 200
file content (253 lines) | stat: -rw-r--r-- 12,839 bytes parent folder | download | duplicates (2)
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
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
alias matches 'echo \!:1 |egrep -i \!:2|wc -l'

if (`matches $OSNAME HPUX`) then
set helps[1]="\\
These are the hostnames of the machines where a server side\\
of the backup service resides. Some kind of streamer device\\
must be connected to these machines. The files and directories,\\
that should be saved, are packed, eventually compressed,\\
and then sent to the named machines, who writes them to the\\
connected device. The named machines are one after the other\
tested for service availability. The servers in this list may be\\
separated by whitespace and/or commas. See also: BackupPorts."
else
set helps[1]="\\
These are the hostnames of the machines where a server side\\
of the backup service resides. Some kind of streamer device\\
must be connected to these machines. The files and directories,\\
that should be saved, are packed, eventually compressed,\\
and then sent to the named machines, who writes them to the\\
connected device. The named machines are tested for service\\
availability. If a server is busy, the next one is tried.\\
BackupPorts can be configured in the same order as the host\\
entries supplied here. The servers in this list may be\\
separated by whitespace and/or commas. If a backup server\\
is the same host as the client, the use of the name localhost\\
is encouraged."
endif
if (`matches $OSNAME HPUX`) then
set helps[2]="\\
These are the port numbers on the backup server machines, where\\
the backup server processes listen. The default is 2988 or the\\
number found in the file /etc/services (or possibly NIS). Several\\
ports can be supplied, positionally according to the backup server\\
hosts supplied in the BackupHosts parameter. The numbers can be\\
separated by whitespace and/or commas. If fewer numbers are supplied\\
than backup servers, the default port applies for the rest.\\
Superfluous port numbers are ignored."
else
set helps[2]="\\
These are the port numbers on the backup server machines, where\\
the backup server processes listen. The default is 2988 or the\\
number found in the file /etc/services (or in NIS if it is\\
configured). Several ports can be supplied, positionally according\\
to the backup server hosts supplied in the BackupHosts parameter.\\
The numbers can be separated by whitespace and/or commas. If\\
fewer numbers are supplied than backup servers, the default port\\
2988 applies for the rest. If more port numbers are given, the\\
superfluous ones are ignored."
endif
if (`matches $OSNAME HPUX`) then
set helps[3]="\\
The cartridge sets on the server side to use for backups.\\
They must bes legal number between 1 and the number of cartridge\\
sets configured on the appropriate server side. Several sets can\\
be supplied, positionally according to the backup server hosts\\
supplied in the BackupHosts parameter. The numbers can be separated\\
by whitespace and/or commas. If fewer numbers are supplied than\\
backup servers, the default set # 1 applies for the rest.\\
Superfluous numbers are ignored."
else
set helps[3]="\\
The cartridge sets on the server side to use for backups.\\
They must bes legal number between 1 and the number of cartridge\\
sets configured on the appropriate server side. Several sets can\\
be supplied, positionally according to the backup server hosts\\
supplied in the BackupHosts parameter. The numbers can be separated\\
by whitespace and/or commas. If fewer numbers are supplied than\\
backup servers, the default set # 1 applies for the rest. If more\\
cartridge set numbers are given, the superfluous ones are ignored."
endif
set helps[4]="\\
If you want your files to be compressed, you can supply the\\
name of the program that should perform the compression here.\\
If you do so, you MUST also supply the appropriate decompress-\\
program. Note that this program may be specified with options\\
but no shell-like constructions such as pipes, variables or\\
wildcards. This program must read standard input and write to\\
standard output."
set helps[5]="\\
The counterpart to the compression program. You must either\\
supply both compress- and uncompress-program or neither of\\
them. Like the compress program, the uncompress-program must\\
read standard input and write to standard output."
set helps[6]="\\
The name of the file where the names of the saved files\\
are stored. The current number is appended to this filename.\\
The number is incremented each time a full backup starts."
set helps[7]="\\
This flag specifies, whether the files, that are saved,\\
should be compressed with the given compression program."
set helps[8]="\\
This flag specifies, whether the filename logging files\\
should be compressed with the given compression program."
set helps[9]="\\
These patterns or filenames specify files, that no\\
compression is attempted on. Normally compression is\\
attempted on all files, and if a file cannot be compressed\\
any further, it is saved uncompressed. This procedure is\\
unefficient for already compressed files, so their\\
compression can be suppressed with this parameter. The\\
value of this parameter must be a list separated by\\
whitespace. Double quotes may enclose list elements.\\"
set helps[10]="\\
This number determines how many log files of previous full\\
backups are saved. These files may serve for the restore\\
of older files than those present in the actual backup.\\
Of course there must be sufficient space to hold all the\\
backups. It doesn't help to save all the saved filenames\\
but not to have them available on tape."
set helps[11]="\\
The name of a file error messages or other notable events\\
are written to. A dash - stands for no logging."
set helps[12]="\\
The directory, where varying files should be put in. These\\
files must not be deleted. The information they contain is\\
necessary for restore."
set helps[13]="\\
The file containing the encryption key for authenticating\\
the backup client to the server. This file must contain\\
at least 5 characters and must not have read permission for\\
group or world."
if (`matches $OSNAME HPUX`) then
set helps[14]='\\
This is the (shell-) command to run at startup time of\\
incremental or full backup. This program should read the\\
standard input and do something reasonable with it, e.g.\\
append it to some file. The produced information can be\\
used to recover from a hard crash, when the files are\\
lost, that are containing the names of the saved files.'
else
set helps[14]='\\
This is the (shell-) command to run at startup time of\\
incremental or full backup. This program should read the\\
standard input and do something reasonable with it, e.g.\\
append it to some file. The produced information can be\\
used to recover from a hard crash, when the files are\\
lost, that are containing the names of the saved files.\\
Therefore this information should not be saved locally on\\
the client host, but e.g. on an NFS-mounted filesystem, a\\
floppy disc or in a mail-file (then this command should\\
be sth. like: mail someuser).'
endif
set helps[15]='\\
This is a (shell-) command to be run before a backup is\\
attempted. If this program returns an exit status unequal to 0,\\
no backup is performed. This parameter makes only sense when\\
backup is started remotely, cause in that case no shell-command\\
can be supplied. If backup is started locally, there is no problem\\
to run whatever is necessery before the backup explicitely.'
set helps[16]='\\
This parameter may specify a (shell-) command to run at\\
exit time of a full or incremental backup. The following\\
patterns are replaced as explained:\\
 %l  by the name of the file containing the filelists\\
 %r  by the name of the file containing statistics (this\\
     file is automatically removed after execution of this\\
     program)\\
 %e  by the overall exit status.'
set helps[17]="\\
This is the directory, the backup client changes to before\\
packing the files and directories. Their names should be\\
supplied relative to this directory, e.g. ./home ."
set helps[18]="\\
These are the names of files, that should not be saved.\\
Wildcards in the usual manner are allowed "'('"shell-style or\\
glob-style, furthermore path-patterns in the style of GNU's\\
find program with option -path. Note, that wildcards also\\
match directory separators i.e. slashes"')'". E.g. it usually\\
makes not much sense to back up object files, that can be\\
easily reproduced from existing program sources."
set helps[19]="\\
These are the names of directories, that should not be saved.\\
Wildcards in the usual manner are allowed "'('"shell-style or\\
glob-style, furthermore path-patterns in the style of GNU's\\
find program with option -path. Note, that wildcards also\\
match directory separators i.e. slashes"')'". E.g. it usually\\
makes not much sense to back up lost+found or directories\\
containing object files "'(often named obj)'
set helps[20]="\\
A file with the name supplied here can be present in any\\
directory. It should contain a list of file-/directory-names\\
(or glob-style patterns), that should be skipped during backup.\\
Each entry must be in an own line. The given names/patterns are\\
valid only in the same directory, where the file resides. Thus\\
each directory can have it's individual exclusion list."
set helps[21]="\\
If you have to backup a large amount of files and the\\
full backup can't be done during one run (e.g. over a\\
weekend), you can divide the full backup into pieces.\\
This number determines, how many pieces you need. If\\
this number is not equal to 1, you have to supply which\\
files and directories you want to save in which piece.\\
You do so by setting the additional parameters appearing\\
when you set this parameter greater than 1."
if (`matches $OSNAME HPUX`) then
set helps[22]="\\
These are the names of files and directories, that should be\\
saved. Usual wildcards are allowed (shell- or glob-style).\\
They should be given relative to the working directory, the\\
client changes to when starting. Supplying a filename preceded\\
with /../ forces the file contents to be saved regardless of\\
the file type. This way raw partitions or similar things can\\
be saved. To force these to be compressed, use the prefix //../\\
The prefix .//. limits reading to the actual filesystem."
else
set helps[22]="\\
These are the names of files and directories, that should be\\
saved. Wildcards in the usual manner are allowed (shell-\\
style or glob-style). They should be supplied relative to\\
the working directory, the client changes to when starting.\\
Descending into directories can be limited to the actual file-\\
system by preceding the filename with the four characters .//.\\
or the option -m (and a space). The prefix .//. is stripped\\
off the name before saving. Supplying a filename preceded with\\
the four characters /../ (what makes no sense normally) or\\
the option -r (and a space) forces the file contents to be\\
saved regardless of the file type. This way raw partitions\\
or similar things can be saved. The prefix /../ is stripped\\
off the name before saving. These file contents are by default\\
never compressed for safety reasons. If you want to force\\
compression nonetheless, use //../ as prefix or precede the\\
name with the option -R (and a space)."
endif
if (`matches $OSNAME HPUX`) then
set helps[23]="\\
These are the names of files and directories, that should be\\
saved as part #num#. Usual wildcards are allowed (shell-\\
or glob-style). They should be given relative to the working\\
directory the client changes to. Supplying a filename preceded\\
with /../ forces the file contents to be saved regardless of\\
the file type. This way raw partitions or similar things can\\
be saved. To force these to be compressed, use //../ as prefix.\\
The prefix .//. limits reading to the actual filesystem."
else
set helps[23]="\\
These are the names of files and directories, that should\\
be saved as part #num#. Wildcards in the usual manner\\
are allowed (shell-style or glob-style). They should be\\
supplied relative to the working directory the client\\
changes to when starting. Descending into directories can\\
be limited to the actual filesystem by preceding the file-\\
name with the four characters .//. or the option -m (and a\\
space). The prefix .//. is stripped off the name before\\
saving. Supplying a filename preceded with the four cha-\\
racters /../ (what makes no sense normally) or the option\\
-r (and a space) forces the file contents to be saved\\
regardless of the file type. This way raw partitions or\\
similar things can be saved. The prefix /../ is stripped\\
off the name before saving. These file contents are by\\
default never compressed for safety reasons. If you want\\
to force compression nonetheless, use //../ as prefix or\\
precede the name with the option -R (and a space)."
endif