dds2index(1) [debian man page]
dds2index(1) General Commands Manual dds2index(1) 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 ar- chive. 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 over- ridden 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)
Check Out this Related Man Page
TAR(1) General Commands Manual TAR(1) NAME
tar - tape archiver SYNOPSIS
tar [ key ] [ name ... ] DESCRIPTION
Tar saves and restores files on magtape. Its actions are controlled by the key argument. The key is a string of characters containing at most one function letter and possibly one or more function modifiers. Other arguments to the command are file or directory names specify- ing which files are to be dumped or restored. In all cases, appearance of a directory name refers to the files and (recursively) subdirec- tories of that directory. The function portion of the key is specified by one of the following letters: r The named files are written on the end of the tape. The c function implies this. x The named files are extracted from the tape. If the named file matches a directory whose contents had been written onto the tape, this directory is (recursively) extracted. The owner, modification time, and mode are restored (if possible). If no file argument is given, the entire content of the tape is extracted. Note that if multiple entries specifying the same file are on the tape, the last one overwrites all earlier. t The names of the specified files are listed each time they occur on the tape. If no file argument is given, all of the names on the tape are listed. u The named files are added to the tape if either they are not already there or have been modified since last put on the tape. c Create a new tape; writing begins on the beginning of the tape instead of after the last file. This command implies r. The following characters may be used in addition to the letter which selects the function desired. 0,...,7 This modifier selects the drive on which the tape is mounted. The default is 1. v Normally tar does its work silently. The v (verbose) option causes it to type the name of each file it treats preceded by the function letter. With the t function, v gives more information about the tape entries than just the name. w causes tar to print the action to be taken followed by file name, then wait for user confirmation. If a word beginning with `y' is given, the action is performed. Any other input means don't do it. f causes tar to use the next argument as the name of the archive instead of /dev/mt?. If the name of the file is `-', tar writes to standard output or reads from standard input, whichever is appropriate. Thus, tar can be used as the head or tail of a filter chain Tar can also be used to move hierarchies with the command cd fromdir; tar cf - . | (cd todir; tar xf -) b causes tar to use the next argument as the blocking factor for tape records. The default is 1, the maximum is 20. This option should only be used with raw magnetic tape archives (See f above). The block size is determined automatically when reading tapes (key letters `x' and `t'). l tells tar to complain if it cannot resolve all of the links to the files dumped. If this is not specified, no error messages are printed. m tells tar to not restore the modification times. The mod time will be the time of extraction. FILES
/dev/mt? /tmp/tar* DIAGNOSTICS
Complaints about bad key characters and tape read/write errors. Complaints if enough memory is not available to hold the link tables. BUGS
There is no way to ask for the n-th occurrence of a file. Tape errors are handled ungracefully. The u option can be slow. The b option should not be used with archives that are going to be updated. The current magtape driver cannot backspace raw magtape. If the archive is on a disk file the b option should not be used at all, as updating an archive stored in this manner can destroy it. The current limit on file name length is 100 characters. TAR(1)