doc/examples/apt.conf

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