Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   44335 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

DISTVIPER(1)		  BSD General Commands Manual		  DISTVIPER(1)

NAME
     distviper — wipe outdated files from the FreeBSD ports distdir

SYNOPSIS
     distviper [-dhiqv] [mode]

DESCRIPTION
     The distviper script removes outdated files in %%DISTDIR%%. To achieve
     this it reads all files named distinfo from %%PORTS%% and creates a list
     of files to keep if they should be encountered. Every file not in this
     list is deleted.

     The creation of the list of files to keep can take very long, if the
     ports tree is not cached in memory. Because of this there is a fast mode
     that will only use distinfo files from installed ports.

OPTIONS
     The following options are available:

     -d --demo
	     The program is run in demo mode. The program acts as if it would
	     operate normally, but does not remove any files.

     -h --help
	     Displays the available options.

     -i --interactvie
	     This option prompts for confirmation before deleting a file.  It
	     is ignored in demo mode.

     -q --quiet
	     Supresses delete messages.

     -v --verbose
	     Makes the script talkative about what is currently going on.

     mode    There are currently two modes available. By default the thorough
	     mode is selected, which scans all distinfo files. The fast mode
	     only scans distinfo files for installed ports.

NOTES
     The fast mode is often sufficient. There are two cases when this does not
     apply.

     If one intends to keep distfiles for ports that are not currently
     installed, like on a dedicated build machine, the (default) thorough mode
     is the mode of choice.

     The other case is, when a port fetches its files by having a dependency
     on the fetch target of another port and this other port is not installed.
     This is a very rare case, though.

EXAMPLES
     To run the script in thorough mode use the following command line.

	   distviper

     The demo mode can be used to check which files would be removed in fast
     mode.

	   distviper -d fast

     To be prompted for confirmation and using fast mode the following line
     can be used.

	   distviper -i fast

EXIT CODES
     1	     An unknown parameter has been supplied.

     2	     An unknown mode command has been supplied.

     3	     More than one mode commands have been supplied.

COMPATIBILITY
     The script has been tested on FreeBSD 7.2-PRERELEASE.

SEE ALSO
     bsdadminscripts(1)

HISTORY
     The distviper script first appeared in the bsdadminscripts-5.0 collec‐
     tion.

AUTHOR
     Dominic Fandrey <kamikaze@bsdforen.de>

BSD				April 23, 2009				   BSD

Vote for polarhome