X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/5723791e130a7d28698ae1def407fe15d8de0c32..a17482f89b636a52aacc57776bfc8041cf4da508:/doc/apt.conf.5.xml?ds=sidebyside diff --git a/doc/apt.conf.5.xml b/doc/apt.conf.5.xml index 3e304a89d..78f6a27a2 100644 --- a/doc/apt.conf.5.xml +++ b/doc/apt.conf.5.xml @@ -8,6 +8,8 @@ %aptverbatiment; + +%aptvendor; ]> @@ -23,7 +25,7 @@ &apt-email; &apt-product; - 2012-05-21T00:00:00Z + 2012-06-09T00:00:00Z @@ -98,8 +100,7 @@ APT { DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; - In general the sample configuration file in - &docdir;examples/apt.conf &configureindex; + In general the sample configuration file &configureindex; is a good guide for how it should look. Case is not significant in names of configuration items, so in the @@ -176,6 +177,15 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; + + + List of all build profiles enabled for build-dependency resolution, + without the "profile." namespace prefix. + By default this list is empty. The DEB_BUILD_PROFILES + as used by &dpkg-buildpackage; overrides the list notation. + + + Default release to install packages from if more than one version is available. Contains release name, codename or release version. Examples: 'stable', 'testing', @@ -387,14 +397,30 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; Acquire::http::AllowRedirect controls whether APT will follow redirects, which is enabled by default. - The used bandwidth can be limited with Acquire::http::Dl-Limit - which accepts integer values in kilobytes. The default value is 0 which deactivates - the limit and tries to use all available bandwidth (note that this option implicitly - disables downloading from multiple servers at the same time.) + The used bandwidth can be limited with + Acquire::http::Dl-Limit which accepts integer + values in kilobytes per second. The default value is 0 which + deactivates the limit and tries to use all available bandwidth. + Note that this option implicitly disables downloading from + multiple servers at the same time. Acquire::http::User-Agent can be used to set a different User-Agent for the http download method as some proxies allow access for clients only if the client uses a known identifier. + + Acquire::http::Proxy-Auto-Detect can be used to + specify an external command to discover the http proxy to use. Apt expects + the command to output the proxy on stdout in the style + http://proxy:port/. This will override the + generic Acquire::http::Proxy but not any specific + host proxy configuration set via + Acquire::http::Proxy::$HOST. + + See the &squid-deb-proxy-client; package for an example implementation that + uses avahi. This option takes precedence over the legacy option name + ProxyAutoDetect. + + @@ -554,6 +580,18 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; + + + When downloading, force to use only the IPv4 protocol. + + + + + + When downloading, force to use only the IPv6 protocol. + + + @@ -675,13 +713,28 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; options this must be specified in list notation. The commands are invoked in order using /bin/sh; should any fail APT will abort. APT will pass the filenames of all .deb files it is going to - install to the commands, one per line on standard input. + install to the commands, one per line on the requested file descriptor, defaulting + to standard input. - Version 2 of this protocol dumps more information, including the + Version 2 of this protocol dumps more information, including the protocol version, the APT configuration space and the packages, files - and versions being changed. Version 2 is enabled by setting - DPkg::Tools::options::cmd::Version to 2. cmd is a - command given to Pre-Install-Pkgs. + and versions being changed. Version 3 adds the architecture and MultiArch + flag to each version being dumped. + + The version of the protocol to be used for the command + cmd can be chosen by setting + DPkg::Tools::options::cmd::Version + accordingly, the default being version 1. If APT isn't supporting the requested + version it will send the information in the highest version it has support for instead. + + + The file descriptor to be used to send the information can be requested with + DPkg::Tools::options::cmd::InfoFD + which defaults to 0 for standard input and is available since + version 0.9.11. Support for the option can be detected by looking for the environment + variable APT_HOOK_INFO_FD which contains the number of the used + file descriptor as a confirmation. +