GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  DISTVIPER (1)

NAME

distviper - wipe outdated files from the FreeBSD ports distdir

CONTENTS

Synopsis
Description
Options
Notes
Examples
Exit Codes
Compatibility
See Also
History
Author

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>
Search for    or go to Top of page |  Section 1 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.