KDat Documentation
KDat is a tar-based tape archiver, that is designed to work with multiple
archives on a single tape. KDat was inspired by two separate goals. The
first, was to provide a nice, GUI front-end to tar that supported the fast
selective extraction features of the dds2tar program. The second goal
was to answer my wife's question, "How much longer is it going to be
backing up?!?".
KDat is distrubuted under the GNU Public License,
version 2.
Features
- Simple graphical interface to local filesystem and tape contents.
- Multiple archives on the same physical tape.
- Complete index of archives and files is stored on local hard disk.
- Selective restore of files from an archive.
Using KDat
Formatting a Tape
Before a tape can be used with KDat, it must be formatted. When a tape is
inserted into the drive, KDat will detect it, and determine whether it has
been formatted by KDat.
To format a tape, select "Format Tape" from the "File" menu. You will be
prompted for a name for the tape, and the total capacity of the tape. Both
parameters can be changed later through the "Tape Info" dialog. Press "OK"
when finished.
It takes approximately one minute to format the tape. When the format is
complete, the tape name will be shown in the title bar.
Backing Up Files
First, select the file or directory you wish to backup from the "Local
files" tree. Select "Backup" from the "File" menu. You will be prompted
for the following information:
- Archive name:
- The symbolic name for the archive that is stored in the tape index.
- Source file:
- The file or directory name that will be passed to tar. This filename
is relative to the working directory.
- Working directory:
- The directory from which the tar command will be executed.
- Stay on one filesystem:
- Instruct tar not to descend into directories that are on a different
filesystem than the source file.
- GNU listed incremental:
- Instruct tar to perform an incremental backup.
- Snapshot file:
- This is a file that is created and maintained by tar, and is used for
determining which files have changed between incremental backups.
- Remove snapshot file before backup:
- Remove the snapshot file before invoking tar. This has the effect of
making tar backup every file. In the course of performing the backup,
tar will create the snapshot file that will be used for the next
incremental backup.
Select "OK" to start the backup. KDat will begin by estimating the total
size of the archive. This value is only used to give an estimate of the
time remaining to complete the backup. The "Backup" dialog will then
appear, and display the progress of tar command. The backup can be aborted
at any time by pressing the "Abort" button. Press "OK" when the backup is
complete, and an entry for the new archive should appear in the "Tape
files" tree.
Restoring Files
Restoring files is very similar to backing up files. Select the directory
or file that you wish to restore, from the "Tape files" tree. You need not
restore the entire archive all at once. You can select an individual file
or subdirectory to restore. KDat will fast forward to the correct spot in
the archive and begin the restore from there. It is not necessary to read
the entire archive. After selecting a file, choose "Restore" from the
"File" menu. You will be prompted for the name of a directory in which to
perform the restore. Enter a directory name, and press "OK". The
"Restore" dialog should appear to show the progress of the tar command.
Verifying Archived Files
You can compare the files in an archive to files on your local hard disk.
The process is identical to restoring files, with the exception that no
files are restored, and only the differences are logged in the "Verify"
dialog.
Creating an Index for a Tape
KDat automatically creates a unique ID for each tape that it formats. This
ID is written on the tape, and it is used to locate the tape index on your
hard disk. If the index file is lost, corrupted, or doesn't exist (i.e.
you took a tape to your friend's house), you can have KDat recreate the
index from the tape contents.
Recreating the index from tape can take a long time. KDat must read every
byte of every archive on the tape. If KDat detects a formatted tape, but
cannot locate the index you will automatically be prompted to reindex the
tape. You may also manually ask KDat to reindex a tape by choosing "Index
Tape" from the "File" menu. Reindexing a tape will overwrite any existing
index for the tape.
Ejecting the Tape
To eject the tape from the drive, choose "Eject Tape" from the "File" menu.
KDat locks the tape into the drive because KDat will get confused if the
tape is ejected by the user.
Changing Tape Info
Certain information about the tape and its archives can be edited through
the "Tape Info" dialog. You may change the tape name, the total capacity
of the tape, and the names of any archives on the tape. In addition,
detailed information about the tape, archives, and files can be viewed. To
view the "Tape Info" dialog, choose "Tape Info" from the "Edit" menu.
Editing Preferences
The following program preferences can be set, by choosing "Preferences"
from the "Edit" menu:
- Default tape size
- The default tape capacity to fill in for the user when a tape is
formatted.
- Tape block size
- The physical block size, in bytes, for the tape drive.
- Tape device
- The path to the tape device.
- Tar command
- The full path to tar on your system.
Sean Vyain
Last modified: Sun Jan 11 19:17:20 EST 1998