dds2index(1L)

📦
version 2.5.2 · 2 versions
, in opensuse-leap 16.0

🌸 NAME 🌸

okay so dds2index(1L) is the manual page for dds2index — tool to create an indexfile for the use of (yep, the original NAME line literally stops there, bestie 😭).

✨ SYNOPSIS ✨

dds2index [options]

🦋 DESCRIPTION 🦋

okay bestie, here's the vibe: dds2index creates an index file that's 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 has to be an uncompressed tar archive. But compression by the transparent signal processor of the tape device is allowed — that part's fine, no cap. 💅

The index that dds2index creates is written to stdout by default, and you should normally store it on hard disk as an indexfile for later use by dds2tar(1). 💾

The default tape device to read from is /dev/rmt0. That can be overridden with the environment variable TAPE, and TAPE in turn can be overridden with the -f device option. The device must be a SCSI tape device. Periodt. 🎀

💅 OPTIONS 💅

  • -f devicefile — device of the tape archive. Must be a character special file. 🎀
  • -t indexfile — write the index to indexfile, not to stdout. (Yes, this is the "save it, don't just yeet it at the terminal" option.) 💾
  • -z,--compress — write the index in (gzip) compressed mode. 🗜️
  • --help — print some screens of online help with examples through a pager and exit immediately. 💖

💀 OPTIONS you didn't really need 💀

okay these are the bonus-round flags, bestie — not the main character options but still valid:

  • -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/rmt0 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. So like… don't test it, bestie. 💀

🍓 ENVIRONMENT 🍓

The environment variable TAPE overrides the default tape device /dev/rmt0.

🧚 FILES 🧚

  • /dev/rmt0 — default tape device file. Must be a character special file. 🎀

🔥 SEE ALSO 🔥

👑 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.

okay bye bestie — that's the whole dds2index(1L) manual, version 2.4, and the footer didn't give a date so I'm not inventing one. 💖✨

📦 where this page comes from