approx(8) [centos 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)
Check Out this Related Man Page
APT_AUTH.CONF(5) APT APT_AUTH.CONF(5) NAME
apt_auth.conf - Login configuration file for APT sources and proxies DESCRIPTION
APT configuration files like sources.list(5) or apt.conf(5) need to be accessible for everyone using apt tools on the system to have access to all package-related information like the available packages in a repository. Login information needed to connect to a proxy or to download data from a repository on the other hand shouldn't always be accessible by everyone and can hence not be placed in a file with world-readable file permissions. The APT auth.conf file /etc/apt/auth.conf can be used to store login information in a netrc-like format with restrictive file permissions. NETRC-LIKE FORMAT The format defined here is similar to the format of the ~/.netrc file used by ftp(1) and similar programs interacting with servers. It is a simple token-based format with the following tokens being recognized; Unknown tokens will be ignored. Tokens may be separated by spaces, tabs or newlines. machine hostname[:port][/path] Entries are looked up by searching for the machine token matching the hostname of the URI apt needs login information for. Extending the netrc-format a portnumber can be specified. If no port is given the token matches for all ports. Similar the path is optional and only needed and useful if multiple repositories with different login information reside on the same server. A machine token with a path matches if the path in the URI starts with the path given in the token. Once a match is made, the subsequent tokens are processed, stopping when the end of file is reached or another machine token is encountered. login name The username to be used. password string The password to be used. EXAMPLE
Supplying login information for a user named apt with the password debian for the sources.list(5) entry deb http://example.org/debian stretch main could be done in the entry directly: deb http://apt:debian@example.org/debian stretch main Alternatively an entry like the following in the auth.conf file could be used: machine example.org login apt password debian Or alternatively within a single line: machine example.org login apt password debian If you need to be more specific all of these lines will also apply to the example entry: machine example.org/deb login apt password debian machine example.org/debian login apt password debian machine example.org/debian/ login apt password debian On the other hand neither of the following lines apply: machine example.org:80 login apt password debian machine example.org/deb/ login apt password debian machine example.org/ubuntu login apt password debian machine example.orga login apt password debian machine example.net login apt password debian NOTES
Basic support for this feature is present since version 0.7.25, but was undocumented for years. The documentation was added in version 1.5 changing also the implementation slightly. For maximum backward compatibility you should avoid multiple machine tokens with the same hostname, but if you need multiple they should all have a path specified in the machine token. FILES
/etc/apt/auth.conf Login information for APT sources and proxies in a netrc-like format. Configuration Item: Dir::Etc::netrc. SEE ALSO
apt.conf(5) sources.list(5) BUGS
APT bug page[1]. If you wish to report a bug in APT, please see /usr/share/doc/debian/bug-reporting.txt or the reportbug(1) command. AUTHOR
APT team NOTES
1. APT bug page http://bugs.debian.org/src:apt APT 1.6.3ubuntu0.1 17 August 2017 APT_AUTH.CONF(5)