1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
|
.TH "UPGRADE\-SYSTEM.CONF" "5" "March 31st 2004" "http://funkyware.konflux.at/" "Debian GNU/Linux"
.SH "NAME"
upgrade\-system.conf \-
.BR upgrade\-system (8)
configuration file
.SH "DESCRIPTION"
.BR upgrade\-system.conf
is the configuration file for the
.BR upgrade\-system (8)
which upgrades Debian systems. This file specifies options to be passed to
.BR apt\-get (8)
and
.BR deborphan (1).
.PP
Lines starting with a hash mark ("#") and empty lines are ignored.
.SH "EXAMPLE"
The configuration file contains three variables:
.SS CLEANOPTS
This variable is used to pass the command line option to
.BR apt\-get (8),
to determine whether the
.BR autoclean
or
.BR clean
action will be performed. For example:
.PP
CLEANOPTS="clean"
.PP
Consult the
.BR apt\-get (8)
manual page to check which options are available for
any particular version, before setting this variable.
.SS UPGRADEOPTS
This variable is used to pass command line options to
.BR apt\-get (8)
and to determine whether the
.BR dist-upgrade
or
.BR upgrade
action will be performed. For example:
.PP
UPGRADEOPTS="-yu dist-upgrade"
.PP
Consult the
.BR apt\-get (8)
manual page to check which options are available for
any particular version, before setting this variable.
.SS ORPHANOPTS
This variable is used to pass command line options to
.BR deborphan (1).
.PP
On Woody, the version available (1.0-3) is so desperately
crippled that it might be preferable to leave this variable empty:
.PP
ORPHANOPTS=""
.PP
Since Sarge, precise control of orphaning is
possible, which makes this variable extremely useful. For example:
.PP
ORPHANOPTS="--find-config --guess-doc --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.
.SH "SECURITY"
Because
.BR upgrade\-system
is an APT front-end, all precautions relating to APT configuration
should be observed. Special attention is required at:
.SS /etc/apt/preferences
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: 1001
Package: *
Pin: release a=testing
Pin\-Priority: 101
Package: *
Pin: release a=unstable
Pin\-Priority: 99
Package: *
Pin: release a=experimental
Pin\-Priority: 9
.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 "AUTHORS"
Martin Zdrahal <martin.zdrahal@konflux.at> made the original in 2003.
.PP
Martin\-Eric Racine <q\-funk@iki.fi> wrote this manual page, packaged
the Debian archive and added various enhancements in 2004.
.SH "SEE ALSO"
.BR apt\-get (8),
.BR apt_preferences (5),
.BR deborphan (1),
.BR upgrade\-system (8).
|
