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

AUTHORS
       Dominic Fandrey <freebsd@k4m1.org>

FreeBSD	Ports 14.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+14.3.quarterly>

home | help