eclean

Clean the source file directory

$ sudo eclean distfiles

$ sudo eclean packages

$ sudo eclean --deep --package-names distfiles

$ sudo eclean --deep --package-names packages

eclean [options] OR eclean-distfiles [options] OR eclean-pkg [options]

--deep
    Deep clean mode that cleans up temporary files from the cache.

--dry-run
    Simulates the cleaning process without actually deleting any files.

--package-names
    Specifies cleaning by package name rather than category/package.

--ask
    Prompts for confirmation before deleting each file.

--only-config-files
    Only cleanup configuration files.

--help
    Displays help information.

--version
    Displays the version number.

eclean is a command-line utility primarily used on Gentoo Linux systems to clean up outdated packages, logs, and other unnecessary files.

It focuses on freeing up disk space by removing old versions of installed packages from the package cache, cleaning up temporary directories, and managing logs.

It significantly aids in maintaining a clean and efficient system by preventing the accumulation of redundant data. eclean is typically used in conjunction with Gentoo's Portage package management system. The tool simplifies routine maintenance tasks that would otherwise require manual intervention, ensuring a well-optimized and lean system.

eclean should be used with caution, especially when using options like --deep, as it might inadvertently remove files needed by the system. Always use --dry-run first to preview the changes.

eclean-distfiles is focused on removing downloaded source files, whereas eclean-pkg targets removing outdated binary packages. Understanding the distinction is key to avoiding unintended data loss.

While most functionality is accessed directly from the command line, eclean also respects configuration settings found in Portage's configuration files which allows it to customize behavior globally.

eclean was specifically developed for Gentoo Linux to address the need for automated cleanup of package caches and temporary files.

It has evolved to provide a more flexible and configurable way to manage system space by removing unnecessary data created during package installation and system maintenance. The tool is an essential part of the Gentoo user workflow.

emerge(1), portage(5)