NAME
dds2index - tool to create an indexfile for the use of
SYNOPSIS
dds2index [options]
DESCRIPTION
dds2index creates an index file that is required by the file extraction
utility dds2tar(1). It works on tar archives stored on dds tape
devices (DAT). Since the file structure of the tape archives is used
to extract the files, the archive must be an uncompressed tar archive.
But compression by the transparent signal processor of the tape device
is allowed.
The index created by dds2index is written to stdout by default and
should normally be stored on hard disk as indexfile for later use by
dds2tar(1).
The default tape device to read from is /dev/nst0, which may be
overridden with the environment variable TAPE, which in turn may be
overridden with the -f device option. The device must be a SCSI tape
device.
OPTIONS
-f devicefile
device of the tape archive. Must be a character special file.
-t indexfile
write the index to indexfile, not to stdout.
-z,--compress
write the index in (gzip) compressed mode.
--help print some screens of online help with examples through a pager
and exit immediatley.
OPTIONS you didn’t really need
-b, --block-size
Set the maximal blocksize, dds2index can handle.
--z, --no-compress
Don’t filter the archive file through gzip.
-v,--verbose
verbose mode. Print to stderr what is going on.
-h,--hash-mode
Print a hash sign ’#’ to stderr for each MB read from
tape.
-V,--version
Print the version number of dds2index to stderr and exit
immediately.
EXAMPLES
Example of getting the index from the default tape /dev/nst0 and
storing it in file archive.idx:
dds2index -v -t archive.idx
WARNING
This program can only read records (tar is calling them tape
blocks) up to 32 kbytes. A bigger buffer will cause problems
with the Linux device driver.
ENVIRONMENT
The environment variable TAPE overrides the default tape device
/dev/nst0.
FILES
/dev/nst0 default tape device file. Must be a character
special file.
SEE ALSO
dds2tar(1), mt(1), mt-dds(1), tar(1), gzip(1)
HISTORY
This program was created as a tool for dds2tar(1).
AUTHOR
J"org Weule (weule@cs.uni-duesseldorf.de), Phone +49 211 751409.
This software is available at ftp.uni-
duesseldorf.de:/pub/unix/apollo
2.4 dds2index(1)