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

FreeBSD Manual Pages

  
 
  

home | help
DISTVIPER(8)		FreeBSD	System Manager's Manual		  DISTVIPER(8)

NAME
     distviper -- wipe outdated	files from the FreeBSD ports distdir

SYNOPSIS
     distviper [-dhinqv] [keep]

DESCRIPTION
     The distviper script removes outdated files within	DISTDIR	of the
     ports(7).	To achieve this	it reads distinfo files	from the PORTSDIR and
     creates a list of files to	keep if	they should be encountered.

   ARGUMENTS
     The following argument types can be given.

     keep    Chooses which kind	of files are kept:
	     all, thorough
		     Keep files	required for any port in the ports tree. The
		     thorough alias exists for compatibility with the original
		     bsdadminscripts.
	     installed
		     Keep files	required for any currently installed port.
	     fast    This is the same as calling distviper with	the -n flag
		     and the installed argument. It exists for compatibility
		     with the original bsdadminscripts.

   OPTIONS
     The following options are supported:

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

     -n	--no-checksum
	     Turn off checksum validation for files to keep. Much faster, but
	     also risks	leaving	invalid	files in DISTDIR.

     -q	--quiet
	     Supresses all output except for interactive prompts.

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

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

ENVIRONMENT
     The following environment variables are supported:

     PORTSDIR
	     The location of the ports tree, e.g.  /usr/ports.

     DISTDIR
	     The location of the distribution files, e.g.
	     /usr/ports/distfiles.

     The variables are collected running:

	   make	-f/usr/share/mk/bsd.port.mk -VPORTSDIR -VDISTDIR

EXAMPLES
     Delete any	distfile not referenced	by the current ports tree:

	   distviper

     The demo mode can be used to check	which files would be removed:

	   distviper -d

     Avoid expensive operations, i.e. only keep	files for installed ports and
     do	not perform checksum validation:

	   distviper fast

     Only keep files for installed ports, and ask for confirmation:

	   distviper -i	installed

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.

SEE ALSO
     ports(7)

HISTORY
     The distviper script first	appeared in the	bsdadminscripts-5.0 collec-
     tion. It was rewritten for	the bsda2 collection.

AUTHORS
     Dominic Fandrey <kamikaze@bsdforen.de>

FreeBSD	13.0		       3 December, 2019			  FreeBSD 13.0

NAME | SYNOPSIS | DESCRIPTION | ENVIRONMENT | EXAMPLES | EXIT CODES | SEE ALSO | HISTORY | AUTHORS

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

home | help