X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/ab5b1d0d31b2fbdc4896f8a107611ff056d6a668..49521f87851089bdb4097b715d09a8bd348aa60a:/doc/sources.list.5.xml diff --git a/doc/sources.list.5.xml b/doc/sources.list.5.xml index 3b674c35f..d3e74bbdf 100644 --- a/doc/sources.list.5.xml +++ b/doc/sources.list.5.xml @@ -14,7 +14,7 @@ &apt-email; &apt-product; - 2015-09-14T00:00:00Z + 2016-09-20T00:00:00Z @@ -126,7 +126,7 @@ archive, distribution/component. The distribution is generally a suite name like stable or testing or a codename like - &stable-codename; or &testing-codename; + &debian-stable-codename; or &debian-testing-codename; while component is one of main, contrib or non-free. The deb-src type references a Debian distribution's source @@ -222,10 +222,12 @@ deb-src [ option1=value1 option2=value2 ] uri suite [component1] [component2] [. () is a multivalue option defining which download targets apt will try to acquire from this source. If not specified, the default set is defined by the - configuration scope. - Additionally, specific targets can be enabled or disabled by - using the identifier as field name instead of using this - multivalue option. + configuration scope + (targets are specified by their name in the + Created-By field). + Additionally, targets can be enabled or disabled by using the + Identifier field as an option with a boolean + value instead of using this multivalue option. () @@ -267,33 +269,42 @@ deb-src [ option1=value1 option2=value2 ] uri suite [component1] [component2] [. anomalies. + (), + () and + () + are boolean values which all default to no. + If set to yes they circumvent parts of &apt-secure; + and should therefore not be used lightly! + + () is a tri-state value which defaults to APT deciding if a source is considered trusted or if warnings should be raised before e.g. packages are installed from this source. This option can be used - to override this decision either with the value yes, - which lets APT consider this source always as a trusted source, - even if it lacks or fails authentication checks, by disabling parts - of &apt-secure;. It should therefore only be used in a local and trusted - context (if at all) as otherwise security is breached. The opposite - can be achieved with the value no, which - causes the source to be handled as untrusted even if the - authentication checks passed successfully. - The default value can't be set explicitly. + to override that decision. The value yes tells APT + always to consider this source as trusted, even if it doesn't pass + authentication checks. It disables parts of &apt-secure;, and should + therefore only be used in a local and trusted context (if at all) as + otherwise security is breached. The value no does + the opposite, causing the source to be handled as untrusted even if + the authentication checks passed successfully. The default value can't + be set explicitly. () is either an absolute path to a keyring file (has to be accessible and readable for the _apt user, - so ensure everyone has read-permissions on the file) or a - fingerprint of a key either in the - trusted.gpg keyring or in one of the + so ensure everyone has read-permissions on the file) or one or + more fingerprints of keys either in the + trusted.gpg keyring or in the keyrings in the trusted.gpg.d/ directory (see apt-key fingerprint). If the option is - set, only the key(s) in this keyring or only the key with this - fingerprint is used for the &apt-secure; verification of this - repository. Otherwise all keys in the trusted keyrings are - considered valid signers for this repository. + set, only the key(s) in this keyring or only the keys with these + fingerprints are used for the &apt-secure; verification of this + repository. Defaults to the value of the option with the same name + if set in the previously acquired Release file. + Otherwise all keys in the trusted keyrings are considered valid + signers for this repository. () @@ -430,16 +441,16 @@ Components: main contrib non-free The first line gets package information for the architectures in APT::Architectures while the second always retrieves amd64 and armel. - deb http://httpredir.debian.org/debian &stable-codename; main -deb [ arch=amd64,armel ] http://httpredir.debian.org/debian &stable-codename; main + deb http://deb.debian.org/debian &debian-stable-codename; main +deb [ arch=amd64,armel ] http://deb.debian.org/debian &debian-stable-codename; main Types: deb -URIs: http://httpredir.debian.org/debian -Suites: &stable-codename; +URIs: http://deb.debian.org/debian +Suites: &debian-stable-codename; Components: main Types: deb -URIs: http://httpredir.debian.org/debian -Suites: &stable-codename; +URIs: http://deb.debian.org/debian +Suites: &debian-stable-codename; Components: main Architectures: amd64 armel @@ -453,11 +464,11 @@ Suites: hamm Components: main Uses FTP to access the archive at ftp.debian.org, under the debian - directory, and uses only the &stable-codename;/contrib area. - deb ftp://ftp.debian.org/debian &stable-codename; contrib + directory, and uses only the &debian-stable-codename;/contrib area. + deb ftp://ftp.debian.org/debian &debian-stable-codename; contrib Types: deb URIs: ftp://ftp.debian.org/debian -Suites: &stable-codename; +Suites: &debian-stable-codename; Components: contrib Uses FTP to access the archive at ftp.debian.org, under the debian @@ -485,14 +496,14 @@ Suites: unstable/binary-$(ARCH)/ Uses HTTP to get binary packages as well as sources from the stable, testing and unstable suites and the components main and contrib. - deb http://httpredir.debian.org/debian stable main contrib -deb-src http://httpredir.debian.org/debian stable main contrib -deb http://httpredir.debian.org/debian testing main contrib -deb-src http://httpredir.debian.org/debian testing main contrib -deb http://httpredir.debian.org/debian unstable main contrib -deb-src http://httpredir.debian.org/debian unstable main contrib + deb http://deb.debian.org/debian stable main contrib +deb-src http://deb.debian.org/debian stable main contrib +deb http://deb.debian.org/debian testing main contrib +deb-src http://deb.debian.org/debian testing main contrib +deb http://deb.debian.org/debian unstable main contrib +deb-src http://deb.debian.org/debian unstable main contrib Types: deb deb-src -URIs: http://httpredir.debian.org/debian +URIs: http://deb.debian.org/debian Suites: stable testing unstable Components: main contrib @@ -500,8 +511,7 @@ Components: main contrib See Also - &apt-get;, &apt-conf; - + &apt-get;, &apt-conf;, &apt-acquire-additional-files; &manbugs;