Provided by:
upgrade-system_1.6.1.0_all 
NAME
upgrade-system.conf - Configuration file for upgrade-system(8)
DESCRIPTION
upgrade-system.conf is the configuration file for the upgrade-system(8)
Debian administration utility. This file specifies command options used
for calling apt-get(8) and deborphan(1) within upgrade-system(8).
Lines starting with a hash mark ("#") and empty lines are ignored.
EXAMPLE
The configuration file contains four variables:
CLEANOPTS
This variable selects which one of autoclean or clean to execute as the
apt-get(8) cleaning command. For example:
CLEANOPTS="clean"
Consult the apt-get(8) manual page to check which options are available
for any particular APT version, before setting this variable.
UPGRADEOPTS
This variable specifies which one of dist-upgrade or upgrade to execute
as the apt-get(8) upgrade command and the command options. For example:
UPGRADEOPTS="-f -u dist-upgrade"
Consult the apt-get(8) manual page to check which options are available
for any particular APT version, before setting this variable.
ORPHANOPTS
This variable specifies deborphan(1) command options. For example:
ORPHANOPTS="--guess-all --libdevel --priority=2"
One should read the deborphan(1) manual page to check which options are
available for any particular version, before setting this variable.
FLAUSCH
Setting this variable enables various extremely pedantic purge options.
This feature is totally experimental; usage is strongly discouraged and
should only be attempted by truly experienced Debian administrators. It
can be used to sanitize a Debian system after a distribution upgrade or
to detect packages that don't conform to the Debian Policy. Setting the
variable as a command line environment, only when needed, is considered
a safer approach than adding it to upgrade-system.conf variables.
SECURITY
Because upgrade-system is an APT front-end, all precautions relating to
APT configuration should be observed. Special attention is required to:
deborphan
Certain combinations of deborphan(1) options purge a dangerous quantity
of packages, potentially leaving a system in a severely crippled state.
/etc/apt/preferences
To prevent untested packages from overwriting stable ones, setting this
combination of APT preferences is recommended:
Package: *
Pin: release a=stable
Pin-Priority: 990
Package: *
Pin: release a=testing
Pin-Priority: 500
Package: *
Pin: release a=unstable
Pin-Priority: 100
Package: *
Pin: release a=experimental
Pin-Priority: 1
This enforces a priority to packages from Stable, yet still allows ones
from Testing, Unstable or Experimental to get installed via appropriate
apt-get(8) options to override the default release.
AUTHORS
Copyright (C) 2003-2004 Martin Zdrahal <martin.zdrahal@konflux.at>
Copyright (C) 2004,2012 Christoph Schindler <hop@30hopsmax.at>
Copyright (C) 2004-2012 Martin-Eric Racine <martin-eric.racine@iki.fi>
LICENSE
GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl.html>.
SEE ALSO
apt-get(8), apt_preferences(5), deborphan(1), upgrade-system(8).