freebsd-update.conf
- configuration file for
freebsd-update8
DESCRIPTION
The
file controls the behaviour of the
freebsd-update8
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
Fx 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
Fx 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.
IDSIgnorePaths
The parameters following this keyword are regular expressions;
paths which start with a string matching one of these regular
expressions will be ignored by "freebsd-update IDS".
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
Fx 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
Fx 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.
