DragonFly On-Line Manual Pages
FIND-UPDATED(1) User Contributed Perl Documentation FIND-UPDATED(1)
NAME
find-updated -- generate a list of those ports depending on files that
have been modified at a time different to the time stored in the cache.
SYNOPSIS
find-updated [-hvq] [-c dir] [-C file] [-T file] [-p dir] [-o file]
DESCRIPTION
find-updated scans through all of the file-objects stored in the cache,
the whole ports tree and checks the modification time of each of them,
comparing the last modification time as reported from the filesystem
with the last modification time recorded in the cache when cache-init
or cache-update was run.
It prints out a list of ports whose INDEX entries might have been
affected by modifications to those files. The usual exemptions for
ubiquitous (used by every port) and endemic (change unlikely to affect
the INDEX) makefiles apply.
Ports being added or removed show up as modifications to the category
makefile: find-updated does not currently attempt to display the
portnames for new additions, but deletions will appear.
Configuration Files
find-updated shares configuration files with portindex, portdepends
cache-init, cache-update and make-readmes. Any configuration settings
are taken from the following locations, where the later items on this
list override the earlier:
o Built-in settings from the FreeBSD::Portindex::Config perl
module.
o The system wide configuration file /usr/local/etc/portindex.cfg
o The per-user configuration file ${HOME}/.portindexrc. This
file is ignored if the process is run as root.
o The local configuration file, found in the current working
directory of the cache-init process ./.portindexrc. This file
is ignored if the process is run as root.
o The program command line.
All of the configuration files are optional. A summary of the
resultant configuration options including the effect of any command
line settings is printed as part of the help text when portindex is
invoked with the "-h" option.
OPTIONS
-h
--help Print a brief usage message and a summary of the configuration
settings after command line processing and then exit.
-v
--verbose
Turn on verbose output printed to "STDERR". This is the
default.
-q
--quiet
--noverbose
Turn off verbose output to "STDERR". Using both the -v amd -q
options together does not make any sense, but neither does it
generate an error. The last mentioned of the two options will
prevail.
-c dir
--cache-dir=dir
The location of the portindex data cache, by default
/var/db/portindex.
-C file
--cache-file=file
Berkeley DB Btree file containing the cached and post-processed
values of a number of "make" variables for all of the ports in
the tree. This file name will be relative to the cache
directory (-c option above) unless an absolute path is given.
Defaults to portindex-cache.db.
-T file
--timestamp-file=file
A file within the cache directory whose modification time marks
the last time that data was modified in or added to the cache.
Defaults to portindex-timestamp
-o file
--output=file
Filename to write the generated list of updated ports to.
Setting this to - means output to STDOUT, which is the default.
FILES
/usr/ports The default ports directory.
/var/db/portindex
The location of the data cache.
portindex-cache.db
Btree file containing cached "make describe" output.
__db.001, __db.002, __db.003, __db.004
Files used as part of the internal workings of
BerkeleyDB, for memory pool management and DB locking.
Will be recreated automatically if deleted.
portindex-timestamp
This file contains the last time and date that the
cache was updated or modified.
/usr/local/etc/portindex.cfg
System-wide configuration file.
${HOME}/.portindexrc
Per-user configuration file
./.portindexrc Local configuration file
SEE ALSO
portindex(1), cache-init(1), cache-update(1), cvsup(1), ports(7)
BUGS
find-updated does not automatically discover either new ports, or newly
created makefiles except for the files created when port options are
defined.
perl v5.20.2 2012-02-22 FIND-UPDATED(1)