NAME

upgrade.conf — upgrade configuration

SYNOPSIS

DESCRIPTION

upgrade.conf controls the actions taken by sysupgrade(8) during a system upgrade as described in upgrade(7). The file allows customizing whether the new source code is installed and what happens to the old source code. It also records information about the system such as how the system is booted. The file is created automatically by sysinstall(8) as part of installation(7) to match what was installed.

Developers may wish to customize what happens to /src on a system upgrade. The new source code can be installed or not. If it is installed, it can be installed in /newsrc or by default in /src. Any existing source code will be safely moved inside a subdirectory of /oldsrc.

FORMAT

The file is read line by line. The # character starts a comment and the rest of the line is ignored. Lines are supposed to contain assignments to variables. An assignment is the name of the variable, whitespace, an equal character, whitespace, the value, whitespace, and then the end of the line.

grub=[no | yes] (default no)

States GRUB is used as the bootloader. If so, then the bootloader is reinstalled (grub-install(8)) and updated (update-grub(8)).

newsrc=[no | yes] (default no)

Place the new source code in /newsrc and move any existing /newsrc into /oldsrc. This preserves the current /src directory. This takes precedence over and disables the behavior described under src.

src=[no | yes] (default no)

Place the new source code in /src and move any existing /src into /oldsrc.

The defaults will be used if /etc/upgrade.conf is missing.

FILES

/etc/upgrade.conf

Upgrade configuration.

EXAMPLES

grub = yes
src = no

SEE ALSO

autoinstall.conf(5), autoupgrade.conf(5), upgrade(7), sysupgrade(8)