trunk/apt-howto/apt-howto.pl.sgml

<!doctype debiandoc system>
<debiandoc>

<book>

<title>APT HOWTO (Obsolete Documentation)</title>

<author>
<name>Gustavo Noronha Silva</name> <email>kov@debian.org</email>
</author>
<author>
<name>polskie tłumaczenie: Paweł Tęcza</name> <email>ptecza@debianusers.pl</email>
</author>

<version>1.8.5 - lipiec 2003</version>

<abstract>
Ten dokument ma na celu dobrze wyjaśnić użytkownikowi zasadę działania
narzędzia do zarządzania pakietami Debiana jakim jest APT. Jego celem
jest uczynienie łatwiejszym życia nowym użytkownikom Debiana oraz pomoc
tym jego użytkownikom, którzy chcieliby lepiej rozumieć administrowanie
systemem pakietów. Został on stworzony w ramach projektu Debian, aby pomóc
w polepszeniu wsparcia dla użytkowników tej dystrybucji.
</abstract>

<copyright>
<copyrightsummary>
Copyright &copy; 2001, 2002, 2003, 2004 Gustavo Noronha Silva
</copyrightsummary>
<p>
This manual is free software; you may redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2, or (at your option) any
later version.
</p>

<p>
This is distributed in the hope that it will be useful, but without
any warranty; without even the implied warranty of merchantability or
fitness for a particular purpose. See the GNU General Public License
for more details.
</p>

<p>
A copy of the GNU General Public License is available as
/usr/share/common-licenses/GPL in the Debian GNU/Linux distribution or
on the World Wide Web at the GNU General Public Licence. You can also
obtain it by writing to the Free Software Foundation, Inc., 59 Temple
Place - Suite 330, Boston, MA 02111-1307, USA.
</p>
</copyright>

<toc>

<chapt>Wprowadzenie
<p>
Na początku był plik .tar.gz. Użytkownicy musieli kompilować każdy program,
który chcieli używać w swoich systemach GNU/Linux. Kiedy stworzono Debiana,
uznano za niezbędne włączenie do systemu metody zarządzania pakietami
zainstalowanymi na komputerze pracującym pod jego kontrolą. Ten system
zarządzania pakietami nazwano <prgn>dpkg</prgn>. Tak więc słynne pojęcie
`pakietu' weszło do systemów GNU/Linux zanim firma Red Hat zdecydowała się
stworzyć swój własny system `rpm'.
<p>
Szybko uwagę twórców systemu GNU/Linux zajął nowy dylemat. Potrzebowali oni
bardzo szybkiego, praktycznego i sprawnego sposobu instalowania pakietów,
który automatycznie zarządzałby zależnościami między pakietami i troszczył
się o ich pliki konfiguracyjne podczas aktualizacji. I znów to właśnie Debian
wprowadził ten sposób i tak oto narodził się APT (Advanced Packaging Tool),
który został przystosowany do współpracy z pakietami rpm przez firmę
Conectiva, a następnie wykorzystany także przez inne dystrybucje.
<p>
Ten podręcznik nie opisuje apt-rpm, jak nazwano wersję APT-a zmodyfikowaną
przez firmę Conectiva, ale "łaty" do tego dokumentu, które by to robiły są
mile widziane.
<p>
Informacje zawarte w tym podręczniku dotyczą następnego stabilnego wydania
Debiana, które nosi nazwę kodową <tt>Sarge</tt>.
</chapt>

<chapt id="basico">Podstawowa konfiguracja

<sect id="sources.list">Plik /etc/apt/sources.list
<p>
Do części swoich operacji APT używa pliku zawierającego listę `źródeł',
z których mogą być pobierane pakiety. Tym plikiem jest
<tt>/etc/apt/sources.list</tt>.
<p>
Wpisy w tym pliku mają następujący format:

<p>
<example>
deb http://witryna.http.org/debian dystrybucja sekcja1 sekcja2 sekcja3
deb-src http://witryna.http.org/debian dystrybucja sekcja1 sekcja2 sekcja3
</example>

<p>
Oczywiście powyższe wpisy są fikcyjne i nie powinny być używane.
Pierwszym słowem w każdej linii jest <tt>deb</tt> lub <tt>deb-src</tt>,
które wskazuje typ archiwum. Mówi ono czy archiwum zawiera pakiety binarne
(<tt>deb</tt>), czyli skompilowane już pakiety, których zazwyczaj używamy
czy pakiety źródłowe (<tt>deb-src</tt>), którymi są oryginalne źródła
programów wraz z plikiem zawierającym opis (<tt>.dsc</tt>) oraz plikiem
przechowującym zmiany potrzebne do `zdebianizowania' programu
(<tt>.diff.gz</tt>).
<p>
Zwykle plik sources.list zawiera domyślnie następujące wpisy:

<p>
<example>
# See sources.list(5) for more information, especialy
# Remember that you can only use http, ftp or file URIs
# CDROMs are managed through the apt-cdrom tool.
deb http://http.us.debian.org/debian stable main contrib non-free
deb http://non-us.debian.org/debian-non-US stable/non-US main contrib non-free
deb http://security.debian.org stable/updates main contrib non-free

# Uncomment if you want the apt-get source function to work
#deb-src http://http.us.debian.org/debian stable main contrib non-free
#deb-src http://non-us.debian.org/debian-non-US stable/non-US main contrib non-free
</example>

