doc/examples/apt.conf

   1 // $Id: apt.conf,v 1.32 1999/04/19 06:03:09 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   };
  37
  38   Cache
  39   {
  40      Important "false";
  41   };
  42
  43   CDROM
  44   {
  45      Rename "false";
  46      NoMount "false";
  47      Fast "false";
  48      NoAct "false";
  49   };
  50
  51   // Some general options
  52   Ignore-Hold "false";
  53   Immediate-Configure "true";      // DO NOT turn this off, see the man page
  54 };
  55
  56 // Options for the downloading routines
  57 Acquire
  58 {
  59   Queue-Mode "host";       // host|access
  60   Retries "0";
  61
  62   // HTTP method configuration
  63   http
  64   {
  65     Proxy "http://127.0.0.1:3128";
  66     Proxy::http.us.debian.org "DIRECT";  // Specific per-host setting
  67     Timeout "120";
  68
  69     // Cache Control. Note these do not work with Squid 2.0.2
  70     No-Cache "false";
  71     Max-Age "86400";     // 1 Day age on index files
  72     No-Store "false";    // Prevent the cache from storing archives
  73   };
  74
  75   ftp
  76   {
  77     Proxy "ftp://127.0.0.1/";
  78     Proxy::http.us.debian.org "DIRECT"; // Specific per-host setting
  79
  80     /* Required script to perform proxy login. This example should work
  81        for tisfwtk */
  82     ProxyLogin
  83     {
  84        "USER $(PROXY_USER)";
  85        "PASS $(PROXY_PASS)";
  86        "USER $(SITE_USER)@$(SITE):$(SITE_PORT)";
  87        "PASS $(SITE_PASS)";
  88     };
  89
  90     Timeout "120";
  91
  92     /* Passive mode control, proxy, non-proxy and per-host. Pasv mode
  93        is prefered if possible */
  94     Passive "true";
  95     Proxy::Passive "true";
  96     Passive::http.us.debian.org "true"; // Specific per-host setting
  97   };
  98
  99   cdrom
 100   {
 101     Mount "/cdrom";
 102
 103     // You need the trailing slash!
 104     "/cdrom/"
 105     {
 106        Mount "sleep 1000";
 107        UMount "sleep 500";
 108     }
 109   };
 110 };
 111
 112 // Directory layout
 113 Dir
 114 {
 115   // Location of the state dir
 116   State "/var/state/apt/"
 117   {
 118      lists "lists/";
 119      xstatus "xstatus";
 120      userstatus "status.user";
 121      status "/var/lib/dpkg/status";
 122      cdroms "cdroms.list";
 123   };
 124
 125   // Location of the cache dir
 126   Cache "/var/cache/apt/" {
 127      archives "archives/";
 128      srcpkgcache "srcpkgcache.bin";
 129      pkgcache "pkgcache.bin";
 130   };
 131
 132   // Config files
 133   Etc "/etc/apt/" {
 134      sourcelist "sources.list";
 135      main "apt.conf";
 136   };
 137
 138   // Locations of binaries
 139   Bin {
 140      methods "/usr/lib/apt/methods/";
 141      gzip "/bin/gzip";
 142      dpkg "/usr/bin/dpkg";
 143      dpkg-source "/usr/bin/dpkg-source";
 144      dpkg-buildpackage "/usr/bin/dpkg-buildpackage"
 145      apt-get "/usr/bin/apt-get";
 146      apt-cache "/usr/bin/apt-cache";
 147   };
 148 };
 149
 150 // Things that effect the APT dselect method
 151 DSelect
 152 {
 153    Clean "auto";   // always|auto|prompt|never
 154    Options "-f";
 155    UpdateOptions "";
 156    PromptAfterUpdate "no";
 157 }
 158
 159 DPkg
 160 {
 161    // Probably don't want to set this one..
 162    Options {"--force-downgrade";}
 163
 164    // Auto re-mounting of a readonly /usr
 165    Pre-Invoke {"mount -o remount,rw /usr";};
 166    Post-Invoke {"mount -o remount,ro /usr";};
 167
 168    // Prevents daemons from getting cwd as something mountable (default)
 169    Run-Directory "/";
 170
 171    // Build options for apt-get source --compile
 172    Build-Options "-b -uc";
 173 }
 174
 175 /* Options you can set to see some debugging text They corrispond to names
 176    of classes in the source code */
 177 Debug
 178 {
 179   pkgProblemResolver "false";
 180   pkgAcquire "false";
 181   pkgAcquire::Worker "false";
 182   pkgDPkgPM "false";
 183
 184   pkgInitialize "false";   // This one will dump the configuration space
 185   NoLocking "false";
 186   Acquire::Ftp "false";    // Show ftp command traffic
 187   aptcdrom "false";        // Show found package files
 188 }