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