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
125 Proxy "ftp://127.0.0.1/";
126 Proxy::http.us.debian.org "DIRECT"; // Specific per-host setting
128 /* Required script to perform proxy login. This example should work
132 "USER $(PROXY_USER)";
133 "PASS $(PROXY_PASS)";
134 "USER $(SITE_USER)@$(SITE):$(SITE_PORT)";
140 /* Passive mode control, proxy, non-proxy and per-host. Pasv mode
141 is prefered if possible */
143 Proxy::Passive "true";
144 Passive::http.us.debian.org "true"; // Specific per-host setting
151 // You need the trailing slash!
161 Options {"--ignore-time-conflict";} // not very usefull on a normal system
168 // Location of the state dir
173 userstatus "status.user";
174 status "/var/lib/dpkg/status";
175 cdroms "cdroms.list";
178 // Location of the cache dir
179 Cache "var/cache/apt/" {
180 Archives "archives/";
181 srcpkgcache "srcpkgcache.bin";
182 pkgcache "pkgcache.bin";
187 SourceList "sources.list";
189 Preferences "preferences";
193 // Locations of binaries
195 methods "/usr/lib/apt/methods/";
198 dpkg "/usr/bin/dpkg";
199 dpkg-source "/usr/bin/dpkg-source";
200 dpkg-buildpackage "/usr/bin/dpkg-buildpackage";
201 apt-get "/usr/bin/apt-get";
202 apt-cache "/usr/bin/apt-cache";
206 // Things that effect the APT dselect method
209 Clean "auto"; // always|auto|prompt|never
212 PromptAfterUpdate "no";
218 // Probably don't want to use force-downgrade..
219 Options {"--force-overwrite";"--force-downgrade";}
221 // Auto re-mounting of a readonly /usr
222 Pre-Invoke {"mount -o remount,rw /usr";};
223 Post-Invoke {"mount -o remount,ro /usr";};
225 // Prevents daemons from getting cwd as something mountable (default)
228 // Build options for apt-get source --compile
229 Build-Options "-b -uc";
231 // Pre-configure all packages before they are installed using debconf.
232 Pre-Install-Pkgs {"dpkg-preconfigure --apt --priority=low --frontend=dialog";};
234 // Flush the contents of stdin before forking dpkg.
237 // Control the size of the command line passed to dpkg.
242 /* Options you can set to see some debugging text They correspond to names
243 of classes in the source code */
246 pkgProblemResolver "false";
247 pkgDepCache::AutoInstall "false"; // what packages apt install to satify dependencies
249 pkgAcquire::Worker "false";
250 pkgAcquire::Auth "false";
252 pkgDPkgProgressReporting "false";
253 pkgOrderList "false";
256 pkgInitialize "false"; // This one will dump the configuration space
258 Acquire::Ftp "false"; // Show ftp command traffic
259 Acquire::Http "false"; // Show http command traffic
260 Acquire::gpgv "false"; // Show the gpgv traffic
261 aptcdrom "false"; // Show found package files
266 /* Whatever you do, do not use this configuration file!! Take out ONLY
267 the portions you need! */
268 This Is Not A Valid Config File