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.

                           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.

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

SEE ALSO
     freebsd-update(8) sha256(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+6.2-RELEASE>

home | help