DragonFly On-Line Manual Pages

DISTVIPER(1)           DragonFly 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
     collection.

AUTHOR
     Dominic Fandrey <kamikaze@bsdforen.de>

DragonFly 6.5-DEVELOPMENT       April 23, 2009       DragonFly 6.5-DEVELOPMENT