duc

Index the /usr directory, writing to the default database location ~/.duc.db

$ duc index [/usr]

$ duc ls [[-Fg|--classify --graph]] [/usr/local]

$ duc ls [[-Fg|--classify --graph]] [[-R|--recursive]] [/usr/local]

$ duc gui [/usr]

$ duc ui [/usr]

$ duc info

duc index [options] duc ui [options] duc graph [options]

--exclude
    Exclude files matching the given pattern from the index.

-i
    Specify the index file to use (instead of the default).

-q
    Quiet mode. Suppress non-error output.

-v
    Verbose mode. Increase verbosity.

-X
    Exclude files listed in the given file.

--version
    Print version information and exit.

--help
    Display help message and exit.

duc (Disk Usage Calculator) provides tools for indexing and visualizing disk space usage.

It's designed for large file systems where standard `du` can be slow and inefficient. Instead of calculating usage on demand, duc creates a pre-computed index, enabling rapid querying and visualization of disk usage.

The core functionality is provided by the `duc index` command which scans a directory and stores the sizes of all files and directories in a database. Subsequent `duc ui` or `duc graph` commands can then be used to browse or graph the indexed data interactively.

The main purpose of this tool is to facilitate easy and quick disk usage analysis. This makes it useful for system administrators or advanced users who need to manage disk space effectively. Duc aims to be faster and more feature-rich than traditional tools like du and df.

The index file can become quite large, especially for very large file systems. Ensure sufficient disk space is available for the index.

duc index: Creates or updates the disk usage index for the specified directory. Re-running it will update the index with any changes since the last run.

duc ui: Launches an interactive ncurses-based user interface to browse the disk usage data stored in the index file. It enables drill-down into directory structures and visualization of disk usage percentages.

duc graph: Generates a graph of the disk usage data. The output format can be specified using options (e.g. PNG, SVG).

duc was developed to address performance limitations of traditional `du` on very large file systems.

The indexing approach was chosen to pre-calculate the disk usage and provide fast interactive exploration.

du(1), df(1), ncdu(1)