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

FreeBSD Manual Pages

  
 
  

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

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

SYNOPSIS
     distviper [-dinqv] [keep]
     distviper -h

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

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  collection.
     It was rewritten for the bsda2 collection.

AUTHORS
     Dominic Fandrey <freebsd@k4m1.org>

FreeBSD ports 15.quarterly	18 November, 2023		    DISTVIPER(8)

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

home | help