doc/examples/apt.conf

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