Provided by: upgrade-system_1.6.1.0_all bug

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 © 2003-2004 Martin Zdrahal <martin.zdrahal@konflux.at>
       Copyright © 2004,2012 Christoph Schindler <hop@30hopsmax.at>
       Copyright © 2004-2012 Martin-Éric 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).