SOURCES.LIST(5)

NAZWA
sources.list - Lista skonfigurowanych źródeł danych APT

OPIS

Plik źródeł /etc/apt/sources.list został zaprojektowany tak, by obsłużyć dowolną liczbę aktywnych źródeł i różne nośniki źródeł. W każdej linii jest wymienione jedno źródło, linie są posortowane według preferencji źródeł, te najbardziej preferowane wymienione są na początku pliku. Informacje dostępne w skonfigurowanych źródłach są pobierane przez apt-get update (lub przez podobne polecenie innego programu użytkowego będącego interfejsem do systemu APT).

Każda linia określająca źródło rozpoczyna się od typu (np. deb-src), po którym następują opcje i argumenty dla tego typu. Wpisy nie mogą być kontynuowane w nowych liniach. Puste linie są ignorowane, a znak "# " występujący gdziekolwiek w linii oznacza, że dalsza część linii stanowi komentarz.

SOURCES.LIST.D

Katalog /etc/apt/sources.list.d umożliwia podzielenie pliku źródeł na osobne pliki. Format jest dokładnie taki sam, jak w przypadku zwykłego pliku sources.list. Nazwy plików w tym katalogu muszą się kończyć rozszerzeniem .list i mogą składać się tylko z liter (a-z i A-Z), cyfr (0-9), znaku podkreślenia ("_"), pauzy ("-") i kropki ("."). W przeciwnym wypadku APT zignoruje taki plik i jeśli nazwa pliku nie pasuje do wzorca podanego w liście zmiennych konfiguracji Dir::Ignore-Files-Silently, to wypisze odpowiedni komunikat.

TYPY DEB I DEB-SRC

Typ deb opisuje typowe dwupoziomowe archiwum Debiana: dystrybucja/komponent. Zazwyczaj dystrybucja jest nazwą archiwum, taką jak: stable lub testing, albo nazwą kodową, taką jak: jessie lub stretch, a komponent jest jednym z: main, contrib lub non-free. Typ deb-src opisuje lokalizacje kodów źródłowych dystrybucji Debiana i używa takiego samego formatu jak typ deb. Linia deb-src jest wymagana do pobierania indeksów kodów źródłowych.

Formaty wpisu w sources.list używającego typów deb i deb-src jest następujący:

    deb [ options ] uri suite [component1] [component2] [...]

Alternatively a rfc822 style format is also supported:

         Types: deb deb-src
         URIs: http://example.com
         Suites: stable testing
         Sections: component1 component2
         Description: short
          long long long
         [option1]: [option1-value]
         Types: deb
         URIs: http://another.example.com
         Suites: experimental
         Sections: component1 component2
         Enabled: no
         Description: short
          long long long
         [option1]: [option1-value]

The URI for the deb type must specify the base of the Debian distribution, from which APT will find the information it needs. suite can specify an exact path, in which case the components must be omitted and suite must end with a slash (/). This is useful for the case when only a particular sub-section of the archive denoted by the URI is of interest. If suite does not specify an exact path, at least one component must be present.

suite may also contain a variable, $(ARCH) which expands to the Debian architecture (such as amd64 or armel) used on the system. This permits architecture-independent sources.list files to be used. In general this is only of interest when specifying an exact path, APT will automatically generate a URI with the current architecture otherwise.

In the traditional style sources.list format since only one distribution can be specified per line it may be necessary to have multiple lines for the same URI, if a subset of all available distributions or components at that location is desired. APT will sort the URI list after it has generated a complete set internally, and will collapse multiple references to the same Internet host, for instance, into a single connection, so that it does not inefficiently establish an FTP connection, close it, do something else, and then re-establish a connection to that same host. This feature is useful for accessing busy FTP sites with limits on the number of simultaneous anonymous users. APT also parallelizes connections to different hosts to more effectively deal with sites with low bandwidth.

opcje nigdy nie są wymagane i powinny być otoczone przez nawiasy kwadratowe. Mogą się składać z wielu ustawień w formacie ustawienie=wartość oddzielonych od siebie znakami spacji. APT obsługuje następujące ustawienia (a ustawienia nieobsługiwane są ignorowane bez wypisywania żadnego ostrzeżenia):

    • arch=arch1,arch2,... może zostać użyte do podania architektur, dla których będą pobierane informacje o pakietach. Jeśli ta opcja nie jest ustawiona, będą pobierane informacje dla wszystkich architektur określonych w opcji konfiguracji APT::Architectures.

    • arch+=arch1,arch2,... and arch-=arch1,arch2,... which can be used to add/remove architectures from the set which will be downloaded.

    • trusted=yes może być użyte do wskazania, że pakiety z tego źródła są zawsze zautentykowane, nawet jeśli plik Release nie jest podpisany lub nie można sprawdzić podpisu. Wyłącza to częściowo apt-secure(8) i dlatego powinno być używane tylko dla źródeł lokalnych i zaufanych. Przeciwieństwem tej opcji jest trusted=no, która obsługuje nawet poprawnie zautentykowane źródła jako niezautentykowane.

Ważne jest, aby źródła pakietów były wymienione w kolejności preferencji użytkownika, zaczynając od tego najbardziej preferowanego. Zazwyczaj wynikiem tego będzie sortowanie od najszybszego do najwolniejszego (na przykład CD-ROM przed komputerami w lokalnej sieci przed odległymi komputerami w Internecie).

Kilka przykładów:

    deb http://ftp.debian.org/debian jessie main contrib non-free
    deb http://security.debian.org/ jessie/updates main contrib non-free

OKREŚLANIE URI

Obecnie rozpoznawane są następujące typy URI:

