From 956145444e1a3b7f5e660f71904711f4ea5bd262 Mon Sep 17 00:00:00 2001 From: David Kalnischkies Date: Wed, 22 Nov 2017 19:39:31 +0100 Subject: document http options in new apt-transport-http manpage We had documentation for the http transport in our "catch-all" apt.conf manpage, but it seems benefitial to document transports in their own manpage instead of pushing them all into one. --- doc/apt.conf.5.xml | 64 ------------------------------------------------------ 1 file changed, 64 deletions(-) (limited to 'doc/apt.conf.5.xml') diff --git a/doc/apt.conf.5.xml b/doc/apt.conf.5.xml index 6f47bb029..30714e66b 100644 --- a/doc/apt.conf.5.xml +++ b/doc/apt.conf.5.xml @@ -409,70 +409,6 @@ APT::Compressor::rev { be symlinked when possible instead of copying. True is the default. - - http::Proxy sets the default proxy to use for HTTP - URIs. It is in the standard form of http://[[user][:pass]@]host[:port]/. - Per host proxies can also be specified by using the form - http::Proxy::<host> with the special keyword DIRECT - meaning to use no proxies. If no one of the above settings is specified, - http_proxy environment variable - will be used. - - Three settings are provided for cache control with HTTP/1.1 compliant - proxy caches. - No-Cache tells the proxy not to use its cached - response under any circumstances. - Max-Age sets the allowed maximum age (in seconds) of - an index file in the cache of the proxy. - No-Store specifies that the proxy should not store - the requested archive files in its cache, which can be used to prevent - the proxy from polluting its cache with (big) .deb files. - - The option timeout sets the timeout timer used by the method; - this value applies to the connection as well as the data timeout. - - The setting Acquire::http::Pipeline-Depth can be used to - enable HTTP pipelining (RFC 2616 section 8.1.2.2) which can be beneficial e.g. on - high-latency connections. It specifies how many requests are sent in a pipeline. - APT tries to detect and workaround misbehaving webservers and proxies at runtime, but - if you know that yours does not conform to the HTTP/1.1 specification pipelining can - be disabled by setting the value to 0. It is enabled by default with the value 10. - - 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 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. The first - and only parameter is an URI denoting the host to be contacted to allow - for host-specific configuration. APT expects the command to output the - proxy on stdout as a single line in the style http://proxy:port/ - or the word DIRECT if no proxy should be used. No output - indicates that the generic proxy settings should be used. - - Note that auto-detection will not be used for a host if a host-specific proxy - configuration is already 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. - - - - - The Cache-control, Timeout, -- cgit v1.2.3-18-g5258