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 NeverAutoRemove { "linux-kernel.*"; }; // packages that should never
29 // considered for autoRemove
31 // Options for apt-get
35 AutomaticRemove "false";
36 Download-Only "false";
39 Force-Yes "false"; // I would never set this.
42 Show-Upgraded "false";
43 Show-Versions "false";
63 RecurseDepends "false";
81 TrustCDROM "false"; // consider the CDROM always trusted
86 TrustedKeyring "/etc/apt/trusted.gpg";
89 // Some general options
91 Clean-Installed "true";
92 Immediate-Configure "true"; // DO NOT turn this off, see the man page
93 Force-LoopBreak "false"; // DO NOT turn this on, see the man page
94 Cache-Limit "4194304";
98 // Write progress messages on this fd (for stuff like base-config)
100 // Keep the list of FDs open (normally apt closes all fds when it
105 // Options for the downloading routines
108 Queue-Mode "host"; // host|access
110 Source-Symlinks "true";
112 // HTTP method configuration
115 Proxy "http://127.0.0.1:3128";
116 Proxy::http.us.debian.org "DIRECT"; // Specific per-host setting
120 // Cache Control. Note these do not work with Squid 2.0.2
122 Max-Age "86400"; // 1 Day age on index files
123 No-Store "false"; // Prevent the cache from storing archives
124 Dl-Limit "7"; // 7Kb/sec maximum download rate
129 Proxy "ftp://127.0.0.1/";
130 Proxy::http.us.debian.org "DIRECT"; // Specific per-host setting
132 /* Required script to perform proxy login. This example should work
136 "USER $(PROXY_USER)";
137 "PASS $(PROXY_PASS)";
138 "USER $(SITE_USER)@$(SITE):$(SITE_PORT)";
144 /* Passive mode control, proxy, non-proxy and per-host. Pasv mode
145 is prefered if possible */
147 Proxy::Passive "true";
148 Passive::http.us.debian.org "true"; // Specific per-host setting
155 // You need the trailing slash!
165 Options {"--ignore-time-conflict";} // not very usefull on a normal system
172 // Location of the state dir
177 userstatus "status.user";
178 status "/var/lib/dpkg/status";
179 cdroms "cdroms.list";
182 // Location of the cache dir
183 Cache "var/cache/apt/" {
184 Archives "archives/";
185 srcpkgcache "srcpkgcache.bin";
186 pkgcache "pkgcache.bin";
191 SourceList "sources.list";
193 Preferences "preferences";
197 // Locations of binaries
199 methods "/usr/lib/apt/methods/";
202 dpkg "/usr/bin/dpkg";
203 dpkg-source "/usr/bin/dpkg-source";
204 dpkg-buildpackage "/usr/bin/dpkg-buildpackage";
205 apt-get "/usr/bin/apt-get";
206 apt-cache "/usr/bin/apt-cache";
210 // Things that effect the APT dselect method
213 Clean "auto"; // always|auto|prompt|never
216 PromptAfterUpdate "no";
222 // Probably don't want to use force-downgrade..
223 Options {"--force-overwrite";"--force-downgrade";}
225 // Auto re-mounting of a readonly /usr
226 Pre-Invoke {"mount -o remount,rw /usr";};
227 Post-Invoke {"mount -o remount,ro /usr";};
229 // Prevents daemons from getting cwd as something mountable (default)
232 // Build options for apt-get source --compile
233 Build-Options "-b -uc";
235 // Pre-configure all packages before they are installed using debconf.
236 Pre-Install-Pkgs {"dpkg-preconfigure --apt --priority=low --frontend=dialog";};
238 // Flush the contents of stdin before forking dpkg.
241 // Control the size of the command line passed to dpkg.
246 /* Options you can set to see some debugging text They correspond to names
247 of classes in the source code */
250 pkgProblemResolver "false";
251 pkgDepCache::AutoInstall "false"; // what packages apt install to satify dependencies
253 pkgAcquire::Worker "false";
255 pkgDPkgProgressReporting "false";
256 pkgOrderList "false";
257 pkgAutoRemove "false"; // show information about automatic removes
259 pkgInitialize "false"; // This one will dump the configuration space
261 Acquire::Ftp "false"; // Show ftp command traffic
262 Acquire::Http "false"; // Show http command traffic
263 Acquire::gpgv "false"; // Show the gpgv traffic
264 aptcdrom "false"; // Show found package files
269 /* Whatever you do, do not use this configuration file!! Take out ONLY
270 the portions you need! */
271 This Is Not A Valid Config File