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

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
FREEBSD-UPDATE.CONF(5)	  FreeBSD File Formats Manual	FREEBSD-UPDATE.CONF(5)

NAME
     freebsd-update.conf -- configuration file for freebsd-update(8)

DESCRIPTION
     The freebsd-update.conf file controls the behaviour of the
     freebsd-update(8) utility.	 The file contains lines consisting of a case-
     sensitive option name and zero or more parameters.	 Empty lines and any
     part of a line following a	`#' character are ignored.  Unless stated oth-
     erwise, specifying	an option multiple times is an error.

     The possible options and their meanings are as follows:

     KeyPrint		   The single parameter	following this keyword is the
			   SHA256 hash of the RSA key which will be trusted to
			   sign	updates.

     ServerName		   The single parameter	following this keyword is the
			   name	of the server or server	pool from which
			   updates will	be downloaded.

     Components		   The parameters following this keyword are the com-
			   ponents or sub-components of	FreeBSD	which will be
			   updated.  The components are	``src''	(source	code),
			   ``world'' (non-kernel binaries), and	``kernel'';
			   the sub-components are the individual distribution
			   sets	generated as part of the release process
			   (e.g., ``src/base'',	``src/sys'', ``world/base'',
			   ``world/catpages'', ``kernel/smp'').	 Note that
			   prior to FreeBSD 6.1, the ``kernel''	component was
			   distributed as part of ``world/base''.

			   This	option can be specified	multiple times,	and
			   the parameters accumulate.

     IgnorePaths	   The parameters following this keyword are regular
			   expressions;	updates	to paths which start with a
			   string matching one of these	regular	expressions
			   will	be ignored.

			   This	option can be specified	multiple times,	and
			   the parameters accumulate.

     UpdateIfUnmodified	   The parameters following this keyword are regular
			   expressions;	updates	to paths which start with a
			   string matching one of these	regular	expressions
			   will	be ignored if the files	have been modified
			   locally (unless they	are merged -- see MergeChanges
			   below).

			   This	option can be specified	multiple times,	and
			   the parameters accumulate.

     MergeChanges	   The parameters following this keyword are regular
			   expressions;	updates	to paths which start with a
			   string matching one of these	regular	expressions
			   will	be merged with local modifications.

			   This	option can be specified	multiple times,	and
			   the parameters accumulate.

     WorkDir		   The single parameter	following this keyword is the
			   directory in	which temporary	files and downloaded
			   updates will	be stored.

     MailTo		   The single parameter	following this keyword is the
			   address to which cron output	will be	mailed.

     AllowAdd		   The single parameter	following this keyword must be
			   ``yes'' or ``no'' and specifies whether
			   freebsd-update is allowed to	create new files,
			   directories,	and symlinks if	these are part of
			   updates downloaded.	Note that freebsd-update will
			   not re-add files which have been deleted from a
			   FreeBSD installation	unless those files were	previ-
			   ously added as part of an update.

     AllowDelete	   The single parameter	following this keyword must be
			   ``yes'' or ``no'' and specifies whether
			   freebsd-update is allowed to	delete files, directo-
			   ries, and symlinks as part of updates downloaded.

     KeepModifiedMetadata  The single parameter	following this keyword must be
			   ``yes'' or ``no'' and specifies whether
			   freebsd-update should keep existing file ownership,
			   permissions,	and flags when installing updates if
			   these have been modified locally.

     StrictComponents	   The single parameter	following this keyword must be
			   ``yes'' or ``no'' and specifies whether
			   freebsd-update should interpret the list of compo-
			   nents of FreeBSD specified via the Components
			   option strictly as a	list of	components installed
			   which should	be upgraded when the upgrade command
			   is used ("yes"), or merely as a list	of components
			   which might be installed, of	which freebsd-update
			   should identify which in fact are present ("no").

FILES
     /etc/freebsd-update.conf  Default location	of the freebsd-update configu-
			       ration file.

SEE ALSO
     sha256(1),	freebsd-update(8)

AUTHORS
     Colin Percival <cperciva@FreeBSD.org>

FreeBSD				August 30, 2006			       FreeBSD

NAME | DESCRIPTION | FILES | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=freebsd-update.conf&sektion=5&manpath=FreeBSD+7.0-RELEASE>

home | help