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
|