Regex, --all-versions and more OR stuff

[apt.git] / doc / examples / apt.conf

diff --git a/doc/examples/apt.conf b/doc/examples/apt.conf
index 9e92fd4543c90269c22b442b934351ce42f3f651..2249cadba202dde7ab2b15d6aa176335cdf6b737 100644 (file)
--- a/doc/examples/apt.conf
+++ b/doc/examples/apt.conf
@@ -1,7 +1,9 @@
-// $Id: apt.conf,v 1.23 1999/01/31 08:49:39 jgg Exp $
+// $Id: apt.conf,v 1.39 1999/10/22 04:05:48 jgg Exp $

 /* This file is an index of all APT configuration directives. It should
    NOT actually be used as a real config file, though it is a completely
 /* This file is an index of all APT configuration directives. It should
    NOT actually be used as a real config file, though it is a completely

-   valid file.
+   valid file. Most of the options have sane default values, unless
+   you have specific needs you should NOT include arbitary items in a custom
+   configuration.

    
    In some instances involving filenames it is possible to set the default
    directory when the path is evaluated. This means you can use relative
    
    In some instances involving filenames it is possible to set the default
    directory when the path is evaluated. This means you can use relative


@@ -16,27 +18,36 @@
 */
 
 // Options for APT in general
 */
 
 // Options for APT in general

-APT {
+APT 
+{

   Architecture "i386";
   
   // Options for apt-get
   Architecture "i386";
   
   // Options for apt-get

-  Get {
+  Get 
+  {

      Download-Only "false";
      Simulate "false";
      Assume-Yes "false";
      Download-Only "false";
      Simulate "false";
      Assume-Yes "false";

-     Force-Yes "false";  // I would never set this.
+     Force-Yes "false";             // I would never set this.

      Fix-Broken "false";  
      Fix-Missing "false";     
      Show-Upgraded "false";
      No-Upgrade "false";
      Print-URIs "false";
      Fix-Broken "false";  
      Fix-Missing "false";     
      Show-Upgraded "false";
      No-Upgrade "false";
      Print-URIs "false";

+     Compile "false";
+     No-Download "false";
+     Purge "false";
+     List-Cleanup "true";

   };
 
   };
 

-  Cache {
+  Cache 
+  {

      Important "false";
      Important "false";

+     AllVersions "false";

   };
   };

-  
-  CDROM {
+
+  CDROM 
+  {

      Rename "false";
      NoMount "false";
      Fast "false";
      Rename "false";
      NoMount "false";
      Fast "false";


@@ -44,31 +55,66 @@ APT {
   };
 
   // Some general options
   };
 
   // Some general options

-  Ingore-Hold "false";
-  Immediate-Configure "true";        // DO NOT turn this off, see the man page
+  Ignore-Hold "false";
+  Clean-Installed "true";
+  Immediate-Configure "true";      // DO NOT turn this off, see the man page
+  Force-LoopBreak "false";         // DO NOT turn this on, see the man page

 };
 
 // Options for the downloading routines
 Acquire
 {
   Queue-Mode "host";       // host|access
 };
 
 // Options for the downloading routines
 Acquire
 {
   Queue-Mode "host";       // host|access

-  Retry "false";
+  Retries "0";
+  Source-Symlinks "true";

   
   // HTTP method configuration
   http 
   {
     Proxy "http://127.0.0.1:3128";
     Proxy::http.us.debian.org "DIRECT";  // Specific per-host setting
   
   // HTTP method configuration
   http 
   {
     Proxy "http://127.0.0.1:3128";
     Proxy::http.us.debian.org "DIRECT";  // Specific per-host setting

+    Timeout "120";

     
     // Cache Control. Note these do not work with Squid 2.0.2
     No-Cache "false";
     Max-Age "86400";     // 1 Day age on index files
     No-Store "false";    // Prevent the cache from storing archives    
   };
     
     // Cache Control. Note these do not work with Squid 2.0.2
     No-Cache "false";
     Max-Age "86400";     // 1 Day age on index files
     No-Store "false";    // Prevent the cache from storing archives    
   };

+
+  ftp
+  {
+    Proxy "ftp://127.0.0.1/";
+    Proxy::http.us.debian.org "DIRECT"; // Specific per-host setting
+
+    /* Required script to perform proxy login. This example should work
+       for tisfwtk */
+    ProxyLogin
+    {
+       "USER $(PROXY_USER)";
+       "PASS $(PROXY_PASS)";
+       "USER $(SITE_USER)@$(SITE):$(SITE_PORT)";
+       "PASS $(SITE_PASS)";
+    };
+    
+    Timeout "120";
+    
+    /* Passive mode control, proxy, non-proxy and per-host. Pasv mode
+       is prefered if possible */
+    Passive "true";
+    Proxy::Passive "true";
+    Passive::http.us.debian.org "true"; // Specific per-host setting
+  };

   
   cdrom
   {
   
   cdrom
   {

-    Mount "/cdrom";    
+    Mount "/cdrom";
+
+    // You need the trailing slash!
+    "/cdrom/"
+    {
+       Mount "sleep 1000";
+       UMount "sleep 500";
+    }

   };
 };
 
   };
 };
 


@@ -103,33 +149,57 @@ Dir
      methods "/usr/lib/apt/methods/";
      gzip "/bin/gzip";
      dpkg "/usr/bin/dpkg";
      methods "/usr/lib/apt/methods/";
      gzip "/bin/gzip";
      dpkg "/usr/bin/dpkg";

+     dpkg-source "/usr/bin/dpkg-source";
+     dpkg-buildpackage "/usr/bin/dpkg-buildpackage"

      apt-get "/usr/bin/apt-get";
      apt-get "/usr/bin/apt-get";

-     apt-cache "/usr/bin/apt-get";
+     apt-cache "/usr/bin/apt-cache";

   };
 };
 
 // Things that effect the APT dselect method
   };
 };
 
 // Things that effect the APT dselect method

