X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/58a642755c63cde3cf377d3719d66add27b13d65..0418949ebe9fc886e7794fa1de17c8b6c74e65ea:/doc/sources.list.5.xml
diff --git a/doc/sources.list.5.xml b/doc/sources.list.5.xml
index 6029a7457..dd94f58f1 100644
--- a/doc/sources.list.5.xml
+++ b/doc/sources.list.5.xml
@@ -57,17 +57,19 @@
File names need to end with
.list and may only contain letters (a-z and A-Z),
digits (0-9), underscore (_), hyphen (-) and period (.) characters.
- Otherwise they will be silently ignored.
+ Otherwise APT will print a notice that it has ignored a file if the file
+ doesn't match a pattern in the Dir::Ignore-Files-Silently
+ configuration list - in this case it will be silently ignored.
The deb and deb-src types
The deb type describes a typical two-level Debian
archive, distribution/component. Typically,
- distribution is generally one of
- stable unstable or
- testing while component is one of main
- contrib non-free or
- non-us. The
+ distribution is generally an archivename like
+ stable or testing or a codename like
+ &stable-codename; or &testing-codename;
+ while component is one of main contrib or
+ non-free. The
deb-src type describes a debian distribution's source
code in the same form as the deb type.
A deb-src line is required to fetch source indexes.
@@ -76,7 +78,7 @@
The format for a sources.list entry using the
deb and deb-src types is:
- deb uri distribution [component1] [component2] [...]
+ deb [ options ] uri distribution [component1] [component2] [...]
The URI for the deb type must specify the base of the
Debian distribution, from which APT will find the information it needs.
@@ -107,6 +109,22 @@
simultaneous anonymous users. APT also parallelizes connections to
different hosts to more effectively deal with sites with low bandwidth.
+ options is always optional and needs to be surounded by
+ square brackets. It can consist of multiple settings in the form
+ setting=value.
+ Multiple settings are separated by spaces. The following settings are supported by APT,
+ note though that unsupported settings will be ignored silently:
+ arch=arch1,arch2,â¦
+ can be used to specify for which architectures packages information should
+ be downloaded. If this option is not set all architectures defined by the
+ APT::Architectures option will be downloaded.
+ trusted=yes can be set to indicate that packages
+ from this source are always authenificated even if the Release file
+ is not signed or the signature can't be checked. This disables parts of &apt-secure;
+ and should therefore only be used in a local and trusted context. trusted=no
+ is the opposite which handles even correctly authenificated sources as not authenificated.
+
+
It is important to list sources in order of preference, with the most
preferred source listed first. Typically this will result in sorting
by speed from fastest to slowest (CD-ROM followed by hosts on a local
@@ -204,6 +222,11 @@ deb http://security.debian.org/ &stable-codename;/updates main contrib non-free
Source line for the above
deb-src file:/home/jason/debian unstable 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://ftp.debian.org/debian &stable-codename; main
+deb [ arch=amd64,armel ] http://ftp.debian.org/debian &stable-codename; main
+
Uses HTTP to access the archive at archive.debian.org, and uses only
the hamm/main area.
deb http://archive.debian.org/debian-archive hamm main
@@ -218,18 +241,14 @@ deb http://security.debian.org/ &stable-codename;/updates main contrib non-free
a single FTP session will be used for both resource lines.
deb ftp://ftp.debian.org/debian unstable contrib
- Uses HTTP to access the archive at nonus.debian.org, under the
- debian-non-US directory.
- deb http://nonus.debian.org/debian-non-US stable/non-US main contrib non-free
-
- Uses HTTP to access the archive at nonus.debian.org, under the
- debian-non-US directory, and uses only files found under
- unstable/binary-i386 on i386 machines,
- unstable/binary-m68k on m68k, and so
- forth for other supported architectures. [Note this example only
- illustrates how to use the substitution variable; non-us is no longer
- structured like this]
- deb http://ftp.de.debian.org/debian-non-US unstable/binary-$(ARCH)/
+ Uses HTTP to access the archive at ftp.tlh.debian.org, under the
+ universe directory, and uses only files found under
+ unstable/binary-i386 on i386 machines,
+ unstable/binary-amd64 on amd64, and so
+ forth for other supported architectures. [Note this example only
+ illustrates how to use the substitution variable; official debian
+ archives are not structured like this]
+ deb http://ftp.tlh.debian.org/universe unstable/binary-$(ARCH)/