Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
PORTSCLEAN(1)           FreeBSD General Commands Manual          PORTSCLEAN(1)

NAME
     portsclean - a tool to clean ports/packages garbage

SYNOPSIS
     portsclean [-hCDDinPPQQq]

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 binaries 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.

                    You can use the sysutils/libchk port to check which
                    library is linked with which binaries.

     -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
     --quiet        Do not write anything to stdout.  Specified twice, do not
                    write anything to stderr either.  This is for internal
                    use.

     -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
     libchk(1), pkg_deinstall(1), pkgdb(1), pkgtools.conf(5), ports(7)

AUTHORS
     Akinori MUSHA <knu@iDaemons.org>

FreeBSD                         August 11, 2001                        FreeBSD

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT | FILES | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=portsclean&manpath=FreeBSD+5.2-RELEASE+and+Ports>

home | help