-DSelect {
+DSelect 
+{

    Clean "auto";   // always|auto|prompt|never
    Options "-f";
    UpdateOptions "";
    PromptAfterUpdate "no";
 }
 
    Clean "auto";   // always|auto|prompt|never
    Options "-f";
    UpdateOptions "";
    PromptAfterUpdate "no";
 }
 

-DPkg {
-   Options {"--force-downgrade";}
+DPkg 
+{
+   // Probably don't want to use force-downgrade..
+   Options {"--force-overwrite";"--force-downgrade";}
+   
+   // Auto re-mounting of a readonly /usr

    Pre-Invoke {"mount -o remount,rw /usr";};
    Post-Invoke {"mount -o remount,ro /usr";};
    Pre-Invoke {"mount -o remount,rw /usr";};
    Post-Invoke {"mount -o remount,ro /usr";};

+   
+   // Prevents daemons from getting cwd as something mountable (default)
+   Run-Directory "/";
+   
+   // Build options for apt-get source --compile
+   Build-Options "-b -uc";
+
+   // Pre-configure all packages before they are installed using debconf.
+   Pre-Install-Pkgs {"dpkg-preconfig --apt --priority=low --frontend=dialog";};

 }
 
 /* Options you can set to see some debugging text They corrispond to names
    of classes in the source code */
 }
 
 /* Options you can set to see some debugging text They corrispond to names
    of classes in the source code */

-Debug {
+Debug 
+{

   pkgProblemResolver "false";
   pkgAcquire "false";
   pkgAcquire::Worker "false";
   pkgDPkgPM "false";
   
   pkgInitialize "false";   // This one will dump the configuration space
   pkgProblemResolver "false";
   pkgAcquire "false";
   pkgAcquire::Worker "false";
   pkgDPkgPM "false";
   
   pkgInitialize "false";   // This one will dump the configuration space

-  NoLocking "false";   
+  NoLocking "false";
+  Acquire::Ftp "false";    // Show ftp command traffic
+  Acquire::Http "false";   // Show http command traffic
+  aptcdrom "false";        // Show found package files

 }
 }

+
+/* Whatever you do, do not use this configuration file!! Take out ONLY
+   the portions you need */
+This Is Not A Valid Config File