NAME
clean-old-distfiles —
remove obsolete ports
distfiles
SYNOPSIS
clean-old-distfiles |
[-nv] [-e
except] [-h
history] [timestamp] |
DESCRIPTION
Each time dpb(1) is run for a full scan of the ports(7) tree, it appends to the history log, listing files in the distfiles directory that are not, or no longer, needed for building the complete tree. It can also be run solely for that purpose, by using:
When clean-old-distfiles is run later, it
uses the information from the history log to delete unneeded files. When a
file is deleted, the corresponding entry is also deleted from the history
log.
By default, clean-old-distfiles deletes
all files listed in the history log. If a timestamp is
given, it is interpreted as a number of seconds since the Epoch, similar to
the date(1) -r argument, and only those files are
deleted that were recorded as obsolete at that time or earlier.
For normal files, clean-old-distfiles
verifies sha256(1) checksums prior to removal. It also removes links
under by_cipher/sha256, but it trusts that the
checksums for these are accurate.
Options are as follows:
-eexcept- Read exception list from file except. Each line is the name of a file that shouldn't be removed.
-hhistory- Read log from history file history instead of the
default /usr/ports/distfiles/history. Turns on
-nv, as this is a testing option. -n- Don't really remove files.
-v- Display what will be removed, as ‘
rm file’ lines.
FILES
- /usr/ports
- base of the ports tree, can be overridden with env variable
PORTSDIR. - /usr/ports/distfiles
- location of the distfiles repository, can be overridden with env variable
DISTDIR. - /usr/ports/distfiles/history
- log of obsolete distfiles.