file
    Schemat file pozwala używać jako archiwum dowolnego katalogu w systemie plików. Jest użyteczny dla katalogów montowanych przez NFS i lokalnych kopii archiwów.

cdrom
    Schemat cdrom pozwala APT na użycie lokalnego dysku CD-ROM ze zmianą dysków. Prosimy używać programu apt-cdrom(8) do dodawania takich wpisów w sources.list.

http
    Schemat http opisuje serwer archiwum HTTP. Jeśli ustawiono zmienną środowiskową http_proxy w formacie http://serwer:port/, to APT użyje serwera proxy określonego w tej zmiennej. Użytkownicy serwerów proxy wymagających autoryzacji mogą ustawić tę zmienną na http://użytkownik:hasło@serwer:port/. Proszę zauważyć, że taki sposób autoryzacji nie jest bezpieczny.

ftp
    Schemat ftp opisuje serwer FTP archiwum. Zachowanie modułu FTP można dowolnie konfigurować, szczegóły można znaleźć na stronie podręcznika apt.conf(5). Proszę zauważyć, że można podać serwer proxy FTP, używając zmiennej środowiskowej ftp_proxy. Możliwe jest podanie serwera proxy HTTP (które to serwery często rozumieją lokalizacje zasobów FTP), używając tej i tylko tej zmiennej środowiskowej. Podane w pliku konfiguracyjnym serwery proxy używające HTTP zostaną zignorowane.

copy
    Schemat copy jest identyczny ze schematem file, z tym wyjątkiem, że pakiety nie są używane bezpośrednio z podanej lokalizacji, tylko są kopiowane do katalogu bufora. Jest to użyteczne w przypadku używania nośnika przenośnego do skopiowania plików przy użyciu APT.

rsh, ssh
    Metoda rsh/ssh uruchamia RSH/SSH do połączenia się ze zdalnym komputerem i uzyskania dostępu do plików jako podany użytkownik. Dobrym pomysłem jest wcześniejsze przygotowanie kluczy RSA lub dostępu rhosts. APT używa standardowych poleceń find i dd do przetransferowania plików ze zdalnego komputera.

dodawanie innych rozpoznawanych typów URI
    APT może być rozszerzone o więcej metod, pochodzących z innych opcjonalnych pakietów, które powinny się nazywać apt-transport-metoda. Na przykład zespół APT opiekuje się pakietem apt-transport-https, dostarczającym metody dostępu dla URI typu HTTPS, działającej podobnie do metody HTTP. Dostępne są również inne metody pozwalające na przykład używać debtorrenta, proszę zobaczyć apt-transport-debtorrent(1).

PRZYKŁADY

Użycie archiwum lokalnego (lub montowanego przez NFS) w katalogu /home/jason/debian dla zasobów stable/main, stable/contrib i stable/non-free.

    deb file:/home/jason/debian stable main contrib non-free

Jak wyżej, z tą różnicą że używa dystrybucji niestabilnej (deweloperskiej).

    deb file:/home/jason/debian unstable main contrib non-free

Linie źródeł dla powyższego przykładu

    deb-src file:/home/jason/debian unstable main contrib non-free

Pierwsza linia pobiera informacje o pakiecie dla architektur w APT::Architectures , podczas gdy druga zawsze pobiera amd64 i armel.

    deb http://ftp.debian.org/debian jessie main
    deb [ arch=amd64,armel ] http://ftp.debian.org/debian jessie main

Użycie HTTP do uzyskania dostępu do archiwum na komputerze archive.debian.org i dystrybucji hamm/main.

    deb http://archive.debian.org/debian-archive hamm main

Użycie FTP do uzyskania dostępu do archiwum na komputerze ftp.debian.org w katalogu debian i używa tylko dystrybucji jessie/contrib.

    deb ftp://ftp.debian.org/debian jessie contrib

Użycie FTP do uzyskania dostępu do archiwum na komputerze ftp.debian.org, dystrybucji unstable/contrib. Jeśli poniższa linia wystąpi razem z linią z poprzedniego przykładu w tym samym pliku sources.list, to pojedyncza sesja FTP będzie użyta w celu uzyskania dostępu do obu zasobów.

    deb ftp://ftp.debian.org/debian unstable contrib

Użycie HTTP do uzyskania dostępu do archiwum na komputerze ftp.tlh.debian.org, w katalogu universe. Dla komputerów i386 używa tylko plików znalezionych w podkatalogu unstable/binary-i386, a dla komputerów amd64 - unstable/binary-amd64 i tak dalej dla innych obsługiwanych architektur. (Uwaga: ten przykład jest tylko ilustracją, jak używać zmiennych podstawienia, oficjalne archiwum Debiana nie zawiera takiej struktury).

    deb http://ftp.tlh.debian.org/universe unstable/binary-$(ARCH)/

ZOBACZ TAKŻE

apt-cache(8), apt.conf(5)

BUGS

Strona błędów APT[1]. Aby zgłosić błąd w APT, proszę przeczytać /usr/share/doc/debian/bug-reporting.txt lub opis polecenia reportbug(1).

TŁUMACZENIE

Tłumaczenie stron podręcznika: Robert Luberda <robert@debian.org>, 2000-2012. Tłumaczenie przewodnika offline: Krzysztof Fiertek <akfedux@megapolis.pl>, 2004

Proszę zauważyć, że przetłumaczony dokument może zawierać fragmenty nieprzetłumaczone. Ma to na celu uniknięcie utracenia istotnych informacji, w przypadkach gdy oryginał zostanie zaktualizowany, a tłumaczenie - nie.

AUTORZY

Jason Gunthorpe

zespół APT

PRZYPISY

1.  Strona błędów APT
    http://bugs.debian.org/src:apt