NAME

       approx - proxy server for Debian archive files

SYNOPSIS

       approx [OPTION]...

DESCRIPTION

       approx  responds  to HTTP requests made by apt-get(8).  It maintains a cache of Debian archive files that
       have been previously downloaded, so that it can respond with a local copy when possible.  If a  file  not
       in  the  cache  is  requested,  approx  will  download it from a remote Debian repository and deliver the
       contents to the client, simultaneously caching it for future use.

OPTIONS

       -c file, --config file
              Specify an additional configuration file.  May be used multiple times.

USAGE

       approx is invoked by inetd(8).

EXAMPLES

       Suppose that a client machine's /etc/apt/sources.list file contains the following lines:

              deb     http://apt:9999/debian    testing main
              deb     http://apt:9999/debian-security  testing-security main
              deb-src http://apt:9999/debian    unstable main

       In this example, apt is  the  hostname  of  the  approx  server  machine  on  the  local  network.   Each
       distribution,  such  as  "debian"  or  "debian-security",  is mapped to a remote repository in the approx
       server's configuration file.

       For example, the approx.conf file on the approx server might contain the lines

              debian   http://ftp.debian.org/debian
              debian-security http://security.debian.org/debian-security

       The mapping scheme is very simple.  If the approx.conf file contains the line

              repository     http://remote-host/initial/path

       then any request to the approx server of the form

              http://approx-server/repository/rest/of/URL

       is rewritten to

              http://remote-host/initial/path/rest/of/URL

       when there is a "cache miss", and that file is cached as

              /var/cache/approx/repository/rest/of/URL

       (Note that the repository name on the left-hand side is not included in the rewritten URL  unless  it  is
       explicitly mentioned in the right-hand side's initial path.)

FILES

       /etc/approx/approx.conf
              Configuration file for approx and related programs.

       /var/cache/approx
              Default cache directory for archive files.

SEE ALSO

       approx.conf(5), inetd(8), approx-import(8), apt-get(8), sources.list(5)

AUTHOR

       Eric Cooper <ecc@cmu.edu>

                                                    May 2011                                           APPROX(8)