Provided by:
manpages-pl_20060617-1_all 
NAZWA
apt-get - narzędzie zarządzania pakietami APT -- interfejs linii
poleceń
SKŁADNIA
apt-get [ -hvs ] [ -o=opcja konfiguracji ] [ -c=plik ] { update |
upgrade | dselect-upgrade | install pakiet ... | remove pakiet ... |
source pakiet ... | build-dep pakiet ... | check | clean | autoclean
}
OPIS
apt-get jest narzędziem do zarządzania pakietami działającym z linii
poleceń, które może być za wewnętrzne narzędzie innych programów
użuwająch biblioteki APT. Istnieje wiele interfejsów użytkownika,
takich jak dselect(8), aptitude, synaptic, gnome-apt oraz wajig.
Jedno z poniższych poleceń musi być użyte, chyba że została podana
opcja -h lub --help:
update update jest używane do zsynchronizowania zawartości plików
indeksu pakietów z ich źródłem. Lista dostępnych pakietów jest
pobierana z lokalizacji określonych w pliku
/etc/apt/sources.list. Na przykład, gdy używane jest archiwum
Debiana, to polecenie pobiera i przegląda pliki Packages.gz, tak
żeby udostępnić informacje o nowych i uaktualnionych pakietach.
Polecenie update powinno być użyte zawsze przed upgrade lub
dist-upgrade. Należy zauważyć, że licznik całkowitego postępu
operacji jest błędny, ponieważ rozmiar plików Packages.gz nie
jest wcześniej znany.
upgrade
upgrade instaluje najnowsze wersje wszystkich pakietów, obecnie
zainstalowanych w systemie, na podstawie źródeł wymienionych w
pliku /etc/apt/sources.list. Zainstalowane pakiety, których
nowsza wersja jest dostępna, są ściągane i uaktualniane; w
żadnym wypadku podanie tej opcji nie spowoduje usunięcia
zainstalowanego pakietu czy zainstalowania nowego pakietu,
wcześniej nie zainstalowanego. Pakiety, których nowa wersja
wymaga zmiany statusu (np. zainstalowania bądź usunięcia) innego
pakietu, nie będą uaktualnione. Aby apt-get wiedział, że są
dostępne nowe wersje pakietów, należy wcześniej wykonać update.
dselect-upgrade
dselect-upgrade jest używane w połączeniu z programem
dselect(8), tradycyjnym narzędziem do zarządzania pakietami w
systemie Debian. dselect-upgrade uwzględnia zmiany zrobione
programem dselect(8) w polu Status pliku zawierającego
informacje o dostępnych pakietach i wykonuje akcje potrzebne do
zrealizowania tych zmian (na przykład: usunięcie starych
pakietów i dodanie nowych).
dist-upgrade
dist-upgrade wykonuje to samo, co upgrade, jednakże w
inteligentny sposób wykrywa zmiany zależności międzypakietowych
w nowych wersjach pakietów. apt-get ma wbudowany "sprytny"
system rozwiązywania konfliktów i jeśli będzie to potrzebne,
podejmie próbę zaktualizowania najważniejszych pakietów, kosztem
tych mniej ważnych. Plik /etc/apt/sources.list zawiera listę
adresów, z których będą pobierane żądane pakiety. Zobacz
również do apt_preferences(5) - znajduje się tam opis mechanizmu
nadpisywania globalnych ustawień dla poszczególnych pakietów.
install
po install musi występować nazwa jednego lub więcej pakietów
przeznaczonych do zainstalowania. Każdy argument jest nazwą
pakietu, a nie pełną nazwą pliku, w którym się znajduje (na
przykład w systemie Debian GNU/Linux, tym argumentem byłoby
libc6, a nie libc6_1.9.6-2.deb). Wszystkie pakiety, które są
potrzebne do zainstalowania żądanego(-ych) pakietu(-ów), będą
także ściągnięte i zainstalowane. Plik /etc/apt/sources.list
zawiera listę adresów, z których będą pobierane żądane pakiety.
Jeżeli po nazwie pakietu pojawi się minus (bez spacji pomiędzy
minusem a nazwą pakietu), to ten pakiet zostanie usunięty, o ile
oczywiście jest zainstalowany. Podobnie znak plusa może być
użyty w celu zainstalowania pakietu. Ta ostatnia właściwość może
być użyta do nadpisania decyzji podjętych przez system
rozwiązywania konfliktów programu apt-get.
Konkretna wersja pakietu może być wybrana do zainstalowania
przez umieszczenie po nazwie pakietu znaku równości, a za nim
wybranej wersji pakietu. Podana wersja zostanie wyszukana i
wybrana do zainstalowania. Również konkretna dystrybucja może
być wybrana przez umieszczenie po nazwie pakietu znaku ukośnika,
po którym następuje wersja dystrybucji bądź nazwa archiwum
(stable, testing, unstable).
Oba mechanizmy wyboru pakietów mogą zainstalować wcześniejsze
wersje pakietów niż są już zainstalowane w systemie, dlatego
muszą być używane ostrożnie.
W końcu, mechanizm apt_preferences(5) pozwala określić
alternatywny sposób instalacji poszczególnych pakietów.
Jeżeli żaden pakiet nie pasuje do podanego wyrażenia, a to
wyrażenie zawiera jeden z następujących znaków: '.', '?' albo
'*', to zakłada się, że jest to wyrażenie regularne zgodne z
POSIX-em i jest ono stosowane do wszystkich nazw pakietów w
bazie. Pakiety, których nazwy pasują do tego wyrażenia
regularnego, są instalowane (bądź usuwane). Należy zwrócić uwagę
na to, że dopasowywany jest podciąg, tak więc 'lo*' pasuje
zarówno do 'how-lo', jak i do 'lowest'. Jeśli jest to
niepożądane, można określić początek lub koniec dopasowania
wyrażenia regularnego, używając znaków '^' lub '$', można też
stworzyć bardziej specyficzne wyrażenie regularne.
remove remove odpowiada poleceniu install z tą różnicą, że pakiety są
usuwane, a nie instalowane. Jeżeli nazwa pakietu zostanie
poprzedzona znakiem plusa (bez rozdzielającej spacji), wskazany
pakiet zostanie zainstalowany zamiast zostać usunięty.
source source powoduje, że apt-get ściąga pakiety ze źródłami. APT na
podstawie listy dostępnych pakietów decyduje, który pakiet
źródłowy ściągnąć. Następnie szuka najnowszej dostępnej wersji
pakietu źródłowego i ładuje ją do bieżącego katalogu. Pakiety
źródłowe są znajdowane inaczej niż pakiety binarne: przez linie
z identyfikatorem deb-src w pliku sources.list(5). Może to
oznaczać, że pakiet źródłowy, który otrzymasz, nie będzie
odpowiadał pakietowi binarnemu, który jest zainstalowany (może
być zainstalowany). Jeżeli podano opcję --compile, pakiet
źródłowy zostanie skompilowany do pakietu binarnego .deb za
pomocą programu dpkg-buildpackage, podanie opcji --download-only
spowoduje natomiast, że pakiet źródłowy nie zostanie
rozpakowany.
Konkretną wersję pakietu źródłowego można ściągnąć, umieszczając
po nazwie pakietu źródłowego znak równości, a za nim numer
wersji do ściągnięcia. Działa tu taki sam mechanizm jak w
przypadku pakietów binarnych. Włączone zostaje dokładne
dopasowywanie nazw i wersji pakietów źródłowych i pośrednio
włączona zostaje opcja APT::Get::Only-Source.
Uwaga. Pakiety źródłowe nie są traktowane tak samo, jak pakiety
binarne - są przechowywane tylko w bieżącym katalogu, mniej
więcej tak jakby zostały ściągnięte oryginalne źródła programu
ze strony jego autorów.
build-dep
build-dep powoduje, że apt-get zainstaluje/usunie pakiety tak,
żeby spełnić zależności (build dependencies) wymagane do
zbudowania danego pakietu źródłowego.
check check jest poleceniem diagnostycznym, które odświeża bufor
(cache) pakietów i szuka zepsutych pakietów.
clean clean czyści lokalne repozytorium ściągniętych plików z
pakietami. Usuwa wszystko z wyjątkiem pliku blokady
/var/cache/apt/archives/ oraz katalogu
/var/cache/apt/archives/partial/. Gdy APT jest używane jako
metoda programu dselect(8), clean jest uruchamiane
automatycznie. Osoby nie używające dselect, mogą chcieć od
czasu do czasu uruchamiać apt-get clean, aby zwolnić trochę
miejsca na dysku.
autoclean
Podobnie jak clean, autoclean czyści lokalne repozytorium
pobranych plików z pakietami. Różnica jest taka, że autoclean
usuwa tylko te pliki pakietów, które już nie mogą być ściągnięte
i w większości są bezużyteczne. Pozwala to na utrzymywanie
bufora (cache'a) przed długi czas i na uniknięcie
niekontrolowanego jego wzrostu. Wyłączenie opcji
konfiguracyjnej APT::Clean-Installed zapobiegnie usuwaniu plików
zawierających zainstalowane pakiety.
OPCJE
Wszystkie opcje linii poleceń mogą być ustawione w pliku
konfiguracyjnym. Poniższe opisy wskazują, którą opcję w pliku
konfiguracyjnym należy ustawić. W przypadku opcji logicznych, można
unieważnić ustawienia pliku konfiguracyjnego, używając -f-,--no-f,
-f=no albo czegoś podobnego.
-d
--download-only
Tylko pobieranie; pliki z pakietami są tylko ściągane, ale nie
rozpakowywane czy instalowane. Pozycja w pliku konfiguracyjnym:
APT::Get::Download-Only.
-f
--fix-broken
Popraw; podejmuje próbę poprawienia zepsutych zależności.
Używanie tej opcji z install/remove może spowodować pominięcie
któregokolwiek z pakietów podanych w linii poleceń, co pozwoli
programowi APT znaleźć właściwe rozwiązanie problemu. Ta opcja
jest czasami potrzebna przy pierwszym uruchomieniu APT, który
nie pozwala, aby w systemie istniały zepsute zależności. Jest
również prawdopodobne, że systemowa struktura zależności może
być tak zepsuta, że będzie wymagała ręcznej naprawy (co
zazwyczaj oznacza użycie dselect(8) lub dpkg --remove w celu
usunięcia niektórych naruszonych pakietów). W pewnych
sytuacjach użycie tej opcji łącznie z -m może spowodować błąd.
Pozycja w pliku konfiguracyjnym: APT::Get::Fix-Broken.
-m
--ignore-missing
--fix-missing
Ignoruj brakujące pakiety. Pakiety, które nie mogą być pobrane
lub nie powiedzie się test spójności pakietu po jego pobraniu
(plik z pakietem jest uszkodzony), zostają wstrzymane. W pewnych
sytuacjach użycie tej opcji łącznie z -f może spowodować błąd.
Pakiet, który jest wybrany do instalacji (w szczególności jest
on wymieniony w linii poleceń), ale nie może zostać pobrany,
zostanie pominięty. Pozycja w pliku konfiguracyjnym:
APT::Get::Fix-Missing.
--no-download
Wyłącza pobierania pakietów. Najlepiej stosować z --ignore-
missing, aby wymusić na APT używanie tylko tych plików .deb,
które zostały wcześniej ściągnięte. Pozycja w pliku
konfiguracyjnym: APT::Get::Download.
-q
--quiet
Cichy; wypisuje tylko informacje potrzebne do logowania,
opuszczając wskaźniki postępu. Więcej znaków q spowoduje jeszcze
bardziej ciche wyjście, maksimum jest 2. Można także ustawić
poziom cichości za pomocą -q=#, nadpisując tym samym opcję z
pliku konfiguracyjnego. Należy zauważyć, że poziom cichości
równy 2 implikuje -y, dlatego -qq nigdy nie powinno być używane
bez opcji typu -d, --print-uris lub -s, gdyż APT może
zadecydować o zrobieniu czegoś, czego użytkownik się nie
spodziewa. Pozycja w pliku konfiguracyjnym: quiet.
-s
--simulate
--just-print
--dry-run
--recon
--no-act
Brak akcji; wykonuje symulację zdarzeń, które mogłyby się
przytrafić, ale nic nie zmienia w systemie. Pozycja w pliku
konfiguracyjnym: APT::Get::Simulate.
Symulacja powoduje wypisanie serii linii, z których każda
reprezentuje operację programu dpkg: konfigurowanie (Conf),
usunięcie (Remv), rozpakowanie (Inst). Nawiasy kwadratowe
oznaczają zepsute pakiety, przy czym puste nawiasy kwadratowe
oznaczają, że przyczyna zepsucia pakietu nie jest znana
(rzadkość).
-y
--yes
--assume-yes
Automatycznie odpowiada "tak" na pytania. Zakładając odpowiedź
"tak" na wszelkie pytania, uruchamia się w trybie
nieinteraktywnym. Jeśli wystąpi jakaś niepożądana sytuacja, na
przykład zmiana wstrzymanego pakietu lub usunięcie pakietu
mającego status Essential, apt-get przerwie działanie. Pozycja
w pliku konfiguracyjnym: APT::Get::Assume-Yes.
-u
--show-upgraded
Pokaż uaktualnione pakiety. Wypisuje listę wszystkich pakietów,
które będą uaktualnione. Pozycja w pliku konfiguracyjnym:
APT::Get::Show-Upgraded.
-V
--verbose-versions
Wyświetla pełne wersje aktualizowanych pakietów Pozycja w pliku
konfiguracyjnym: APT::Get::Show-Versions.
-b
--compile
--build
Skompiluj pakiety źródłowe po ich ściągnięciu. Pozycja w pliku
konfiguracyjnym: APT::Get::Compile.
--ignore-hold
Ignoruje status hold (wstrzymany) pakietów. Ta opcja powoduje,
że apt-get zignoruje status hold pakietów. Może to być użyteczne
w połączeniu z dist-upgrade do unieważnienia dużej liczby
niepożądanych wstrzymań. Pozycja w pliku konfiguracyjnym:
APT::Ignore-Hold.
--no-upgrade
Nie aktualizuj pakietów. Użyte w połączeniu z install, no-
upgrade spowoduje, że pakiety, które są już zainstalowane, nie
zostaną zaktualizowane. Pozycja w pliku konfiguracyjnym:
APT::Get::Upgrade.
--force-yes
Wymuszenie. Jest to niebezpieczna opcja, która powoduje, że apt-
get kontynuuje swoje działanie bez żadnej interakcji z
użytkownikiem, nawet jeśli robi coś, co może być szkodliwe. Nie
powinna być używana, z wyjątkiem bardzo szczególnych sytuacji.
Używanie force-yes może zniszczyć Twój system! Pozycja w pliku
konfiguracyjnym: APT::Get::force-yes.
--print-uris
Nie ściąga pakietów do zainstalowania, tylko wypisuje ich URI.
Każdy URI składa się z lokalizacji, nazwy pliku przeznaczenia,
rozmiaru oraz oczekiwanej sumy kontrolnej md5. Należy zauważyć,
że nazwa pliku przeznaczenia nie musi być taka sama jak nazwa
zdalnego pliku! Działa to także z poleceniami source i update.
Używane z poleceniem update, nie wypisuje sum MD5 i rozmiaru, a
także w gestii użytkownika leży wtedy rozpakowywanie spakowanych
plików. Pozycja w pliku konfiguracyjnym: APT::Get::Print-URIs.
--purge
Podczas usuwania pakietu, usuwa także jego pliki konfiguracyjne.
Obok pakietów, które są przeznaczone do takiego usunięcia,
wyświetlana jest gwiazdka ("*"). Pozycja w pliku
konfiguracyjnym: APT::Get::Purge.
--reinstall
Ponownie zainstaluj pakiety, których najnowsza wersja już jest
zainstalowana Pozycja w pliku konfiguracyjnym:
APT::Get::ReInstall.
--list-cleanup
Ta opcja jest domyślnie włączona, można ją wyłączyć używając
--no-list-cleanup. Jeżeli jest włączona, apt-get będzie
automatycznie zarządzał zawartością /var/lib/apt/lists,tak aby
przestarzałe pliki były usuwane. Jedynym powodem dla jej
wyłączenia mogłyby być częste zmiany w sources.list. Pozycja w
pliku konfiguracyjnym: APT::Get::List-Cleanup.
-t
--target-release
--default-release
Ta opcja tworzy domyślny pin o priorytecie 990, używając
podanego łańcucha znaków oznaczającego wersję dystrybucji. W
pliku z preferencjami można unieważnić to ustawienie. W skrócie
- ta opcja pozwala pozwala na prostą kontrolę, z których
dystrybucji będą pobierane pakiety. Przykłady: -t '2.1*' lub -t
unstable. Pozycja w pliku konfiguracyjnym: APT::Default-
Release; zobacz także stronę podręcznika apt_preferences(5).
--trivial-only
Wykonuje tylko 'banalne' (ang. 'trivial') operacje. Tę opcję
można porównać z --assume-yes, ale tam gdzie --assume-yes
odpowiedziałoby "tak" na pytanie, --trivial-only odpowie "nie".
Pozycja w pliku konfiguracyjnym: APT::Get::Trivial-Only.
--no-remove
Jeżeli jakikolwiek pakiet miałby zostać usunięty, apt-get
natychmiast kończy działanie. Pozycja w pliku konfiguracyjnym:
APT::Get::Remove
--only-source
Ma znaczenie tylko dla polecenia source. Wskazuje na to, że
podane nazwy pakietów źródłowych nie powinny być mapowane w
tabeli pakietów binarnych. Pozycja w pliku konfiguracyjnym:
APT::Get::Only-Source
--diff-only
--tar-only
Ściągnij tylko plik diff albo tar pakietu źródłowego. Pozycja w
pliku konfiguracyjnym: APT::Get::Diff-Only oraz APT::Get::Tar-
Only
--arch-only
Przetwarza tylko te pakiety z zależnościami wymaganymi do
zbudowania pakietu ze źródeł (build-dependencies), które są
zależnie od architektury komputera. Pozycja w pliku
konfiguracyjnym: APT::Get::Arch-Only
-h
--help Wyświetla krótkie informacje na temat użytkowania.
-v
--version
Wyświetla wersję programu.
-c
--config-file
Plik konfiguracyjny. Podaje plik konfiguracyjny do użycia.
Program najpierw przeczyta swój domyślny plik konfiguracyjny, a
następnie plik podany jako argument tej opcji. Informacje o
składni pliku można znaleźć w apt.conf(5).
-o
--option
Ustaw opcję konfiguracyjną. Można ustawić dowolną opcję
konfiguracyjną. Składnia jest następująca: -o Foo::Bar=bar.
PLIKI
/etc/apt/sources.list
Lokalizacje, z których będą ściągane pakiety Pozycja w pliku
konfiguracyjnym: Dir::Etc::SourceList.
/etc/apt/apt.conf
Plik konfiguracyjny dla APT. Pozycja w pliku konfiguracyjnym:
Dir::Etc::Main.
/etc/apt/apt.conf.d/
Części pliku konfiguracyjnego APT. Pozycja w pliku
konfiguracyjnym: Dir::Etc::Parts.
/etc/apt/preferences
Plik zawierający preferencje wyboru wersji. Jest to miejsce, w
którym określa się tzw. "pinning", tj. preferencje skąd brać
pewne pakiety - z innego źródła, z innej dystrybucji lub o innej
wersji. Pozycja w pliku konfiguracyjnym: Dir::Etc::Preferences.
/var/cache/apt/archives/
Składnica ściągniętych plików z pakietami Pozycja w pliku
konfiguracyjnym: Dir::Cache::Archives.
/var/cache/apt/archives/partial/
Składnica ściąganych właśnie plików z pakietami Pozycja w pliku
konfiguracyjnym: Dir::Cache::Archives (implicit partial).
/var/lib/apt/lists/
Składnica informacji o stanie każdej lokalizacji pakietów
podanej w sources.list(5) Pozycja w pliku konfiguracyjnym:
Dir::State::Lists.
/var/lib/apt/lists/partial/
Składnica informacji o stanie w trakcie ściągania. Pozycja w
pliku konfiguracyjnym: Dir::State::Lists (implicit partial).
ZOBACZ TAKŻE
apt-cache(8), apt-cdrom(8), dpkg(8), dselect(8), sources.list(5),
apt.conf(5), apt-config(8), "Przewodnik dla użytkowników programu APT"
w /usr/share/doc/apt/, apt_preferences(5), APT Howto.
DIAGNOSTYKA
apt-get zwraca zero, gdy zakończyło się pomyślnie, 100 - w przypadku
błędu.
BŁĘDY
Zajrzyj na stronę błędów APT <URL:http://bugs.debian.org/src:apt>. Aby
złożyć raport o błędzie w APT, prosimy przeczytać
/usr/share/doc/debian/bug-reporting.txt lub użyć polecenia
reportbug(1).
AUTOR
APT zostało napisane przez zespół APT <apt@packages.debian.org>.
20 sierpnia 2003 APT-GET(8)