<p>
Linie te są potrzebne do podstawowej instalacji Debiana. Pierwsza linia ze
słowem <tt>deb</tt> wskazuje na oficjane archiwum, druga na archiwum non-US,
a trzecia na archiwum z uaktualnieniami pakietów związanych z bezpieczeństwem
Debiana.
<p>
Dwie ostatnie linie są wykomentowane (za pomocą znaku `#' na początku linii),
więc apt-get po prostu je zignoruje. To są linie ze słowem <tt>deb-src</tt>,
które wskazują na pakiety źródłowe Debiana. Jeśli często pobierasz źródła
programów do testowania ich lub rekompilacji, to odkomentuj te linie.
<p>
Plik <tt>/etc/apt/sources.list</tt> może zawierać kilka typów linii.
APT wie jak sobie radzić z archiwami typu <tt>http</tt>, <tt>ftp</tt>,
<tt>file</tt> (lokalne pliki, np. katalog zawierający zamontowany system
plików ISO9660) i <tt>ssh</tt>.
<p>
Nie zapomnij wydać polecenia <tt>apt-get update</tt> po zmodyfikowaniu
zawartości pliku <tt>/etc/apt/sources.list</tt>. Jest to konieczne,
aby APT pobrał listy dostępnych pakietów ze źródeł wymienionych w tym
pliku.
</sect>

<sect id="dpkg-scanpackages">Jak używać APT-a lokalnie
<p>
Czasami masz dużo pakietów <tt>.deb</tt>, do których instalacji
chciałbyś/chciałabyś użyć APT-a, aby zajął się zależnościami.
<p>
Aby to zrobić stwórz najpierw katalog i umieść w nim pliki <tt>.deb</tt>,
które chcesz zindeksować, np.:
 
<p>
<example>
# mkdir /root/debs
</example>

<p>
Możesz zmodyfikować zapisywane w plikach kontrolnych ustawienia pakietów
znajdujących się w Twoim repozytorium przy pomocy pliku
<tt>unieważniającego</tt>. Wewnątrz tego pliku możesz zdefiniować jakieś
opcje unieważniające inne, które były dostarczone wraz z pakietem.
Odbywa się to w następujący sposób:

<p>
<example>
pakiet priorytet sekcja
</example>

<p>
gdzie `pakiet' jest nazwą pakietu, `priorytet' może przybierać wartości
`low', `medium' lub `high', a `sekcja' jest nazwą sekcji, do której należy
pakiet. Możesz nazwać ten plik jest tylko chcesz, będziesz musiał później
podać jego nazwę jako argument programu <prgn>dpkg-scanpackages</prgn>.
Jeśli nie masz ochoty na tworzenie pliku <tt>unieważniającego</tt>,
to zamiast niego możesz użyć urządzenia <file>/dev/null</file> przy
uruchamianiu programu <prgn>dpkg-scanpackages</prgn>.
<p>
Wciąż w katalogu /root wydaj polecenie:

<p>
<example>
# dpkg-scanpackages debs <var>plik</var> | gzip &gt; debs/Packages.gz
</example>

<p>
W powyższej linii <file>plik</file> to plik <tt>unieważniający</tt>,
zaś komenda tworzy plik <file>Packages.gz</file>, zawierający różne
informacje na temat pakietów, które są używane przez APT-a. Aby móc
używać pakietów, w pliku <tt>/etc/apt/sources.list</tt> dodaj linię:

<p>
<example>
deb file:/root debs/
</example>

<p>
Teraz już możesz używać poleceń APT-a tak, jak zwykle. Możesz także stworzyć
repozytorium źródeł. W tym celu musisz wykonać taką samą procedurę jak
wcześniej. Pamiętaj jednak, że będziesz potrzebować w katalogu plików
<tt>.orig.tar.gz</tt>, <tt>.dsc</tt> i <tt>.diff.gz</tt>, oraz że należy użyć
nazwy <tt>Sources.gz</tt> zamiast <tt>Packages.gz</tt>. Również program do
jego tworzenia jest inny. Nazywa się on <prgn>dpkg-scansources</prgn>.
Linia komend powinna wyglądać następująco:

<p>
<example>
dpkg-scansources debs | gzip &gt; debs/Sources.gz
</example>

<p>
Zauważ, że program <prgn>dpkg-scansources</prgn> nie potrzebuje pliku
<tt>unieważniającego</tt>. Do pliku <tt>/etc/apt/sources.list</tt>
powinniśmy wpisać:

<p>
<example>
deb-src file:/root debs/
</example>
</sect>

<sect id="netselect">Podejmowanie decyzji, który serwer lustrzany najlepiej
umieścić w pliku sources.list: netselect, netselect-apt
<p>
Często zadawanym pytaniem, zwłaszcza przez nowych użytkowników Debiana,
jest: "który serwer lustrzany z pakietami powinienem umieścić w pliku
<tt>sources.list</tt>?".
Jest wiele sposobów pozwalających wybrać serwer lustrzany. Eksperci zapewne
używają skryptów mierzących obciążenie różnych serwerów. Istnieje jednak
program, który zrobi to dla nas, a który nazywa się <prgn>netselect</prgn>.
<p>
Aby zainstalować program netselect, jak zwykle wydajemy polecenie:

<p>
<example>
# apt-get install netselect
</example>

<p>
Uruchomienie programu netselect bez podania parametrów spowoduje wyświetlenie
pomocy ekranowej. Gdy jednak uruchomimy go podając jako argument listę,
oddzielonych spacją, stacji (serwerów lustrzanych), to otrzymamy w wyniku
jedną z podanych maszyn. Wynik ten zależy od przybliżonego czasu powrotu
wysyłanych do stacji pakietów IP (tzw. ping) oraz od ilości stacji pośrednich
(przez które te pakiety "przechodzą" zanim dotrą do celu) i jest odwrotnie
proporcjonalny do przybliżonej prędkości pobierania (zatem, im mniejszy,
tym lepiej). Zwrócona w wyniku stacja ma najmniejszy wynik (pełna lista
wyników będzie widoczna po dodaniu opcji -vv). Spójrz na poniższy przykład:

<p>
<example>
# netselect ftp.debian.org http.us.debian.org ftp.at.debian.org download.unesp.br ftp.debian.org.br
  365 ftp.debian.org.br
#
</example>

<p>
Oznacza to, że spośród serwerów lustrzanych podanych jako parametry programu
netselect, najlepszym okazał się <tt>ftp.debian.org.br</tt>, który uzyskał
wynik 365 (Uwaga! Ten test został wykonany na moim komputerze a trasa,
którą pokonują pakiety IP zależy od miejsca, do którego podłączony jest
nasz komputer. Uzyskana wartość niekoniecznie będzie prawdziwą prędkością
na innych komputerach).
<p>
Teraz umieść najszybszy serwer lustrzany znaleziony przez netselect w pliku
<tt>/etc/apt/sources.list</tt> (patrz na sekcję <ref id="sources.list">)
i zastosuj porady z sekcji <ref id="apt-get">.
<p><strong>Uwaga:</strong> listę serwerów lustrzanych można zawsze znaleźć
w pliku <url id="http://www.debian.org/mirror/mirrors_full"
name="http://www.debian.org/mirror/mirrors_full">.
<p>
Poczynając od wersji 0.3, pakiet netselect zawiera skrypt
<prgn>netselect-apt</prgn>, który automatyzuje opisany powyżej proces.
Po prostu jako parametr skryptu podaj dystrybucję (domyślnie jest nią
dystrybucja stabilna), a wygeneruje on plik <tt>sources.list</tt>
z najlepszym serwerem lustrzanym zawierającym pakiety z sekcji main
i non-US i zapisze go w bieżącym katalogu. Poniższy przykład generuje
plik <tt>sources.list</tt> dla stabilnej dystrybucji.

<p>
<example>
# ls sources.list
ls: sources.list: File or directory not found
# netselect-apt stable
(...)
# ls -l sources.list
sources.list
#
</example>

<p>
<strong>Pamiętaj:</strong> plik <tt>sources.list</tt> zostanie wygenerowany
w bieżącym katalogu i musi być przeniesiony do katalogu <tt>/etc/apt</tt>.
<p>
Następnie przejdź do porad z sekcji <ref id="apt-get">.
</sect>

<sect id="cdrom">Dodawanie CD-ROM-u do pliku sources.list
<p>
Jeśli raczej używasz napędu CD-ROM do instalowania pakietów lub
automatycznego uaktualniania Twojego systemu przy pomocy APT-a,
to możesz go umieścić w pliku <tt>sources.list</tt>. Aby to zrobić,
możesz użyć programu <prgn>apt-cdrom</prgn> w poniższy sposób:

<p>
<example>
# apt-cdrom add
</example>

<p>
z umieszczoną w napędzie CD-ROM płytą z pakietami Debiana. Polecenie te
zamontuje napęd i poszuka na płycie informacji na temat pakietów.
Jeśli konfiguracja Twojego CD-ROM-u jest trochę nietypowa, możesz także
użyć następujących opcji:

<p>
<example>
-h         - Pomoc ekranowa do programu
-d katalog - Katalog, w którym montowany jest CD-ROM
-r         - Zmiana nazwy rozpoznanego CD-ROM-u
-m         - Bez montowania
-f         - Tryb szybki, bez sprawdzania plików z pakietami
-a         - Tryb dokładnego przeszukiwania
</example>

<p>
Na przykład:

<p>
<example>
# apt-cdrom -d /home/ala/mojcdrom add
</example>

<p>
Możesz także zidentyfikować swój CD-ROM, bez dodawania go do listy:

<p>
<example>
# apt-cdrom ident
</example>

<p>
Zwróć uwagę, że ten program będzie działał tylko wtedy, gdy Twój CD-ROM
jest właściwie skonfigurowany w systemowym pliku <tt>/etc/fstab</tt>. 
</sect>
</chapt>

<chapt id="apt-get">Zarządzanie pakietami
<sect id="update">Aktualizacja listy dostępnych pakietów
<p>
System zarządzania pakietami używa własnej bazy danych, w której przechowuje
informacje o tym, które pakiety są zainstalowane, które nie i które są
dostępne do instalacji. Program <prgn>apt-get</prgn> używa właśnie tej bazy
danych, aby dowiedzieć się jak zainstalować pakiety na życzenie użytkownika
i jakie dodatkowe pakiety są potrzebne, aby te wybrane przez użytkownika
działały prawidłowo.
<p>
Aby uaktualnić tą bazę danych należy użyć komendy <prgn>apt-get update</prgn>.
Przeszuka ona archiwa umieszczone w pliku <tt>/etc/apt/sources.list</tt>;
zobacz sekcję <ref id="sources.list">, aby uzyskać więcej informacji na temat
tego pliku.
<p>
Dobrym nawykiem jest uruchamiać tą komendę dosyć regularnie, aby stale
informować swój system o możliwych uaktualnieniach pakietów, zwłaszcza tych
związanych z jego bezpieczeństwem.
</sect>

<sect id="install">Instalacja pakietów
<p>
W końcu proces, na który wszyscy czekaliśmy! Gdy już mamy plik sources.list
z listą źródeł pakietów i wiemy jakie pakiety chcemy uaktualnić, to wszystko
co musimy zrobić, to uruchomić program <tt>apt-get</tt>, który pobierze
pakiety, które zamierzamy zainstalować. Dla przykładu możesz go wywołać
następująco:

<p>
<example>
# apt-get install xchat
</example>

<p>
APT poszuka w swojej bazie danych najnowszej wersji pakietu i pobierze go
z odpowiedniego archiwum, które podano w pliku <tt>sources.list</tt>.
Gdyby okazało się, że pakiet ten zależy od innego, tak jak w powyższym
przykładzie, to APT sprawdzi zależności i zainstaluje potrzebne pakiety.
Spójrz na ten przykład:

<p>
<example>
# apt-get install nautilus
Reading Package Lists... Done
Building Dependency Tree... Done
The following extra packages will be installed:
  bonobo libmedusa0 libnautilus0 
The following NEW packages will be installed:
  bonobo libmedusa0 libnautilus0 nautilus 
0 packages upgraded, 4 newly installed, 0 to remove and 1  not upgraded.
Need to get 8329kB of archives. After unpacking 17.2MB will be used.
Do you want to continue? [Y/n] 
</example>

<p>
Pakiet <package>nautilus</package> zależy od kilku wymienionych bibliotek
współdzielonych, dlatego APT pobierze je z archiwum. Gdybyś podał nazwy
tych bibliotek jako parametr wywołania programu <tt>apt-get</tt>, to APT
nie zapytałby Cię czy chcesz kontynuować, gdyż automatycznie założyłby,
że chciałeś je zainstalować.
<p>
Oznacza to, że APT tylko wtedy pyta Cię o potwierdzenie, gdy z powodu
zależności między pakietami konieczne jest zainstalowanie także innych
pakietów niż te podane przez Ciebie w linii komend.
<p>
Użyteczne mogą być następujące opcje programu apt-get:

<p>
<example>
-h  Pomoc ekranowa do programu
-d  Tylko pobranie pakietu, BEZ instalacji lub rozpakowania archiwum
-f  Próba kontynuowania, nawet jeśli sprawdzenie integralności kończy się niepowodzeniem
-s  Bez akcji. Wykonuje symulację polecenia
-y  Zakłada odpowiedź `Tak' na wszystkie zapytania i nie pyta o potwierdzenie
-u  Wyświetla również listę uaktualnionych pakietów
</example>

<p>
W jednej linii można podać wiele pakietów do instalacji. Pliki pobrane
z sieci są umieszczane do późniejszej instalacji w katalogu
<tt>/var/cache/apt/archives</tt>.
<p>
Możesz także w tej samej linii wymienić pakiety, które chcesz usunąć.
Po prostu umieść znak '-' bezpośrednio za nazwą pakietu do usunięcia,
tak jak pokazano poniżej:

<p>
<example>
# apt-get install nautilus gnome-panel-
Reading Package Lists... Done
Building Dependency Tree... Done
The following extra packages will be installed:
  bonobo libmedusa0 libnautilus0 
The following packages will be REMOVED:
  gnome-applets gnome-panel gnome-panel-data gnome-session
The following NEW packages will be installed:
  bonobo libmedusa0 libnautilus0 nautilus
0 packages upgraded, 4 newly installed, 4 to remove and 1  not upgraded.
Need to get 8329kB of archives. After unpacking 2594kB will be used.
Do you want to continue? [Y/n] 
</example>

<p>
Aby dowiedzieć się więcej na temat usuwania pakietów, zobacz sekcję
<ref id="remove">.
<p>
Gdybyś w jakiś sposób uszkodził zainstalowany pakiet, albo po prostu chciał
ponownie zainstalować jego najnowszą dostępną wersję, to możesz użyć opcji
<tt>--reinstall</tt>, jak pokazano poniżej:

<p>
<example>
# apt-get --reinstall install gdm
Reading Package Lists... Done
Building Dependency Tree... Done
0 packages upgraded, 0 newly installed, 1 reinstalled, 0 to remove and 1  not upgraded.
Need to get 0B/182kB of archives. After unpacking 0B will be used.
Do you want to continue? [Y/n]
</example>
</sect>

<sect id="remove">Usuwanie pakietów
<p>
Jeśli nie chcesz już dłużej używać jakiegoś pakietu, możesz go usunąć
ze swojego systemu za pomocą APT-a. Aby to zrobić, po prostu wpisz:
<tt>apt-get remove pakiet</tt>. Na przykład:

<p>
<example>
# apt-get remove gnome-panel
Reading Package Lists... Done
Building Dependency Tree... Done
The following packages will be REMOVED:
  gnome-applets gnome-panel gnome-panel-data gnome-session
0 packages upgraded, 0 newly installed, 4 to remove and 1  not upgraded.
Need to get 0B of archives. After unpacking 14.6MB will be freed.
Do you want to continue? [Y/n] 
</example>

<p>
Jak widać na powyższym przykładzie, APT troszczy się także o usunięcie
pakietów, które zależą od pakietu, który chcesz odinstalować. Za pomocą
APT-a nie można usunąć pakietu bez usunięcia tych pakietów, które zależą
od niego.
<p>
Uruchamiając program <prgn>apt-get</prgn> w taki sposób jaki pokazano powyżej
spowodujemy usunięcie pakietów, ale jeśli posiadały one pliki konfiguracyjne,
to pozostaną one nadal w systemie. Aby całkowicie usunąć pakiet uruchom
<prgn>apt-get</prgn> w następujący sposób:

<p>
<example>
# apt-get --purge remove gnome-panel
Reading Package Lists... Done
Building Dependency Tree... Done
The following packages will be REMOVED:
  gnome-applets* gnome-panel* gnome-panel-data* gnome-session* 
0 packages upgraded, 0 newly installed, 4 to remove and 1  not upgraded.
Need to get 0B of archives. After unpacking 14.6MB will be freed.
Do you want to continue? [Y/n] 
</example>

<p>
Zwróć uwagę na znak '*' na końcu nazwy pakietów. Sygnalizuje on, że pliki
konfiguracyjne każdego z pakietów także zostały usunięte.
<p>
Analogicznie jak dla metody <tt>install</tt>, możesz z opcją <tt>remove</tt>
użyć symbolu, który odwróci jej znaczenie. W przypadku usuwania pakietów,
jeśli za nazwą pakietu umieścisz znak <tt>'+'</tt>, to zostanie on
zainstalowany, a nie usunięty.

<p>
<example>
# apt-get --purge remove gnome-panel nautilus+
Reading Package Lists... Done
Building Dependency Tree... Done
The following extra packages will be installed:
  bonobo libmedusa0 libnautilus0 nautilus 
The following packages will be REMOVED:
  gnome-applets* gnome-panel* gnome-panel-data* gnome-session* 
The following NEW packages will be installed:
  bonobo libmedusa0 libnautilus0 nautilus 
0 packages upgraded, 4 newly installed, 4 to remove and 1  not upgraded.
Need to get 8329kB of archives. After unpacking 2594kB will be used.
Do you want to continue? [Y/n] 
</example>

<p>
Zauważ, że program <prgn>apt-get</prgn> wyświetla dodatkowe pakiety,
które zostaną zainstalowane (tzn. te pakiety, których instalacja jest
potrzebna do poprawnego działania pakietów, które chce zainstalować
użytkownik), pakiety które zostaną usunięte i te, które zostaną
zainstalowane (ponownie włączając dodatkowe pakiety).
</sect>

<sect id="upgrade">Aktualizacja pakietów
<p>
Możliwość aktualizacji pakietów to wielkie osiągnięcie systemu APT. Odbywa
się to za pomocą pojedynczej komendy: <tt>apt-get upgrade</tt>. Możesz jej
użyć zarówno do aktualizacji pakietów z tej samej dystrybucji, jak i by
zaktualizować całą dystrybucję, chociaż do tego celu jest raczej preferowana
komenda <tt>apt-get dist-upgrade</tt>; zobacz sekcję <ref id="dist-upgrade">,
jeśli chcesz się więcej dowiedzieć na ten temat.
<p>
Warto uruchomić tą komendę z opcją <tt>-u</tt>. Spowoduje ona, że APT
wyświetli kompletną listę pakietów, które zostaną zaktualizowane. Bez niej
nie będziesz wiedział jakie pakiety aktualizujesz. APT pobierze najnowsze
wersje każdego pakietu i zainstaluje je w odpowiedniej kolejności.
Bardzo ważne jest uruchamianie <tt>apt-get update</tt> zawsze przed
wydaniem polecenia <tt>apt-get upgrade</tt>. Zobacz sekcję <ref id="update">,
aby dowiedzieć się więcej szczegółów na jego temat. Spójrz także na poniższy
przykład:

<p>
<example>
# apt-get -u upgrade
Reading Package Lists... Done
Building Dependency Tree... Done
The following packages have been kept back
  cpp gcc lilo 
The following packages will be upgraded
  adduser ae apt autoconf debhelper dpkg-dev esound esound-common ftp indent
  ipchains isapnptools libaudiofile-dev libaudiofile0 libesd0 libesd0-dev
  libgtk1.2 libgtk1.2-dev liblockfile1 libnewt0 liborbit-dev liborbit0
  libstdc++2.10-glibc2.2 libtiff3g libtiff3g-dev modconf orbit procps psmisc 
29 packages upgraded, 0 newly installed, 0 to remove and 3 not upgraded.
Need to get 5055B/5055kB of archives. After unpacking 1161kB will be used.
Do you want to continue? [Y/n] 
</example>

<p>
Proces uaktualniania pakietów jest bardzo prosty. Zauważ, że w pierwszych
kilku liniach APT informuje, które pakiety zostaną <tt>pozostawione
nietknięte</tt>. Oznacza to, że istnieją nowsze wersje tych pakietów,
ale z jakichś powodów nie zostaną zainstalowane. Przyczynami takiego stanu
mogą być zepsute zależności (pakiet, od którego zależy nie ma dostępnej
wersji do pobrania) lub nowe zależności (pakiet w ostatniej wersji zależy
od nowego pakietu).
<p>
W pierwszym przypadku nie ma prostego rozwiązania. W drugim wystarczy
uruchomić komendę <tt>apt-get install</tt>, aby zainstalować specyficzny
pakiet wraz z zależnościami. Jeszcze prostszym rozwiązaniem jest użycie
komendy <tt>dist-upgrade</tt>. Zobacz sekcję <ref id="dist-upgrade">,
aby dowiedzieć się więcej na ten temat.
</sect>

<sect id="dist-upgrade">Aktualizacja do nowego wydania
<p>
Ta zdolność APT-a pozwala Ci uaktualnić cały system Debian za jednym razem,
zarówno poprzez sieć Internet jaki i z nowej płyty CD (nabytej lub pobranej
w postaci obrazu ISO).
<p>
Jest ona również używana, gdy ulegają zmianie relacje pomiędzy zainstalowanymi
pakietami. Dzięki poleceniu <tt>apt-get upgrade</tt>, pakiety te pozostaną
w spokoju (<tt>pozostawione nietknięte</tt>).
<p>
Dla przykładu, przypuśćmy że używamy wydania nr 0 stabilnej wersji Debiana
i kupujemy płytę CD z wydaniem nr 3. Możemy użyć APT-a do aktualizacji
systemu z tej nowej płyty CD. W tym celu najpierw użyj programu
<prgn>apt-cdrom</prgn> (więcej szczegółów w sekcji <ref id="cdrom">),
aby dodać tą płytę do pliku <tt>/etc/apt/sources.list</tt>, a następnie
uruchom program <tt>apt-get dist-upgrade</tt>.
<p>
Jest ważną rzeczą zauważenie, że APT zawsze szuka najnowszych wersji
pakietów. Dlatego, jeśli Twój plik <tt>/etc/apt/sources.list</tt> zawiera
listę archiwów z nowszymi wersjami pakietów niż na płycie CD, to APT nie
pobierze ich z płyty, lecz właśnie stamtąd.
<p>
W przykładzie pokazanym w sekcji <ref id="upgrade"> widzieliśmy, że część
pakietów została <tt>pozostawiona nietknięta</tt>. Teraz możemy rozwiązać
ten problem właśnie za pomocą metody <tt>dist-upgrade</tt>:

<p>
<example>
# apt-get -u dist-upgrade
Reading Package Lists... Done
Building Dependency Tree... Done
Calculating Upgrade... Done
The following NEW packages will be installed:
  cpp-2.95 cron exim gcc-2.95 libident libopenldap-runtime libopenldap1
  libpcre2 logrotate mailx 
The following packages have been kept back
  lilo 
The following packages will be upgraded
  adduser ae apt autoconf cpp debhelper dpkg-dev esound esound-common ftp gcc
  indent ipchains isapnptools libaudiofile-dev libaudiofile0 libesd0
  libesd0-dev libgtk1.2 libgtk1.2-dev liblockfile1 libnewt0 liborbit-dev
  liborbit0 libstdc++2.10-glibc2.2 libtiff3g libtiff3g-dev modconf orbit
  procps psmisc 
31 packages upgraded, 10 newly installed, 0 to remove and 1 not upgraded.
Need to get 0B/7098kB of archives. After unpacking 3118kB will be used.
Do you want to continue? [Y/n]
</example>

<p>
Zauważ teraz, że pakiety zostaną zaktualizowane i że zostaną też
zainstalowane nowe pakiety (nowe zależności tych pakietów). Zauważ również,
iż lilo wciąż <tt>pozostaje nietknięte</tt>. Przyczyną tego problemu jest
zapewne coś więcej niż nowa zależność. Odnajdziemy ją uruchamiając:

<p>
<example>
# apt-get -u install lilo
Reading Package Lists... Done
Building Dependency Tree... Done
The following extra packages will be installed:
  cron debconf exim libident libopenldap-runtime libopenldap1 libpcre2
  logrotate mailx 
The following packages will be REMOVED:
  debconf-tiny 
The following NEW packages will be installed:
  cron debconf exim libident libopenldap-runtime libopenldap1 libpcre2
  logrotate mailx 
The following packages will be upgraded
  lilo 
1 packages upgraded, 9 newly installed, 1 to remove and 31 not upgraded.
Need to get 225kB/1179kB of archives. After unpacking 2659kB will be used.
Do you want to continue? [Y/n]
</example>

<p>
Jak widać powyżej, lilo ma nowy konflikt z pakietem
<package>debconf-tiny</package>, który uniemożliwia jego instalację
(lub uaktualnienienie) bez usunięcia pakietu <package>debconf-tiny</package>.
<p>
Aby przekonać się, co było przyczyną pozostawienia pakietu nietkniętym
lub usunięcia pakietu możemy użyć poniższego polecenia:

<p>
<example>
# apt-get -o Debug::pkgProblemResolver=yes dist-upgrade
Reading Package Lists... Done
Building Dependency Tree... Done
Calculating Upgrade... Starting
Starting 2
Investigating python1.5
Package python1.5 has broken dep on python1.5-base
  Considering python1.5-base 0 as a solution to python1.5 0
  Holding Back python1.5 rather than change python1.5-base
Investigating python1.5-dev
Package python1.5-dev has broken dep on python1.5
  Considering python1.5 0 as a solution to python1.5-dev 0
  Holding Back python1.5-dev rather than change python1.5
 Try to Re-Instate python1.5-dev
Done
Done
The following packages have been kept back
  gs python1.5-dev 
0 packages upgraded, 0 newly installed, 0 to remove and 2  not upgraded.
</example>

<p>
W ten sposób można łatwo sprawdzić, że pakiet python1.5-dev nie może zostać
zainstalowany z powodu niespełnienia zależności przez pakiet python1.5.
</sect>

<sect id="clean">Usuwanie niepotrzebnych plików z pakietami: apt-get clean
i autoclean
<p>
W czasie instalowania pakietu APT pobiera niezbędne pliki z serwera
wskazanego w pliku <file>/etc/apt/sources.list</file>, umieszcza je
w lokalnym repozytorium (<file>/var/cache/apt/archives/</file>),
a następnie instaluje w sposób opisany w sekcji <ref id="install">.
<p>
Z czasem lokalne repozytorium może się rozrosnąć i zająć dużą ilość
przestrzeni dysku. Na szczęście APT jest wyposażony w narzędzia,
które umożliwiają zarządzanie lokalnym repozytorium. Należą do nich
metody <tt>clean</tt> i <tt>autoclean</tt> programu <prgn>apt-get</prgn>.
<p>
<prgn>apt-get clean</prgn> usuwa wszystkie pliki z wyjątkiem plików
"blokujących" (ang. lock files) z katalogów
<file>/var/cache/apt/archives/</file>
i <file>/var/cache/apt/archives/partial/</file>. Jednakże, jeśli będziesz
chciał ponownie zainstalować pakiet, to APT jeszcze raz pobierze niezbędne
pliki.
<p>
<prgn>apt-get autoclean</prgn> usuwa tylko te pliki, które nie będą mogły
być później pobrane z Sieci.
<p>
Poniższy przykład pokazuje w jaki sposób działa metoda <tt>autoclean</tt>:

<p>
<example>
# ls /var/cache/apt/archives/logrotate* /var/cache/apt/archives/gpm*
logrotate_3.5.9-7_i386.deb
logrotate_3.5.9-8_i386.deb
gpm_1.19.6-11_i386.deb
</example>

<p>
W katalogu <file>/var/cache/apt/archives</file> znajdują się dwa pliki
z pakietem <package>logrotate</package> i jeden z pakietem
<package>gpm</package>.

<p>
<example>
# apt-show-versions -p logrotate
logrotate/stable uptodate 3.5.9-8
# apt-show-versions -p gpm
gpm/stable upgradeable from 1.19.6-11 to 1.19.6-12
</example>

<p>
Program <prgn>apt-show-versions</prgn> informuje, że plik
<file>logrotate_3.5.9-8_i386.deb</file> zawiera najnowszą wersję pakietu
<package>logrotate</package>, a zatem plik
<file>logrotate_3.5.9-7_i386.deb</file> jest już bezużyteczny.
Także plik <file>gpm_1.19.6-11_i386.deb</file> nie będzie dłużej potrzebny,
gdyż dostępna jest już nowsza wersja pakietu <package>gpm</package>.

<p>
<example>
# apt-get autoclean
Reading Package Lists... Done
Building Dependency Tree... Done
Del gpm 1.19.6-11 [145kB]
Del logrotate 3.5.9-7 [26.5kB]
</example>

<p>
Jak widać powyżej, <tt>apt-get autoclean</tt> usuwa tylko stare pliki.
Więcej informacji na temat programu <prgn>apt-show-versions</prgn> można
znaleźć w sekcji <ref id="apt-show-versions">.
</sect>

<sect id="dselect-upgrade">Używanie APT-a razem z programem dselect
<p>
<prgn>dselect</prgn> jest programem, który pomaga użytkownikom Debiana
wybrać pakiety, które chcą zainstalować. Jest uważany za nieco skomplikowany
i dość nieciekawy, ale jeśli nabierzesz wprawy, to będziesz się swobodnie
posługiwał jego konsolowym interfejsem.
<p>
Jedną z cech programu dselect jest to, że informuje o tym, które jeszcze
pakiety Debiana są "zalecane" i "proponowane" do zainstalowania.
Aby użyć tego programu, jako root uruchom <tt>`dselect'</tt>. Wybierz 'apt'
jako metodę dostępu. Nie jest to w rzeczywistości niezbędne, ale jeśli
nie używasz CD-ROM-u i chcesz pobierać pakiety z Internetu, to jest to
najlepszy sposób używania dselecta.
<p>
Aby jeszcze lepiej zrozumieć w jaki sposób używać dselecta, przeczytaj
dokumentacje do niego, którą można znaleźć na stronie
<url id="http://www.debian.org/doc/ddp" name="http://www.debian.org/doc/ddp">.
<p>
Po wybraniu pakietów przy pomocy dselecta, użyj:

<p>
<example>
# apt-get -u dselect-upgrade
</example>

<p>
tak, jak to pokazano na przykładzie poniżej:

<p>
<example>
# apt-get -u dselect-upgrade
Reading Package Lists... Done
Building Dependency Tree... Done
The following packages will be REMOVED:
  lbxproxy 
The following NEW packages will be installed:
  bonobo console-tools-libs cpp-3.0 enscript expat fingerd gcc-3.0
  gcc-3.0-base icepref klogd libdigest-md5-perl libfnlib0 libft-perl
  libgc5-dev libgcc300 libhtml-clean-perl libltdl0-dev libsasl-modules
  libstdc++3.0 metamail nethack proftpd-doc psfontmgr python-newt talk tidy
  util-linux-locales vacation xbill xplanet-images 
The following packages will be upgraded
  debian-policy 
1 packages upgraded, 30 newly installed, 1 to remove and 0  not upgraded.
Need to get 7140kB of archives. After unpacking 16.3MB will be used.
Do you want to continue? [Y/n]
</example>

<p>
Porównaj to z tym, co widzisz, gdy uruchamiasz <tt>apt-get dist-upgrade</tt>
w tym samym systemie.

<p>
<example>
# apt-get -u dist-upgrade
Reading Package Lists... Done
Building Dependency Tree... Done
Calculating Upgrade... Done
The following packages will be upgraded
  debian-policy 
1 packages upgraded, 0 newly installed, 0 to remove and 0  not upgraded.
Need to get 421kB of archives. After unpacking 25.6kB will be freed.
Do you want to continue? [Y/n]
</example>

<p>
Zwróć uwagę, iż wiele z powyższych pakietów będzie instalowana, ponieważ są
"zalecane" lub "proponowane" przez inne. Pozostałe pakiety będą instalowane
lub usunięte (np. w przypadku pakietu lbxproxy) zgodnie z naszym wyborem,
którego dokonaliśmy przy użyciu dselecta. Dselect może być naprawdę potężnym
narzędziem, gdy jest używany razem z APT-em.
</sect>

<sect id="default-version">Jak utrzymywać "wymieszany" system
<p>
Czasami ludzie chcą używać jednej z wersji Debiana jako ich głównego
systemu i jednego lub kilku pakietów z innej wersji.
<p>
Aby określić, która wersja Debiana jest Twoją wersją główną, w pliku
<file>/etc/apt/apt.conf</file> powinieneś umieścić linię:

<p>
<example>
APT::Default-Release "<var>wersja</var>";
</example>
<p>
gdzie <var>wersja</var> jest wersją Debiana, którą chcesz używać
jako swojej głównej dystrybucji. Wersjami, których możesz używać
są <tt>stable</tt> (`stabilna'), <tt>testing</tt> (`testowa')
i <tt>unstable</tt> (`niestabilna'). Aby zainstalować pakiet z innej
wersji musisz użyć APT-a w następujący sposób:

<p>
<example>
# apt-get -t <var>dystrybucja</var> install <var>pakiet</var>
</example>

<p>
Aby polecenie zadziałało, potrzebujesz przynajmniej jednej linii
w pliku <file>/etc/apt/sources.list</file> ze źródłem pakietów dla
dystrybucji, z której pakiet chcesz zainstalować i źródło te musi
zawierać ten pakiet.
<p>
Możesz również dokładnie określić wersję instalowanego pakietu używając
składni:

<p>
<example>
# apt-get install <var>pakiet</var>=<var>wersja</var>
</example>

<p>
Dla przykładu, poniższa linia zainstaluje wersję <tt>2.2.4-1</tt>
pakietu <package>nautilus</package>:

<p>
<example>
# apt-get install nautilus=2.2.4-1
</example>

<p>
<em>WAŻNE</em>: `niestabilna' wersja Debiana to wersja, do której w
pierwszej kolejności trafiają najnowsze wersje pakietów <tt>.deb</tt>.
W tej dystrybucji widoczne są wszystkie zmiany pakietów, od tych drobnych
do tych bardzo poważnych, które wpływają na wiele innych pakietów, a nawet
cały system. Z tego powodu ta wersja dystrybucji <em>nie</em> powinna być
używana przez niedoświadczonych użytkowników oraz tych, którzy potrzebują
stabilnego systemu.
<p>
Wersja `testowa' dystrybucji jest trochę lepsza od `niestabilnej' pod
względem stabilności, ale systemy produkcyjne powinny używać wersji
`stabilnej'.
</sect>

<sect id="apt-show-versions">Jak uaktualniać pakiety do nowszej wersji
z określonej wersji Debiana
<p>
Program <prgn>apt-show-versions</prgn> umożliwia użytkownikom "wymieszanych"
dystrybucji bezpieczne uaktualnienie swoich systemów bez ryzyka obniżenia
ich dotychczasowej stabilności. Dla przykładu, istnieje możliwość
uaktualnienia do nowszej wersji Twoich niestabilnych pakietów po
zainstalowaniu pakietu <package>apt-show-versions</package>:

<p>
<example>
# apt-get install `apt-show-versions -u -b | grep unstable`
</example>
</sect>

<sect id="pin">Jak zachować określone wersje zainstalowanych pakietów
<p>
Możesz mieć okazję modyfikować coś w pakiecie i nie mieć czasu lub chęci,
aby dokonywać tych zmian w nowych wersjach programów. Możesz też dla
przykładu uaktualnić swoją dystrybucję Debiana do wersji 3.0, ale chcieć
wciąż używać pewnych wersji pakietów z Debiana 2.2. Możesz "przyszpilić"
wersję pakietu, którą zainstalowałeś i która nie będzie uaktualniona.
<p>
Używanie tego sposobu jest proste. Po prostu musisz wyedytować plik
<tt>/etc/apt/preferences</tt>.
<p>
Jego format jest także prosty:

<p>
<example>
Package: &lt;pakiet&gt;
Pin: &lt;definicja "przyszpilenia"&gt;
Pin-Priority: &lt;priorytet "przyszpilenia"&gt;
</example>

<p>
Na przykład, aby zachować pakiet <package>sylpheed</package>,
który zmodyfikowałem, po to by móc używać opcji "reply-to-list" w wersji
0.4.99, dodałem:

<p>
<example>
Package: sylpheed
Pin: version 0.4.99*
</example>

<p>
Zauważ, że użyłem znaku <tt>*</tt> (gwiazdka). To jest tzw. "znak zastępczy",
który mówi, że chcę "przyszpilić" wszystkie wersje pakietów rozpoczynające
się od numeru 0.4.99. Tak jest z powodu wersji tych pakietów Debiana
i "debianowych korekt" i nie chcę uniknąć instalacji tych korekt.
Zatem, dla przykładu, wersje 0.4.99-1 i 0.4.99-10 zostaną zainstalowane,
gdy tylko będą dostępne. Zwróć uwagę, że jeśli zmodyfikowałeś pakiet,
nie będziesz chciał robić tych rzeczy w ten sposób.
<p>
Pole <tt>Pin-Priority</tt> jest opcjonalne; jeśli nie zostało określone,
to domyślnie przyjmuje wartość 989.
<p>
Przyjrzyjmy się jak działa priorytet "przyszpilenia". Priorytet mniejszy
niż 0 wskazuje, że pakiet nigdy nie powinien być zainstalowany. Priorytety o
wartościach od 0 do 100 wskazują pakiety, które nie są zainstalowane i które
nie mają dostępnych wersji. Nie będą one brać udziału w procesie wyboru
wersji. Priorytet równy 100 jest priorytetem przypisanym do zainstalowanego
pakietu, aby zainstalowana wersja pakietu została zastąpiona przez inną
wersję, wersja ta musi mieć priorytet większy niż 100.
<p>
Priorytety powyżej 100 wskazują, że pakiet powinien być zainstalowany.
Zwykle zainstalowana wersja pakietu jest zmieniana tylko w czasie
aktualizacji do nowszej wersji. Priorytety o wartościach pomiędzy 100 i 1000
(włącznie) wskazują te typowe zachowanie. Pakiet z takim priorytetem nie
zostanie umniejszony do dostępnej wersji o mniejszym numerze. Na przykład
jeśli mam zainstalowaną wersję 0.5.3 pakietu sylpheed i zdefiniuję
"przyszpilenie" wersji 0.4.99 tego pakietu z priorytetem 999, to wersja
0.4.99 <em>nie</em> zostanie zainstalowana, aby spełnić "przyszpilenie".
Aby uczynić pakiet "zmniejszonym" i spełnić "przyszpilenie" musisz ustawić
priorytet na wartość większą niż 1000.
<p>
Przyszpilenie można określić na <tt>wersji</tt>, <tt>wydaniu</tt>
lub <tt>pochodzeniu</tt> pakietu.
<p>
Przyszpilenie <tt>wersji</tt>, tak jak widzieliśmy, wspiera dosłowne numery
wersji, jak i znaki zastępcze w celu określenia kilku wersji jednocześnie.
<!-- what's available?  standard shell globs?  ?*[]   or more? -->
<p>
Opcja <tt>wydanie</tt> zależy od pliku Release z repozytorium APT-a lub
z płyty CD. Opcja ta może nie być użyteczna zawsze jeśli używasz repozytoriów
pakietów, które nie dostarczają tego pliku. Możesz zobaczyć zawartość plików
Release, które masz w pliku <tt>/var/lib/apt/lists/</tt>. Parametrami dla
wydania są <tt>a</tt> (archiwum), <tt>c</tt> (komponenty), <tt>v</tt>
(wersja), <tt>o</tt> (pochodzenie) and <tt>l</tt> (etykieta).
<p>
Przykład:

<p>
<example>
Package: *
Pin: release v=2.2*,a=stable,c=main,o=Debian,l=Debian
Pin-Priority: 1001
</example>

<p>
W tym przykładzie wybraliśmy wersję Debiana 2.2* (którą może być dla
przykładu korekta 2.2r2 albo 2.2r3 - określa ona tzw. "punkt wydania",
który zwykle zawiera nowe poprawki bezpieczeństwa i inne bardzo ważne
uaktualnienia), repozytorium <tt>stable</tt>, sekcję <tt>main</tt>
(w przeciwieństwie do sekcji <tt>contrib</tt> lub <tt>non-free</tt>)
oraz pochodzenie i etykietę Debian. Pochodzenie (o=) definiuje kto stworzył
plik Release, a etykieta (l=) - nazwę dystrybucji, na przykład Debian dla
Debiana, Progeny dla Progeny. Oto przykładowy plik Release:

<p>
<example>
$ cat /var/lib/apt/lists/ftp.debian.org.br_debian_dists_potato_main_binary-i386_Release
Archive: stable
Version: 2.2r3
Component: main
Origin: Debian
Label: Debian
Architecture: i386
</example>
</sect>
</chapt>

<chapt id="helpers">Bardzo użyteczni pomocnicy
<sect id="equivs">Jak zainstalować lokalnie skompilowane pakiety: pakiet equivs
<p>
Czasami użytkownicy Debiana chcą używać specyficznej wersji jakiegoś
programu, który nie posiada pakietu <tt>.deb</tt> i jest dostępny tylko
w postaci kodu źródłowego. Instalacja takich programów może jednak
spowodować problemy w działaniu systemu pakietów. Wyobraźmy sobie na
przykład, że chcemy skompilować nową wersję naszego serwera pocztowego.
Wszystko poszło świetnie, tylko że zapomnieliśmy o małym szczególe:
w Debianie wiele pakietów zależy od agenta pocztowego MTA (ang. Mail
Transport Agent), a system pakietów niestety nic nie wie o programie,
który sami skompilowaliśmy ze źródeł i zainstalowaliśmy!
<p>
W takich właśnie przypadkach z pomocą przychodzi nam pakiet
<package>equivs</package>. Aby móc z niego skorzystać, należy zainstalować
pakiet o takiej samej nazwie. Cóż on takiego robi? Tworzy pusty pakiet,
który potrafi w pełni spełnić zależności i sprawia, że system pakietów jest
przekonany o tym, iż zależności są spełnione.
<p>
Zanim pokażemy jak używać tego pakietu, należy jeszcze przypomnieć,
że istnieją bezpieczniejsze sposoby kompilacji programu, który posiada już
pakiet Debiana i że nie należy używać pakietu <package>equivs</package> do
zastępowania zależności, gdy nie wiemy jak to zrobić. Więcej informacji na
ten temat można znaleźć w sekcji <ref id="sourcehandling">.
<p>
Kontynuujmy nasz przykład z agentem pocztowym MTA. Powiedzmy, że właśnie
skompilowałeś i zainstalowałeś nową wersję serwera <prgn>postfix</prgn>,
a teraz zamierzasz zainstalować pakiet <package>mutt</package>.
Nagle okazuje się, że <package>mutt</package> chce zainstalować innego
agenta MTA, a Ty już masz przecież swój.
<p>
Przejdź wtedy do jakiegoś katalogu (np. do <file>/tmp</file>) i wydaj
komendę:

<p>
<example>
# equivs-control <var>nazwa</var>
</example>

<p>
gdzie <var>nazwa</var> to nazwa pliku kontrolnego, który chcesz stworzyć.
Plik ten będzie miał następującą zawartość:

<p>
<example>
Section: misc
Priority: optional
Standards-Version: 3.0.1

Package: &lt;enter package name; defaults to equivs-dummy&gt;
Version: &lt;enter version here; defaults to 1.0&gt;
Maintainer: &lt;your name and email address; defaults to username&gt;
Pre-Depends: &lt;packages&gt;
Depends: &lt;packages&gt;
Recommends: &lt;packages&gt;
Suggests: &lt;package&gt;
Provides: &lt;(virtual)package&gt;
Architecture: all
Copyright: &lt;copyright file; defaults to GPL2&gt;
Changelog: &lt;changelog file; defaults to a generic changelog&gt;
Readme: &lt;README.Debian file; defaults to a generic one&gt;
Extra-Files: &lt;additional files for the doc directory, comma separated&gt;
Description: &lt;short description; defaults to some wise words&gt;
 long description and info
 .
 second paragraph
</example>

<p>
Teraz musimy tak go zmodyfikować, żeby robił to, co chcemy. Spójrzmy na
format pól i ich opisy. Nie ma oczywiście potrzeby objaśniać każdego z nich.
Zróbmy tylko to, co jest niezbędne: 

<p>
<example>
Section: misc
Priority: optional
Standards-Version: 3.0.1

Package: mta-local
Provides: mail-transport-agent
</example>

<p>
Tak, to naprawdę wszystko, czego nam potrzeba! Pakiet <package>mutt</package>
zależy od pakietu wirtualnego <tt>mail-transport-agent</tt>,
którego dostarczają wszystkie agenty MTA. Mogłem też nazwać pakiet po prostu
<tt>mail-transport-agent</tt>, ale wolę używać schematu pakietów wirtualnych,
który wykorzystuje pole `Provides'.
<p>
Teraz tylko musimy zbudować pakiet:

<p>
<example>
# equivs-build <var>nazwa</var>
dh_testdir
touch build-stamp
dh_testdir
dh_testroot
dh_clean -k
# Add here commands to install the package into debian/tmp.
touch install-stamp
dh_testdir
dh_testroot
dh_installdocs
dh_installchangelogs
dh_compress
dh_fixperms
dh_installdeb
dh_gencontrol
dh_md5sums
dh_builddeb
dpkg-deb: building package `<var>nazwa</var>' in `../<var>nazwa</var>_1.0_all.deb'.

The package has been created.
Attention, the package has been created in the current directory,
</example>

<p>
i zainstalować powstały pakiet <tt>.deb</tt>.
<p>
Jak widać, pakietu <package>equivs</package> można używać na różne sposoby.
Za jego pomocą można nawet stworzyć pakiet <package>moje-ulubione</package>,
który zależy od programów, które zwykle instalujesz. To jak go wykorzystasz
zależy tylko od Twojej wyobraźni, ale bądź ostrożny!
<p>
Na koniec jeszcze jedna ważna uwaga: przykłady plików kontrolnych znajdują
się w katalogu <file>/usr/share/doc/equivs/examples</file>. Przyjrzyj się im.
</sect>

<sect id="localepurge">Usuwanie nieużywanych plików lokalizacyjnych: pakiet
localpurge
<p>
Wielu użytkowników Debiana korzysta tylko z jednych plików lokalizacyjnych.
Dla przykładu, brazylijscy użytkownicy Debiana przez cały czas korzystają
z plików <tt>pt_BR</tt> i do niczego im nie są potrzebne pliki <tt>es</tt>.
<p>
Pakiet <package>localepurge</package> jest bardzo użytecznym narzędziem dla
takich właśnie użytkowników. Pozwala on zaoszczędzić wiele miejsca na dysku,
dzięki zachowaniu tylko tych plików lokalizacyjnych, których naprawdę
używasz. Aby go zainstalować, po prostu wydaj komendę
<tt>apt-get install localepurge</tt>.
<p>
Pakiet ten jest bardzo łatwy w konfiguracji, debconf przeprowadzi Cię przez
ten proces krok po kroku. Bądź jednak bardzo ostrożny w czasie odpowiadania
na zadawane Ci pytania, gdyż zła odpowiedź może usunąć wszystkie pliki
lokalizacyjne, nawet te, których używasz! Jedynym sposobem na odzyskanie ich
wtedy jest powtórna instalacja wszystkich pakietów, które dostarczają tych
plików.
</sect>

<sect id="helper-show-versions">Jak się dowiedzieć, które pakiety mogą być
uaktualnione do nowszej wersji
<p>
Programem, który potrafi wskazać pakiety mogące być uaktualnione do nowszej
wersji oraz dostarczyć wielu innych użytecznych informacji jest program
<prgn>apt-show-versions</prgn>. Do wyświetlenia listy pakietów, które mogą
być uaktualnione służy opcja <tt>-u</tt>:

<p>
<example>
$ apt-show-versions -u    
libeel0/unstable upgradeable from 1.0.2-5 to 1.0.2-7
libeel-data/unstable upgradeable from 1.0.2-5 to 1.0.2-7
</example>
</sect>

<chapt id="search">Pobieranie informacji o pakietach
<p>
Jest wiele programów-nakładek dla systemu APT, które bardzo ułatwiają
pobieranie listy pakietów dostępnych do instalacji i już zainstalowanych,
pozwalają dowiedzieć się do jakiej sekcji należy pakiet, jaki jest jego
priorytet, jaki ma opis, itd.
<p>
Ale... naszym celem jest nauczyć się posługiwania się czystym APT-em.
Zatem w jaki sposób dowiedzieć się nazwy pakietu, który chcemy zainstalować?
<p>
Mamy wiele środków do tego zadania. Zacznijmy od programu <tt>apt-cache</tt>.
Jest on używany przez system APT do zarządzania jego bazą danych.
Przyjrzymy się krótko jego bardziej praktycznym zastosowaniom.

<sect id="cache">Odnajdywanie nazw pakietów
<p>
Dla przykładu przypuśćmy, że chcemy powspominać o starych, dobrych czasach
Atari 2600. Najpierw chcemy użyć APT-a do instalacji emulatora Atari,
a następnie do pobrania kilku gier dla niego. Możemy to zrobić następująco:

<p>
<example>
# apt-cache search atari
atari-fdisk-cross - Partition editor for Atari (running on non-Atari)
circuslinux - The clowns are trying to pop balloons to score points!
madbomber - A Kaboom! clone
tcs - Character set translator.
atari800 - Atari emulator for svgalib/X/curses
stella - Atari 2600 Emulator for X windows
xmess-x - X binaries for Multi-Emulator Super System
</example>

<p>
Znaleźliśmy kilka pakietów powiązanych z tym, czego szukamy, wraz z ich
krótkimi opisami. Aby uzyskać więcej informacji na temat określonego
pakietu, możesz wtedy użyć:

<p>
<example>
# apt-cache show stella  
Package: stella
Priority: extra
Section: non-free/otherosfs
Installed-Size: 830
Maintainer: Tom Lear &lt;tom@trap.mtview.ca.us&gt;
Architecture: i386
Version: 1.1-2
Depends: libc6 (&gt;= 2.1), libstdc++2.10, xlib6g (&gt;= 3.3.5-1)
Filename: dists/potato/non-free/binary-i386/otherosfs/stella_1.1-2.deb
Size: 483430
MD5sum: 11b3e86a41a60fa1c4b334dd96c1d4b5
Description: Atari 2600 Emulator for X windows
 Stella is a portable emulator of the old Atari 2600 video-game console
 written in C++.  You can play most Atari 2600 games with it.  The latest
 news, code and binaries for Stella can be found at:
 http://www4.ncsu.edu/~bwmott/2600
</example>

<p>
Otrzymaliśmy w wyniku wiele szczegółów na temat pakietu, który chcemy
(lub który nie chcemy) zainstalować, razem z jego pełnym opisem.
Jeśli pakiet jest już zainstalowany w systemie i jest tam jego nowsza
wersja, to zobaczysz informacje na temat obu wersji. Na przykład:

<p>
<example>
# apt-cache show lilo
Package: lilo
Priority: important
Section: base
Installed-Size: 271
Maintainer: Russell Coker &lt;russell@coker.com.au&gt;
Architecture: i386
Version: 1:21.7-3
Depends: libc6 (&gt;= 2.2.1-2), debconf (&gt;=0.2.26), logrotate
Suggests: lilo-doc
Conflicts: manpages (&lt;&lt;1.29-3)
Filename: pool/main/l/lilo/lilo_21.7-3_i386.deb
Size: 143052
MD5sum: 63fe29b5317fe34ed8ec3ae955f8270e
Description: LInux LOader - The Classic OS loader can load Linux and others
 This Package contains lilo (the installer) and boot-record-images to
 install Linux, OS/2, DOS and generic Boot Sectors of other OSes.
 .
 You can use Lilo to manage your Master Boot Record (with a simple text screen)
 or call Lilo from other Boot-Loaders to jump-start the Linux kernel.

Package: lilo
Status: install ok installed
Priority: important
Section: base
Installed-Size: 190
Maintainer: Vincent Renardias &lt;vincent@debian.org&gt;
Version: 1:21.4.3-2
Depends: libc6 (&gt;= 2.1.2)
Recommends: mbr
Suggests: lilo-doc
Description: LInux LOader - The Classic OS loader can load Linux and others
 This Package contains lilo (the installer) and boot-record-images to
 install Linux, OS/2, DOS and generic Boot Sectors of other OSes.
 .
 You can use Lilo to manage your Master Boot Record (with a simple text screen)
 or call Lilo from other Boot-Loaders to jump-start the Linux kernel.
</example>

<p>
Zauważ, że pierwszy z pakietów na liście jest pakietem dostępnym, a drugi już
zainstalowanym. Aby otrzymać więcej ogólnych informacji na temat pakietu,
możesz użyć:

<p>
<example>
# apt-cache showpkg penguin-command
Package: penguin-command
Versions: 
1.4.5-1(/var/lib/apt/lists/download.sourceforge.net_debian_dists_unstable_main_binary-i386_Packages)(/var/lib/dpkg/status)

Reverse Depends: 
Dependencies: 
1.4.5-1 - libc6 (2 2.2.1-2) libpng2 (0 (null)) libsdl-mixer1.1 (2 1.1.0) libsdl1.1 (0 (null)) zlib1g (2 1:1.1.3) 
Provides: 
1.4.5-1 - 
Reverse Provides: 
</example>

<p>
I aby dowiedzieć się od jakich pakietów on zależy:

<p>
<example>
# apt-cache depends penguin-command
penguin-command
  Depends: libc6
  Depends: libpng2
  Depends: libsdl-mixer1.1
  Depends: libsdl1.1
  Depends: zlib1g
</example>

<p>
Podsumowując, mamy wiele sposobów, których możemy użyć, aby dowiedzieć się
nazwy pakietu, który chcemy zainstalować.
</sect>

<sect id="dpkg-search">Używanie programu dpkg do dowiadywania się nazwy
pakietów
<p>
Jednym ze sposobów dowiedzenia się nazwy pakietu jest poznanie nazwy ważnego
pliku umieszczonego wewnątrz pakietu. Dla przykładu, aby znaleźć pakiet,
który jest dostarczany ze szczególnym plikiem nagłówkowym <tt>".h"</tt>
potrzebnym do jego kompilacji możesz uruchomić:

<p>
<example>
# dpkg -S stdio.h
libc6-dev: /usr/include/stdio.h
libc6-dev: /usr/include/bits/stdio.h
perl: /usr/lib/perl/5.6.0/CORE/nostdio.h
</example>

<p>
lub:

<p>
<example>
# dpkg -S /usr/include/stdio.h
libc6-dev: /usr/include/stdio.h
</example>

<p>
Aby dowiedzieć się nazwy użytecznych pakietów zainstalowanych w Twoim
systemie, na przykład, gdy zamierzasz doprowadzić do porządku Twój twardy
dysk, możesz użyć:

<p>
<example>
# dpkg -l | grep mozilla
ii  mozilla-browse 0.9.6-7        Mozilla Web Browser
</example>

<p>
Problemem związanym z tą komendą może być "obcięcie" przez nią nazwy pakietu.
W powyższym przykładzie pełną nazwą pakietu jest <tt>mozilla-browser</tt>.
Aby poradzić sobie z tym, możesz użyć zmiennej środowiskowej <tt>COLUMNS</tt>
w następujący sposób:

<p>
<example>
[kov]@[couve] $ COLUMNS=132 dpkg -l | grep mozilla
ii  mozilla-browser             0.9.6-7                     Mozilla Web Browser - core and browser
</example>

<p>
lub możesz użyć opisu pakietu lub jego części tak, jak pokazano poniżej:

<p>
<example>
# apt-cache search "Mozilla Web Browser"
mozilla-browser - Mozilla Web Browser
</example>
</sect>

<sect id="auto-apt">Jak zainstalować pakiety "na żądanie"
<p>
Kompilujesz program, aż tu nagle bęc! Wystąpił błąd, ponieważ potrzebny jest
plik nagłówkowy <tt>.h</tt>, którego nie masz. Program <prgn>auto-apt</prgn>
może Cię uchronić od takich sytuacji. Pyta Cię on czy zainstalować pakiety,
które są potrzebne, zatrzymując dany proces i kontynuując go, gdy pakiet jest
instalowany.
<p>
Wszystko, co musisz zrobić, to uruchomić:

<p>
<example>
# auto-apt run komenda
</example>

<p>
Gdzie `komenda' jest komendą, której może potrzebować jakiś niedostępny plik.
Na przykład:

<p>
<example>
# auto-apt run ./configure
</example>

<p>
Polecenie zapyta Cię czy zainstalować potrzebne pakiety i automatycznie
wywoła program apt-get. Jeśli używasz X Window, graficzny interfejs zastąpi
domyślny interfejs tekstowy.
<p>
Auto-apt używa baz danych, które muszą być uaktualniane, aby program działał
skutecznie. Jest to osiągane poprzez wywoływanie poleceń <tt>auto-apt
update</tt>, <tt>auto-apt updatedb</tt> i <tt>auto-apt update-local</tt>.
</sect>

<sect id="apt-file">Jak sprawdzić, do którego pakietu należy plik
<p>
Jeśli chcesz zainstalować jakiś pakiet, ale nie wiesz jak się on nazywa i nawet
wyszukiwanie za pomocą programu <prgn>apt-cache</prgn> nie przynosi rezultatu,
ale znasz za to nazwę pliku tego programu lub innych plików należących do
pakietu, to możesz się posłużyć programem <prgn>apt-file</prgn>, aby odszukać
nazwę tego pakietu. W tym celu wydaj polecenie:

<p>
<example>
$ apt-file search <var>nazwa_pliku</var>
</example>

<p>
Działa ono jak komenda <tt>dpkg -S</tt>, z tą różnicą, że wyświetla również
nazwy niezainstalowanych pakietów, które zawierają ten plik. Możesz go
również użyć, aby dowiedzieć się, jakie pakiety zawierają brakujące w czasie
kompilacji programu pliki nagłówkowe. Do tego celu bardziej jednak nadaje
się program <prgn>auto-apt</prgn>, który został opisany w sekcji
<ref id="auto-apt">.
<p>
Możesz także zobaczyć jakie pliki wchodzą w skład pakietu, wydając polecenie

<p>
<example>
$ apt-file list <var>nazwa_pakietu</var>
</example>

<p>
Program <prgn>apt-file</prgn>, podobnie jak <prgn>auto-apt</prgn>,
przechowuje informacje o tym jakie pliki zawierają wszystkie pakiety w bazie
danych, którą należy co jakiś czas uaktualniać. Robi się do za pomocą komendy

<p>
<example>
# apt-file update
</example>

<p>
Domyślnie oba programy używają tej samej bazy danych. Więcej informacji na
jej temat znajdziesz w sekcji <ref id="auto-apt">.

</sect>

<sect id="apt-listchanges">Jak otrzymywać informacje o zmianach w pakietach
<p>
Każdy zainstalowany pakiet zapisuje w swoim katalogu
(<tt>/usr/share/doc/nazwa_pakietu</tt>) plik o nazwie
<tt>changelog.Debian.gz</tt>, który zawiera listę zmian dokonanych w pakiecie
od jego ostatniej wersji. Możesz czytać te pliki używając na przykład
polecenia <tt>zless</tt>, ale czasem nie jest wcale takie proste, zwłaszcza
po uaktualnieniu całego systemu, szukać zmian dla każdego zaktualizowanego
pakietu. 
<p>
Istnieje sposób automatyzacji tego zadania przy pomocy narzędzia zwanego
<prgn>apt-listchanges</prgn>. Aby móc z niego korzystać musisz oczywiście
zainstalować pakiet <package>apt-listchanges</package>. Zostanie on
skonfigurowany przez Debconfa w trakcie instalacji. Odpowiedz na pytania tak,
jak chcesz.
<p>
Bardzo użyteczna jest opcja "Should apt-listchanges be automatically run by
apt? (Czy apt-listchanges powinien być automatycznie uruchamiany przez
APT-a?)", ponieważ pokazuje ona listę zmian w każdym pakiecie, który będzie
instalowany przez APT-a w trakcie aktualizacji systemu i pozwala zapoznać się
z nimi przed kontynuacją procesu aktualizacji. Również opcja "Should
apt-listchanges prompt for confirmation after displaying changes? (Czy
apt-listchanges powinien zachęcać do potwierdzenia po wyświetleniu zmian?)"
jest użyteczna, gdyż pyta Cię czy chcesz kontynuować instalację po
przeczytaniu listy zmian. Jeśli odpowiesz, że nie chcesz kontynuować,
to apt-listchanges zwróci błąd i APT przerwie proces instalacji.
<p>
Po zainstalowaniu pakietu apt-listchanges, gdy tylko pakiety będą ściągane
(lub pobierane z płyty CD-ROM albo zamontowanego dysku) przez APT-a,
to pokaże on listę zmian dokonanych w tych pakietach jeszcze przed ich
instalacją.
</sect>
</chapt>

<chapt id="sourcehandling">Praca z pakietami źródłowymi
<sect id="source">Pobieranie pakietów źródłowych
<p>
W świecie wolnego oprogramowania jest rzeczą powszechną studiować kod
źródłowy programów, a nawet dokonywać w nim zmian, aby wyeliminować błędy.
Aby to zrobić, musisz pobrać źródło programu. APT dostarcza Ci łatwego
sposobu uzyskiwania kodów źródłowych wielu programów zawartych w dystrybucji,
włączając w to wszystkie pliki potrzebne do stworzenia pakietu <tt>.deb</tt>
dla danego programu.
<p>
Innym powszechnym zastosowaniem źródeł Debiana jest przystosowanie nowszej
wersji programu, pochodzącej np. z niestabilnej dystrybucji, aby użyć go
w wersji stabilnej. Zamiast pakietu stabilnego można skompilować źródła
i wygenerować pakiety <tt>.deb</tt> z zależnościami przystosowanymi do
pakietów dostępnych w tej dystrybucji.
<p>
Aby to osiągnąć, wpis ze słowem <tt>deb-src</tt> na początku linii w Twoim
pliku <tt>/etc/apt/sources.list</tt> powinien wskazywać na archiwum
niestabilne. Oczywiście powinien on być także włączony (tzn. odkomentowany).
Zobacz sekcję <ref id="sources.list">, aby dowiedzieć się więcej szczegółów.
<p>
Aby pobrać pakiet źródłowy, użyjemy następującej komendy:

<p>
<example>
$ apt-get source pakiet
</example>

<p>
Komenda ta pobierze trzy pliki: <tt>.orig.tar.gz</tt>, <tt>.dsc</tt>
i <tt>.diff.gz</tt>. W przypadku pakietów tworzonych specjalnie dla Debiana
nie będzie pobierany ostatni plik, a pierwszy zwykle nie ma w nazwie słowa
<tt>"orig"</tt>.
<p>
Plik <tt>.dsc</tt> jest używany przez program dpkg-source do rozpakowania
źródeł pakietu w katalogu <var>pakiet-wersja</var>. Wewnątrz każdego
pobranego pakietu istnieje katalog <tt>debian/</tt>, zawierający pliki
niezbędne do stworzenia pakietu <tt>.deb</tt>.
<p>
Aby automatycznie zbudować pakiet w czasie pobierania jego źródeł, po prostu
dodaj do komendy opcję <tt>-b</tt> tak, jak pokazano to poniżej:

<p>
<example>
$ apt-get -b source pakiet
</example>

<p>
Jeśli nie zdecydowałeś się tworzyć pakietu <tt>.deb</tt> w czasie pobierania
jego źródeł, możesz zrobić to później za pomocą polecenia:

<p>
<example>
$ dpkg-buildpackage -rfakeroot -uc -b
</example>

<p>
uruchomionego wewnątrz katalogu, który został utworzony dla pakietu po jego
pobraniu. Aby zainstalować pakiet zbudowany przy pomocy powyższej komendy,
musisz użyć bezpośrednio programu dpkg:

<p>
<example>
# dpkg -i <var>file.deb</var>
</example>

<p>
Istnieje różnica pomiędzy metodą <tt>source</tt> programu
<prgn>apt-get</prgn>, a jego innymi metodami. Metoda <tt>source</tt> może
być używana przez zwykłych użytkowników, nie posiadających uprawnień roota.
Pliki są pobierane do katalogu z którego wywołano komendę <tt>apt-get source
pakiet</tt>.
</sect>

<sect id="build-dep">Pakiety potrzebne do kompilowania pakietów źródłowych
<p>
Zwykle specyficzne pliki nagłówkowe i biblioteki współdzielone muszą być
obecne, aby można było skompilować pakiet źródłowy. Wszystkie pakiety
źródłowe mają pole w plikach kontrolujących, które nazywa się
'Build-Depends:'. Pole te wskazuje, które dodatkowe pakiety są niezbędne,
aby można było zbudować pakiet z jego źródeł.
<p>
APT jest wyposażony w łatwy sposób pobierania tych pakietów. Po prostu uruchom
komendę <tt>apt-get build-dep pakiet</tt>, gdzie `pakiet' jest nazwą pakietu,
który zamierzasz zbudować. Na przykład:

<p>
<example>
# apt-get build-dep gmc
Reading Package Lists... Done
Building Dependency Tree... Done
The following NEW packages will be installed:
  comerr-dev e2fslibs-dev gdk-imlib-dev imlib-progs libgnome-dev libgnorba-dev
  libgpmg1-dev 
0 packages upgraded, 7 newly installed, 0 to remove and 1  not upgraded.
Need to get 1069kB of archives. After unpacking 3514kB will be used.
Do you want to continue? [Y/n]
</example>

<p>
Pakiety, które zostaną zainstalowane są pakietami potrzebnymi do prawidłowego
zbudowania pakietu <package>gmc</package>. Bardzo ważną rzeczą do zauważenia
jest fakt, że komenda nie szuka pakietu ze źródłami programu, który ma być
skompilowany. Dlatego musisz wcześniej uruchomić polecenie <tt>apt-get
source</tt>, aby osobno je pobrać.

<p>
Jeśli chcesz sprawdzić, które pakiety są potrzebne do zbudowania powyższej
paczki, możesz użyć wariantu polecenia <tt>apt-cache show</tt> (zobacz sekcję
<ref id="search">), pokazującego oprócz innych informacji także linię
<tt>Build-Depends</tt> z listą pakietów niezbędnych do zbudowania pakietu.

<p>
<example>
# apt-cache showsrc <var>package</var>
</example>

</sect>
</chapt>

<chapt id="erros">Jak radzić sobie z błędami
<sect id="erros-comuns">Najczęstsze błędy
<p>
Błędy zawsze będą się zdarzały, wiele z nich jest spowodowana przez
użytkowników, którzy nie zachowują uwagi w czasie pracy z APT-em.
Poniżej zamieściłem najczęściej zgłaszane błędy oraz informacje jak sobie
z nimi radzić.
<p>
Jeśli próbujesz uruchomić <tt>apt-get install package</tt> i zobaczysz 
komunikat jak poniżej:

<p>
<example>
Reading Package Lists... Done
Building Dependency Tree... Done
W: Couldn't stat source package list 'http://people.debian.org unstable/ Packages' (/var/state/apt/lists/people.debian.org_%7ekov_debian_unstable_Packages) - stat (2 Arquivo ou diretório năo encontrado)
W: You may want to run apt-get update to correct these missing files
E: Couldn't find package penguineyes
</example>

<p>
to znaczy, że zapomniałeś uruchomić <tt>apt-get update</tt> po ostatnich
zmianach, których dokonałeś w pliku <tt>/etc/apt/sources.list</tt>.
<p>
Jeśli błąd wygląda następująco:

<p>
<example>
E: Could not open lock file /var/lib/dpkg/lock - open (13 Permission denied)
E: Unable to lock the administration directory (/var/lib/dpkg/), are you root?
</example>

<p>
gdy próbujesz użyć którejś metody polecenia <prgn>apt-get</prgn> z wyjątkiem
metody <tt>source</tt>, to znaczy, że próbujesz ją uruchomić jako zwykły
użytkownik i że nie masz niezbędnych uprawnień administratora systemu.
<p>
Ten błąd jest podobny do tego powyżej i ma miejsce, gdy uruchamiasz w tym
samym czasie dwie kopie programu <prgn>apt-get</prgn> lub gdy próbujesz
uruchomić <prgn>apt-get</prgn>, gdy aktywny jest proces programu
<prgn>dpkg</prgn>. Jedyną metodą, która może być równocześnie użyta z inną
jest metoda <tt>source</tt>.
<p>
Jeśli instalacja zostanie przerwana w trakcie trwania i nie jest już możliwa
ani instalacja, ani usunięcie pakietów, spróbuj wtedy użyć tych dwóch komend:

<p>
<example>
# apt-get -f install
# dpkg --configure -a
</example>

<p>
I spróbuj jeszcze raz. Może być niezbędne uruchomienie drugiej z komend
więcej niż jeden raz. To jest ważna uwaga dla tych, którzy używają wersji
`niestabilnej'.

<p>
Jeśli wynikiem działania polecenia <tt>apt-get update</tt> jest
błąd "E: Dynamic MMap ran out of room", dodaj do swojego pliku
<file>/etc/apt/apt.conf</file> poniższą linię:

<p>
<example>
APT::Cache-Limit 10000000;
</example>

</sect>

<sect id="help">Gdzie mogę znaleźć pomoc
<p>
Jeśli popadłeś już w zwątpienie, zajrzyj do obszernej dokumentacji na temat
systemu pakietów Debiana. Opcja <tt>--help</tt> programów i ich podręczniki
mogą być ogromnie pomocne dla Ciebie. Wiele informacji można też znaleźć
w dokumentacji zawartej w katalogu <tt>/usr/share/doc</tt>, np. w katalogu
<tt>/usr/share/doc/apt</tt>.
<p>
Gdy nawet ta dokumentacja nie zdoła Ci pomóc, spróbuj poszukać odpowiedzi
na listach dyskusyjnych Debiana. Więcej informacji na temat poszczególnych
list użytkowników można znaleźć na stronie Debian:
<url id="http://www.debian.org" name="http://www.debian.org">.
<p>
Pamiętaj, że listy te i zasoby powinny być używane tylko przez użytkowników
Debiana; użytkownicy innych systemów znajdą lepsze wsparcie w zasobach ich
własnej dystrybucji.
</sect>
</chapt>

<chapt id="distros">Które dystrybucje wspierają APT-a?
<p>
Poniżej zamieszczono nazwy dystrybucji, które używają APT-a:
<p>
Debian GNU/Linux (<url id="http://www.debian.org"
name="http://www.debian.org">) - to dla tej dystrybucji został stworzony APT
<p>
Conectiva (<url id="http://www.conectiva.com.br"
name="http://www.conectiva.com.br">) - to była pierwsza dystrybucja,
która zaadoptowała APT-a do pracy z pakietami .rpm
<p>
Libranet (<url id="http://www.libranet.com" name="http://www.libranet.com">)
<p>
Mandrake (<url id="http://www.mandrake.com" name="http://www.mandrake.com">)
<p>
PLD (<url id="http://www.pld.org.pl" name="http://www.pld.org.pl">)
<p>
Vine (<url id="http://www.vinelinux.org" name="http://www.vinelinux.org">)
<p>
APT4RPM (<url id="http://apt4rpm.sf.net" name="http://apt4rpm.sf.net">)
<p>
Alt Linux (<url id="http://www.altlinux.ru/" name="http://www.altlinux.ru/">)
<p>
Red Hat (<url id="http://www.redhat.com/" name="http://www.redhat.com/">)
<p>
Sun Solaris (<url id="http://www.sun.com/" name="http://www.sun.com/">)
<p>
SuSE (<url id="http://www.suse.de/" name="http://www.suse.de/">)
<p>
Yellow Dog Linux (<url id="http://www.yellowdoglinux.com/"
name="http://www.yellowdoglinux.com/">)
</chapt>

<chapt id="agradecimentos">Podziękowania
<p>
Wielkie podziękowania składam moim wspaniałym przyjaciołom z projektu
Debian-BR i samego projektu Debian, tym którzy są stałą pomocą dla mnie,
zawsze dają mi siłę do kontynuowania pracy dla ludzkiego pożytku i pomagają
mi w moim celu jakim jest ratowanie świata. :)
<p>
Chciałbym także podziękować CIPSGA za olbrzymią pomoc udzieloną naszemu
projektowi i wszystkim wolnym projektom, które zrodziły się z wielkich idei.
<p>
Specjalne podziękowania należą się następującym osobom: 
<p>
Yooseong Yang &lt;yooseong@debian.org&gt;
<p>
Michael Bramer &lt;grisu@debian.org&gt;
<p>
Bryan Stillwell &lt;bryan@bokeoa.com&gt;
<p>
Pawel Tecza  &lt;ptecza@debianusers.pl&gt;
<p>
Hugo Mora &lt;h.mora@melix.com.mx&gt;
<p>
Luca Monducci &lt;luca.mo@tiscali.it&gt;
<p>
Tomohiro KUBOTA &lt;kubota@debian.org&gt;
<p>
Pablo Lorenzzoni &lt;spectra@debian.org&gt;
<p>
Steve Langasek &lt;vorlon@netexpress.net&gt;
<p>
Arnaldo Carvalho de Melo &lt;acme@conectiva.com.br&gt;
<p>
Erik Rossen &lt;rossen@freesurf.ch&gt;
<p>
Ross Boylan &lt;RossBoylan@stanfordalumni.org&gt;
<p>
Matt Kraai &lt;kraai@debian.org&gt;
<p>
Aaron M. Ucko &lt;ucko@debian.org&gt;
<p>
Jon Aslund &lt;d98-jas@nada.kth.se&gt;
</chapt>

<chapt id="novas">Nowe wersje tego podręcznika
<p>
Ten podręcznik został stworzony w ramach projektu
<url id="http://www.debian-br.org" name="Debian-BR"> z zadaniem
niesienia pomocy w codziennym używaniu Debiana.
<p>
Nowe wersje tego dokumentu będą dostępne na stronie Projektu Dokumentacji
Debiana (Debian Documentation Project) pod adresem
<url id="http://www.debian.org/doc/ddp" name="http://www.debian.org/doc/ddp">.
<p>
Komentarze i krytyczne uwagi mogą być wysyłane bezpośrednio do mnie na adres 
<email>kov@debian.org</email>.
</chapt>

</book>

</debiandoc>