UPGRADE.CONF(5)

NAME
upgrade.conf - upgrade configuration

SYNOPSIS
/etc/upgrade.conf

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)