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

FreeBSD Manual Pages

  
 
  

home | help
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.32.1			  2015-10-18		       FIND-UPDATED(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | FILES | SEE ALSO | BUGS

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=find-updated&sektion=1&manpath=FreeBSD+13.1-RELEASE+and+Ports>

home | help