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	refer-
		      enced by any port	 that  is  currently  installed.  (cf.
		      DISTDIR)

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

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

		      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 un-
		      needed libraries too.

		      You can use the sysutils/libchk port to check which  li-
		      brary 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 di-
		      rectory.

       -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 con-
		      figuration	file	    $PREFIX/etc/pkgtools.conf,
		      /etc/make.conf  or  environment variables	to clean files
		      properly.	 See portupgrade(1) for	details	of these vari-
		      ables.

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

FILES
       $PREFIX/etc/pkgtools.conf  Default  location of the pkgtools configura-
				  tion 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+14.3-RELEASE+and+Ports>

home | help