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

FreeBSD Manual Pages

  
 
  

home | help
PORTSCLEAN(1)		     General Commands Manual		   PORTSCLEAN(1)

NAME
     portsclean -- a tool to clean ports/packages garbage

SYNOPSIS
     portsclean [-hCDDiLnPPQQq]

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 (i.e.
		    -QQ), 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 configura-
		    tion file $PREFIX/etc/pkgtools.conf, /etc/make.conf or envi-
		    ronment variables to  clean  files	properly.   See  portup-
		    grade(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 			  June 13, 2006 		   PORTSCLEAN(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=portsclean&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help