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

FreeBSD Manual Pages

  
 
  

home | help
FREEBSD-UPDATE.CONF(5)	    BSD	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	up-
			   dates 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 distrib-
			   uted	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 lo-
			   cally (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 previously 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, directories, and	sym-
			   links 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	components of FreeBSD
			   specified via the Components	option strictly	as a
			   list	of components installed	which should be	up-
			   graded when the upgrade command is used ("yes"), or
			   merely as a list of components which	might be in-
			   stalled, 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:
<https://www.freebsd.org/cgi/man.cgi?query=freebsd-update.conf&sektion=5&manpath=FreeBSD+6.3-RELEASE>

home | help