1 // $Id: configure-index,v 1.10 2004/07/17 19:37:16 mdz Exp $
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 (except for the
4 last line) a completely valid file. Most of the options have sane default
5 values, unless you have specific needs you should NOT include arbitary
6 items in a custom configuration.
8 In some instances involving filenames it is possible to set the default
9 directory when the path is evaluated. This means you can use relative
10 paths within the sub scope.
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.
22 // Options for APT in general
26 Build-Essential "build-essential";
28 // Options for apt-get
32 Download-Only "false";
35 Force-Yes "false"; // I would never set this.
38 Show-Upgraded "false";
39 Show-Versions "false";
59 RecurseDepends "false";
77 TrustCDROM "false"; // consider the CDROM always trusted
82 TrustedKeyring "/etc/apt/trusted.gpg";
85 // Some general options
87 Clean-Installed "true";
88 Immediate-Configure "true"; // DO NOT turn this off, see the man page
89 Force-LoopBreak "false"; // DO NOT turn this on, see the man page
90 Cache-Limit "4194304";
94 // Write progress messages on this fd (for stuff like base-config)
96 // Keep the list of FDs open (normally apt closes all fds when it
101 // Options for the downloading routines
104 Queue-Mode "host"; // host|access
106 Source-Symlinks "true";
108 // HTTP method configuration
111 Proxy "http://127.0.0.1:3128";
112 Proxy::http.us.debian.org "DIRECT"; // Specific per-host setting
116 // Cache Control. Note these do not work with Squid 2.0.2
118 Max-Age "86400"; // 1 Day age on index files
119 No-Store "false"; // Prevent the cache from storing archives
120 Dl-Limit "7"; // 7Kb/sec maximum download rate
123 // HTTPS method configuration:
124 // - uses the http proxy config
125 // - uses the http cache-control values
126 // - uses the http Dl-Limit values
130 SslCert "/etc/apt/some.pem";
131 CaPath "/etc/ssl/certs";
137 Proxy "ftp://127.0.0.1/";
138 Proxy::http.us.debian.org "DIRECT"; // Specific per-host setting
140 /* Required script to perform proxy login. This example should work
144 "USER $(PROXY_USER)";
145 "PASS $(PROXY_PASS)";
146 "USER $(SITE_USER)@$(SITE):$(SITE_PORT)";
152 /* Passive mode control, proxy, non-proxy and per-host. Pasv mode
153 is prefered if possible */
155 Proxy::Passive "true";
156 Passive::http.us.debian.org "true"; // Specific per-host setting
163 // You need the trailing slash!
173 Options {"--ignore-time-conflict";} // not very usefull on a normal system
180 // Location of the state dir
185 userstatus "status.user";
186 status "/var/lib/dpkg/status";
187 cdroms "cdroms.list";
190 // Location of the cache dir
191 Cache "var/cache/apt/" {
192 Archives "archives/";
193 srcpkgcache "srcpkgcache.bin";
194 pkgcache "pkgcache.bin";
199 SourceList "sources.list";
201 Preferences "preferences";
205 // Locations of binaries
207 methods "/usr/lib/apt/methods/";
210 dpkg "/usr/bin/dpkg";
211 dpkg-source "/usr/bin/dpkg-source";
212 dpkg-buildpackage "/usr/bin/dpkg-buildpackage";
213 apt-get "/usr/bin/apt-get";
214 apt-cache "/usr/bin/apt-cache";
218 // Things that effect the APT dselect method
221 Clean "auto"; // always|auto|prompt|never
224 PromptAfterUpdate "no";
230 // Probably don't want to use force-downgrade..
231 Options {"--force-overwrite";"--force-downgrade";}
233 // Auto re-mounting of a readonly /usr
234 Pre-Invoke {"mount -o remount,rw /usr";};
235 Post-Invoke {"mount -o remount,ro /usr";};
237 // Prevents daemons from getting cwd as something mountable (default)
240 // Build options for apt-get source --compile
241 Build-Options "-b -uc";
243 // Pre-configure all packages before they are installed using debconf.
244 Pre-Install-Pkgs {"dpkg-preconfigure --apt --priority=low --frontend=dialog";};
246 // Flush the contents of stdin before forking dpkg.
249 // Control the size of the command line passed to dpkg.
253 // controls if apt will apport on the first dpkg error or if it
254 // tries to install as many packages as possible
258 /* Options you can set to see some debugging text They correspond to names
259 of classes in the source code */
262 pkgProblemResolver "false";
263 pkgDepCache::AutoInstall "false"; // what packages apt install to satify dependencies
265 pkgAcquire::Worker "false";
266 pkgAcquire::Auth "false";
268 pkgDPkgProgressReporting "false";
269 pkgOrderList "false";
272 pkgInitialize "false"; // This one will dump the configuration space
274 Acquire::Ftp "false"; // Show ftp command traffic
275 Acquire::Http "false"; // Show http command traffic
276 Acquire::Https "false"; // Show https debug
277 Acquire::gpgv "false"; // Show the gpgv traffic
278 aptcdrom "false"; // Show found package files
283 /* Whatever you do, do not use this configuration file!! Take out ONLY
284 the portions you need! */
285 This Is Not A Valid Config File