Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

approx.conf(5) [centos man page]

APPROX.CONF(5)                                                  File Formats Manual                                                 APPROX.CONF(5)

NAME

       approx.conf - configuration file for approx proxy server

SYNOPSIS

       /etc/approx/approx.conf

DESCRIPTION

       Each  non-blank line of the configuration file should contain a name/value pair, separated by white space.  Comments start with a "#" char-
       acter and continue to the end of the line.

       Names that begin with the "$" character are reserved for use as configuration parameters.  The following parameters are currently defined:

       $cache Specifies the location of the approx cache directory (default: /var/cache/approx).  It and all its subdirectories must be  owned  by
              the approx server (see also the $user and $group parameters, below.)

       $interval
              Specifies the time in minutes after which a cached file will be considered too old to deliver without first checking with the remote
              repository for a newer version (default: 60)

       $max_rate
              Specifies the maximum download rate from remote repositories, in bytes per second (default: unlimited).  The value may  be  suffixed
              with "K", "M", or "G" to indicate kilobytes, megabytes, or gigabytes per second, respectively.

       $max_redirects
              Specifies the maximum number of HTTP redirections that will be followed when downloading a remote file (default: 5)

       $user, $group
              Specifies the user and group that owns the files in the approx cache (default: approx)

       $syslog
              Specifies the syslog(3) facility to use when logging (default: daemon)

       $pdiffs
              Specifies whether to support IndexFile diffs (default: true)

       $offline
              Specifies  whether  to deliver (possibly out-of-date) cached files when they cannot be downloaded from remote repositories (default:
              false)

       $max_wait
              Specifies how many seconds an approx(8) process will wait for a concurrent download of a file  to  complete,  before  attempting  to
              download the file itself (default: 10)

       $verbose
              Specifies whether informational messages should be printed in the log (default: false)

       $debug Specifies whether debugging messages should be printed in the log (default: false)

       The other name/value pairs  are used to map distribution names to remote repositories.  For example,

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

TCP PORT NUMBER

       The  port  on  which approx(8) listens is not specified in this file, but in /etc/inetd.conf.  The default value is 9999, for compatibility
       with apt-proxy(8), but it may be changed by running the command

              dpkg-reconfigure approx

SEE ALSO

       approx(8), approx-gc(8), inetd(8)

AUTHOR

       Eric Cooper <ecc@cmu.edu>

                                                                     Apr 2012                                                       APPROX.CONF(5)

Check Out this Related Man Page

APPROX(8)                                                     System Manager's Manual                                                    APPROX(8)

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.

       Over  time,  the approx server cache will grow to contain multiple, unneeded versions of Debian packages.  The approx-gc(8) program removes
       these from the cache.

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/security  testing/updates 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 "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
              security http://security.debian.org

       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), approx-gc(8), apt-get(8), sources.list(5)

AUTHOR

       Eric Cooper <ecc@cmu.edu>

                                                                     May 2011                                                            APPROX(8)
Man Page