]> git.saurik.com Git - apt.git/blame - doc/examples/apt.conf
Fixed string case compare problem
[apt.git] / doc / examples / apt.conf
CommitLineData
83ab33fc 1// $Id: apt.conf,v 1.42 1999/10/31 06:32:28 jgg Exp $
0a8e3465
AL
2/* This file is an index of all APT configuration directives. It should
3 NOT actually be used as a real config file, though it is a completely
648e3cb4
AL
4 valid file. Most of the options have sane default values, unless
5 you have specific needs you should NOT include arbitary items in a custom
6 configuration.
93bf083d 7
6dd55be7 8 In some instances involving filenames it is possible to set the default
93bf083d
AL
9 directory when the path is evaluated. This means you can use relative
10 paths within the sub scope.
11
12 The configuration directives are specified in a tree with {} designating
13 a subscope relative to the tag before the {}. You can further specify
14 a subscope using scope notation eg,
15 APT::Architecture "i386";
16 This is prefixed with the current scope. Scope notation must be used
17 if an option is specified on the command line with -o.
0a8e3465
AL
18*/
19
93bf083d 20// Options for APT in general
78b558ca
AL
21APT
22{
0a8e3465
AL
23 Architecture "i386";
24
93bf083d 25 // Options for apt-get
78b558ca
AL
26 Get
27 {
0a8e3465
AL
28 Download-Only "false";
29 Simulate "false";
30 Assume-Yes "false";
78b558ca 31 Force-Yes "false"; // I would never set this.
0a8e3465 32 Fix-Broken "false";
30e1eab5 33 Fix-Missing "false";
0a8e3465 34 Show-Upgraded "false";
3d8fd174 35 No-Upgrade "false";
7d8afa39 36 Print-URIs "false";
fb0ee66e 37 Compile "false";
ab559b35 38 No-Download "false";
9df71a5b
AL
39 Purge "false";
40 List-Cleanup "true";
d150b09d
AL
41 ReInstall "false";
42 Trivial-Only "false";
43 No-Remove "false";
3d8fd174
AL
44 };
45
78b558ca
AL
46 Cache
47 {
3d8fd174 48 Important "false";
648e3cb4 49 AllVersions "false";
0a8e3465 50 };
78b558ca
AL
51
52 CDROM
53 {
3d8fd174
AL
54 Rename "false";
55 NoMount "false";
56 Fast "false";
57 NoAct "false";
58 };
59
93bf083d 60 // Some general options
2e90f6e0 61 Ignore-Hold "false";
c98b1307 62 Clean-Installed "true";
78b558ca 63 Immediate-Configure "true"; // DO NOT turn this off, see the man page
9d4c8f67 64 Force-LoopBreak "false"; // DO NOT turn this on, see the man page
67db871e 65 Cache-Limit "4194304";
0a8e3465
AL
66};
67
93bf083d 68// Options for the downloading routines
0a8a80e5
AL
69Acquire
70{
769f7e1a 71 Queue-Mode "host"; // host|access
2b154e53 72 Retries "0";
917ae805 73 Source-Symlinks "true";
22380cf2 74
c3c459fc
AL
75 // HTTP method configuration
76 http
22380cf2
AL
77 {
78 Proxy "http://127.0.0.1:3128";
c3c459fc 79 Proxy::http.us.debian.org "DIRECT"; // Specific per-host setting
2b154e53 80 Timeout "120";
83ab33fc 81 Pipeline-Depth "5";
5c2cb6e4
AL
82
83 // Cache Control. Note these do not work with Squid 2.0.2
84 No-Cache "false";
85 Max-Age "86400"; // 1 Day age on index files
86 No-Store "false"; // Prevent the cache from storing archives
c3c459fc 87 };
6d5dd02a
AL
88
89 ftp
90 {
91 Proxy "ftp://127.0.0.1/";
92 Proxy::http.us.debian.org "DIRECT"; // Specific per-host setting
93
78b558ca
AL
94 /* Required script to perform proxy login. This example should work
95 for tisfwtk */
6d5dd02a
AL
96 ProxyLogin
97 {
98 "USER $(PROXY_USER)";
99 "PASS $(PROXY_PASS)";
100 "USER $(SITE_USER)@$(SITE):$(SITE_PORT)";
101 "PASS $(SITE_PASS)";
102 };
103
104 Timeout "120";
78b558ca
AL
105
106 /* Passive mode control, proxy, non-proxy and per-host. Pasv mode
107 is prefered if possible */
6d5dd02a
AL
108 Passive "true";
109 Proxy::Passive "true";
78b558ca 110 Passive::http.us.debian.org "true"; // Specific per-host setting
6d5dd02a 111 };
dcc48266
AL
112
113 cdrom
114 {
6c907975
AL
115 Mount "/cdrom";
116
117 // You need the trailing slash!
118 "/cdrom/"
119 {
120 Mount "sleep 1000";
121 UMount "sleep 500";
122 }
dcc48266 123 };
0a8a80e5
AL
124};
125
93bf083d 126// Directory layout
0a8e3465
AL
127Dir
128{
93bf083d 129 // Location of the state dir
0a8e3465
AL
130 State "/var/state/apt/"
131 {
132 lists "lists/";
133 xstatus "xstatus";
134 userstatus "status.user";
42c90c42
AL
135 status "/var/lib/dpkg/status";
136 cdroms "cdroms.list";
0a8e3465
AL
137 };
138
93bf083d 139 // Location of the cache dir
0a8e3465
AL
140 Cache "/var/cache/apt/" {
141 archives "archives/";
142 srcpkgcache "srcpkgcache.bin";
143 pkgcache "pkgcache.bin";
144 };
145
93bf083d 146 // Config files
0a8e3465 147 Etc "/etc/apt/" {
93bf083d 148 sourcelist "sources.list";
0a8e3465
AL
149 main "apt.conf";
150 };
024835dc 151
93bf083d 152 // Locations of binaries
024835dc 153 Bin {
3d8fd174 154 methods "/usr/lib/apt/methods/";
93bf083d 155 gzip "/bin/gzip";
30e1eab5 156 dpkg "/usr/bin/dpkg";
fb0ee66e
AL
157 dpkg-source "/usr/bin/dpkg-source";
158 dpkg-buildpackage "/usr/bin/dpkg-buildpackage"
7a1b1f8b 159 apt-get "/usr/bin/apt-get";
53697617 160 apt-cache "/usr/bin/apt-cache";
024835dc 161 };
0a8e3465
AL
162};
163
c3c459fc 164// Things that effect the APT dselect method
78b558ca
AL
165DSelect
166{
dcc48266 167 Clean "auto"; // always|auto|prompt|never
7a1b1f8b
AL
168 Options "-f";
169 UpdateOptions "";
c217f42a 170 PromptAfterUpdate "no";
0a8e3465
AL
171}
172
78b558ca
AL
173DPkg
174{
648e3cb4
AL
175 // Probably don't want to use force-downgrade..
176 Options {"--force-overwrite";"--force-downgrade";}
78b558ca
AL
177
178 // Auto re-mounting of a readonly /usr
6dd55be7
AL
179 Pre-Invoke {"mount -o remount,rw /usr";};
180 Post-Invoke {"mount -o remount,ro /usr";};
78b558ca
AL
181
182 // Prevents daemons from getting cwd as something mountable (default)
87b11230 183 Run-Directory "/";
fb0ee66e
AL
184
185 // Build options for apt-get source --compile
186 Build-Options "-b -uc";
06b8cce6
AL
187
188 // Pre-configure all packages before they are installed using debconf.
189 Pre-Install-Pkgs {"dpkg-preconfig --apt --priority=low --frontend=dialog";};
6dd55be7
AL
190}
191
93bf083d
AL
192/* Options you can set to see some debugging text They corrispond to names
193 of classes in the source code */
78b558ca
AL
194Debug
195{
93bf083d 196 pkgProblemResolver "false";
0a8a80e5 197 pkgAcquire "false";
93bf083d 198 pkgAcquire::Worker "false";
30e1eab5 199 pkgDPkgPM "false";
93bf083d
AL
200
201 pkgInitialize "false"; // This one will dump the configuration space
78b558ca
AL
202 NoLocking "false";
203 Acquire::Ftp "false"; // Show ftp command traffic
c98b1307 204 Acquire::Http "false"; // Show http command traffic
6c907975 205 aptcdrom "false"; // Show found package files
0a8e3465 206}
c98b1307
AL
207
208/* Whatever you do, do not use this configuration file!! Take out ONLY
209 the portions you need */
648e3cb4 210This Is Not A Valid Config File