DEFAULTS: <Fromdir>, the source directory, defaults to the current directory.
<Todir>, the target directory, defaults to /d0.
FUNCTION: The program will search the directory <fromdir>, comparing the files and subordinate directories in <fromdir> with those in <todir>. For all new, or updated files. it will generate copy and makdir commands to copy the files across to <todir>, overwriting any old copies on <todir>.
The program may be used to maintain backup copies of a system, or to assist in rebuilding a system form backups. As the program will never overwrite a file except by a newer version of itself, it is safer to use than COPY with the -r option.
OPTIONS: The following options are provided:
-b=<no>k
The -b option acts in the same way as it does on the COPY and DSAVE commands. It specifies the size of the copy buffer.
-d=<file>
Up to 50 -d options may be entered, each one specifies a directory in <fromdir> which is to be backed up (along with its subordinate directories). If any -d options are specified, then only those directories specified will be copied from <fromdir>. If none are specified, then the whole of <fromdir> is backed up.
-e
The MAKDIR and COPY commands are normally written to the stdout file. If the -e option is given then the MAKDIR and COPY commands are implemented immediately.
-f=<suffix>
Up to 20 -f options maty be entered. Files ending with <suffix> (default is "_BAK") will not be backed up.
-k
If the -k option is given, then any files with the name OS9Boot will be omitted from the backup.
-l
If the -l option is given then no lower level directories are processed, only those specified directly by the <fromdir> and any -d parameters.
-p
This option is designed for use when the backup is being done as a batch job from a shell script. If the -p option is specified then the program will ask for confirmation before proceeding with the backup. If a "PORT" environment variable exists, then that will be used to read the confirmation from. If no "PORT" environment exists, then the pathname "/TERM" is used.
-s=file and -t=file
The -s (start) and -t (termination) parameters allow the user to specify a range of files to be copied. All files with a pathname (relative to <fromdir>) greater than or equal to the start filename, and less than the termination filename will be copied. This enables the backing up of dirctories which contain more than a disc full of data. Only one -s and one -t parameter can be given. The -s and -t are not allowed with the -d option.
-v
This is the same parameter as used in the COPY command, it verifies the copy command.
-?
This is the normal help utility.
EXAMPLE: The following shows how DBACK may be used to make a script file for a backup job.