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
     otherwise, 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
                           components 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
                           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 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
                           components 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
                               configuration 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