From 636c7dc17286d93d788c741d15fd756aeda066d5 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 5 May 2024 20:07:13 +0200 Subject: Adding upstream version 1.8.2.3. Signed-off-by: Daniel Baumann --- doc/apt_auth.conf.5.xml | 138 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 138 insertions(+) create mode 100644 doc/apt_auth.conf.5.xml (limited to 'doc/apt_auth.conf.5.xml') diff --git a/doc/apt_auth.conf.5.xml b/doc/apt_auth.conf.5.xml new file mode 100644 index 0000000..e7961ef --- /dev/null +++ b/doc/apt_auth.conf.5.xml @@ -0,0 +1,138 @@ + + %aptent; + %aptverbatiment; + %aptvendor; +]> + + + + + &apt-author.team; + &apt-email; + &apt-product; + + 2018-12-03T00:00:00Z + + + + apt_auth.conf + 5 + APT + + + + + apt_auth.conf + Login configuration file for APT sources and proxies + + +Description +APT configuration files like &sources-list; or &apt-conf; 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, and .conf files inside +/etc/apt/auth.conf.d 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 ftp1 +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; entry +deb http://example.org/debian &debian-stable-codename; main +could be done in the entry directly: +deb http://apt:debian@example.org/debian &debian-stable-codename; 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. + + /etc/apt/auth.conf.d/*.conf + Login information for APT sources and proxies in a netrc-like format. + Configuration Item: Dir::Etc::netrcparts. + + + + + +See Also +&apt-conf; &sources-list; + + + + &manbugs; + + -- cgit v1.2.3