doc/examples/apt.conf

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