dlb(6)

dlb6

Nethack data librarian

Usage

dlb {c | t | x} [v] [C directory] [file] ...

dlb {c | t | x} [v] I list-file

dlb {c | t | x} [v] [f archive-file-name] [file] ...

Overview

Dlb is a file archiving tool in the spirit (and tradition) of tar(1) for nethack(6) version 3.1 and higher. It is used to maintain the archive files from which the game reads special level files and other read-only information. Note that like tar, the letters specifying the operation and options are expressed as a continuous string. Unlike tar, dlb is configured with a default set of file names to process.

Operations

c causes dlb to create a new archive from files in the current directory.

t lists the files in the archive.

x causes dlb to extract the contents of the archive into the current directory.

Options

C dir

Change directory to dir before trying to read any files.

f archive

Read from or write to archive instead of LIBFILE (usually the nhdat file in the playground).

I list-file

Read from list-file the names of files to emplace within or extract from the archive. The default for archive creation is LIBLISTFILE.

v

Operate verbosely.

Examples

Create the default archive from the default file list:

dlb c

List the contents of the archive foo:

dlb tf foo

Releases

17 releases since Debian 1.2 (Rex); the text changed 3 times.

  1. 1.2–8
  2. 9
  3. 10–13
  4. Arch

Author

Kenneth Lorber

Bugs

•

Not a good tar emulation; - does not mean stdin or stdout.

•

Should include an optional compression facility.

•

Not all read-only files for NetHack can be read out of an archive; examining the source is the only way to know which files can be.

From nethack 5.0.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.