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  -  FIND-UPDATED (1)

.ds Aq ’

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.

CONTENTS

SYNOPSIS

<B>find-updatedB> [<B>-hvqB>] [<B>-cB> dir] [<B>-CB> file] [<B>-TB> file] [<B>-pB> dir] [<B>-oB> file]

DESCRIPTION

<B>find-updatedB> 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 <B>cache-initB> or <B>cache-updateB> 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: <B>find-updatedB> does not currently attempt to display the portnames for new additions, but deletions will appear.

    Configuration Files

<B>find-updatedB> shares configuration files with <B>portindexB>, <B>portdependsB> <B>cache-initB>, <B>cache-updateB> and <B>make-readmesB>. 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 <B>FreeBSD::Portindex::ConfigB> 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 <B>cache-initB> 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 <B>portindexB> is invoked with the -h option.

OPTIONS

<B>-hB>
<B>--helpB> Print a brief usage message and a summary of the configuration settings after command line processing and then exit.
<B>-vB>
<B>--verboseB> Turn on verbose output printed to STDERR. This is the default.
<B>-qB>
<B>--quietB>
<B>--noverboseB> Turn off verbose output to STDERR. Using both the <B>-vB> amd <B>-qB> options together does not make any sense, but neither does it generate an error. The last mentioned of the two options will prevail.
<B>-cB> dir
<B>--cache-dirB>=dir The location of the <B>portindexB> data cache, by default /var/db/portindex.
<B>-CB> file
<B>--cache-fileB>=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 (<B>-cB> option above) unless an absolute path is given. Defaults to portindex-cache.db.
<B>-TB> file
<B>--timestamp-fileB>=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
<B>-oB> file
<B>--outputB>=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

<B>find-updatedB> does not automatically discover either new ports, or newly created makefiles except for the files created when port options are defined.
Search for    or go to Top of page |  Section 1 |  Main Index


perl v5.20.3 FIND-UPDATED (1) 2015-10-18

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