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

FreeBSD Manual Pages

  
 
  

home | help
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 in-
     stalled, 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

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | NOTES | EXAMPLES | EXIT CODES | COMPATIBILITY | SEE ALSO | HISTORY | AUTHOR

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

home | help