Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
FIND-UPDATED(1)	      User Contributed Perl Documentation      FIND-UPDATED(1)

       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.

       find-updated [-hvq] [-c dir] [-C	file] [-T file]	[-p dir] [-o file]

       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

       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.

       --help  Print a brief usage message and a summary of the	configuration
	       settings	after command line processing and then exit.

	       Turn on verbose output printed to "STDERR".  This is the

	       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

       -c dir
	       The location of the portindex data cache, by default

       -C 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
	       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
	       Filename	to write the generated list of updated ports to.
	       Setting this to - means output to STDOUT, which is the default.

       /usr/ports      The default ports directory.

		       The location of the data	cache.

		       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.

		       This file contains the last time	and date that the
		       cache was updated or modified.

		       System-wide configuration file.

		       Per-user	configuration file

       ./.portindexrc  Local configuration file

       portindex(1), cache-init(1), cache-update(1), cvsup(1), ports(7)

       find-updated does not automatically discover either new ports, or newly
       created makefiles except	for the	files created when port	options	are

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


Want to link to this manual page? Use this URL:

home | help