.TH "UPGRADE\-SYSTEM.CONF" "5" "2004-03-31" "http://q-funk.iki.fi" "Debian GNU/Linux"
.SH "NAME"
upgrade\-system.conf \- Configuration file for
.BR upgrade\-system (8) 
.SH "DESCRIPTION"
.BR upgrade\-system.conf 
is the configuration file for the
.BR upgrade\-system (8) 
Debian administration utility. This file specifies command options used
for calling
.BR apt\-get (8)
and
.BR deborphan (1)
within
.BR upgrade\-system (8).
.PP
Lines starting with a hash mark ("#") and empty lines are ignored.
.SH "ENVIRONMENT"
The configuration file may contain any of these environment variables:
.SS CLEANOPTS
This variable selects which one of
.BR autoclean
or
.BR clean
to execute as the
.BR apt\-get (8)
cleaning command. For example:
.PP
CLEANOPTS="clean"
.PP
Consult the
.BR apt\-get (8) 
manual page to check which options are available for any
particular APT version, before setting this variable.
.SS UPGRADEOPTS
This variable specifies which one of
.BR dist-upgrade
or
.BR upgrade
to execute as the
.BR apt\-get (8) 
upgrade command and the command options. For example:
.PP
UPGRADEOPTS="\-\-fix-broken \-\-purge \-\-show-upgraded dist-upgrade"
.PP
Consult the
.BR apt\-get (8) 
manual page to check which options are available for any
particular APT version, before setting this variable.
.SS ORPHANOPTS
This variable specifies
.BR deborphan (1)
command options. For example:
.PP
ORPHANOPTS="\-\-guess\-all \-\-libdevel"
.PP
One should
read the 
.BR deborphan (1)
manual page to check which options are available for
any particular version, before setting this variable.
.SS FLAUSCH
Setting this variable enables various extremely pedantic purge options.
.PP
This variable has no default value.
.PP
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
.BR upgrade\-system.conf 
variables.
.PP
.B sudo FLAUSCH=jawohl upgrade\-system
.SH "FILES" 
Because 
.BR upgrade\-system 
is an APT front-end, all precautions relating to APT configuration
should be observed. Special attention is required to:
.TP
.IR /etc/apt/preferences
.PP
To prevent untested packages from overwriting stable ones, setting
this combination of APT preferences is recommended:
.PP
.RS
.nf
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
.fi
.RE
.PP
This enforces a priority to packages from Stable, yet still allows ones
from Testing, Unstable or Experimental to get installed via appropriate 
.BR apt\-get (8)
options to override the default release.
.SH "NOTES"
In the absence of a configuration file,
.BR upgrade\-system (8)
will take the above environment variable examples as fallback default values.
.SH "BUGS"
Certain combinations of 
.BR deborphan (1)
options purge a dangerous quantity of packages, 
potentially leaving a system in a severely crippled state.
.SH "AUTHORS"
Copyright \(co 2004-2012 Martin\-\['E]ric Racine <martin\-eric.racine@iki.fi>
.br  
Copyright \(co 2004,2012 Christoph Schindler <hop@30hopsmax.at>
.br
Copyright \(co 2003-2004 Martin Zdrahal <martin.zdrahal@konflux.at>
.SH "LICENSE"
GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl.html>.
.SH "SEE ALSO"
.BR apt\-get (8),
.BR apt_preferences (5), 
.BR deborphan (1),
.BR upgrade\-system (8).