duc
Index and inspect disk usage
TLDR
Index the /usr directory, writing to the default database location ~/.duc.db
List all files and directories under /usr/local, showing relative file sizes in a graph
List all files and directories under /usr/local using treeview recursively
Start the graphical interface to explore the file system using sunburst graphs
Run the ncurses console interface to explore the file system
Dump database info
SYNOPSIS
duc index [options]
PARAMETERS
--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.
DESCRIPTION
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.
CAVEATS
The index file can become quite large, especially for very large file systems. Ensure sufficient disk space is available for the index.
INDEX MANAGEMENT
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.
USER INTERFACE
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.
GRAPH GENERATION
duc graph: Generates a graph of the disk usage data. The output format can be specified using options (e.g. PNG, SVG).
HISTORY
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.