PORTSCLEAN(1)

NAME
portsclean - a tool to clean ports/packages garbage

SYNOPSIS
portsclean [-hCDDinPPq]

DESCRIPTION
portsclean is a tool to help users clean out the working directories of their ports tree, no longer referenced distfiles, outdated package files, and obsolete or orphaned shared libraries that were possibly left by pkg_deinstall(1) 's -P option.

OPTIONS
The following command line arguments are supported:

-h
--help
    Show help and exit.

-C
--workclean
    Clean out all the working directories of the ports tree. (cf. WRKDIRPREFIX)

-D
--distclean
    Clean out all the distfiles that are not referenced by any port in the ports tree. Specified twice (i.e. -DD), clean out all the distfiles that are not referenced by any port that is currently installed. (cf. DISTDIR)

-i
--interactive
    Turn on interactive mode. The user is asked for approval before each suggested file/directory is removed.

-L
--libclean
    Clean out old, duplicate and/or orphaned shared libraries.

    portsclean first deletes duplicate shared libraries where appropriate, then puts away old and orphaned shared libaries to /usr/local/lib/compat/pkg updating symlinks properly. To keep biraries working, ldconfig(8) is run after each library deletion or move.

    portsclean is so wise you can safely run it without turning -i on. However, if you want to do further cleanup, specify the flag to be asked on possibly unneeded libraries too.

-n
--noexecute
    Do not actually delete any files.

-P
--pkgclean
    Clean up outdated package tarballs and dead symlinks in the packages directory. (cf. PACKAGES) Specified twice (i.e. -PP), delete all the package tarballs in the directory.

-q
--noconfig
    Do not read the configuration file - $PREFIX/etc/pkgtools.conf.

ENVIRONMENT
PORTSDIR
DISTDIR
WRKDIRPREFIX
PACKAGES
    portsclean detects these variables defined in the configuration file $PREFIX/etc/pkgtools.conf, /etc/make.conf or environment variables to clean files properly. See portupgrade(1) for details of these variables.

PKGTOOLS_CONF
    Configuration file for the pkgtools suite. Default is “$PREFIX/etc/pkgtools.conf”.

FILES

$PREFIX/etc/pkgtools.conf
    Default location of the pkgtools configuration file.

SEE ALSO
pkg_deinstall(1), pkgdb(1), pkgtools.conf(5), ports(7)

AUTHORS
Akinori MUSHA <knu@iDaemons.org>