> Linux Reviews > man >

dpkg

- mened�er pakiet�w dla systemu Debian GNU/Linux

dpkg.8.man

1. dpkg.8.man

Manpage of DPKG

DPKG

Section: Debian GNU/Linux (8)
Updated: 12 kwietnia 1998
Index Return to Main Contents

NAZWA

dpkg - mened�er pakiet�w dla systemu Debian GNU/Linux

SK�ADNIA

dpkg [opcje] dzia�anie

UWAGA

Ten podr�cznik jest przeznaczony dla u�ytkownik�w, kt�rzy chc� pozna� opcje programu dpkg oraz chc� dowiedzie� si� o pakietach wi�cej, ni� podaje to dpkg --help.

Ten podr�cznik nie wyja�nia technicznych szczeg��w, np. w jaki spos�b dpkg instaluje lub usuwa swoje pakiety, gdy� jest to dla przeci�tnego u�ytkownika zupe�nie nieistotne. Tw�rcy pakiet�w znajd� szczeg�owe informacje w debian-faq pod has�em System zarz�dzania pakietami. Informacje o sposobie tworzenia pakiet�w s� zawarte pod has�em Narz�dzia do zarz�dzania pakietami w tym samym dokumencie.

OPIS

dpkg to �redniego poziomu narz�dzie do instalowania, tworzenia, usuwania oraz zarz�dzania pakietami systemu Debian GNU/Linux. Podstawowym i bardziej przyjaznym u�ytkownikowi narz�dziem-nak�adk� dpkg jest dselect(8). Sam dpkg jest operowany z linii komend poprzez podanie jednego dzia�ania oraz opcjonalnie dodatkowych opcji. Parametr dzia�ania okre�la, co dpkg ma zrobi�, a dodatkowe opcje modyfikuj� te dzia�anie.

dpkg mo�e by� tak�e u�yty jako nak�adka na dpkg-deb. Wymienione poni�ej parametry zostan� przekazane z dpkg do dpkg-deb:

    -b, --build,
    -c, --contents,
    -I, --info,
    -f, --field,
    -e, --control,
    -x, --extract,
    -X, --vextract, oraz
    --fsys-tarfile.

Te dzia�ania s� opisane w osobnym podr�czniku do dpkg-deb(8).

INFORMACJE O PAKIETACH

dpkg zarz�dza informacjami o dost�pnych pakietach. Informacje zosta�y podzielone na trzy klasy: stan bie��cy, stan wyboru oraz flag�. Warto�ci te mog� zosta� zmienione za pomoc� programu dselect.

STAN BIE��CY PAKIET�W

installed (zainstalowany): Pakiet jest rozpakowany i poprawnie skonfigurowany.
half-installed (wp�-zainstalowany): Instalacja pakietu zosta�a rozpocz�ta, ale niedoko�czona z pewnych powod�w.
not-installed (niezainstalowany): Pakiet nie jest zainstalowany w systemie.
unpacked (rozpakowany): Pakiet jest rozpakowany ale nie skonfigurowany.
half-configured (wp�-skonfigurowany): Pakiet jest rozpakowany a konfiguracja zosta�a rozpocz�ta, ale niedoko�czona z pewnych powod�w.
config-files (pliki-konfiguracyjne): Tylko pliki konfiguracyjne pakietu zosta�y w systemie.

STAN WYBORU PAKIET�W

install (instalacja): Pakiet zosta� wybrany do zainstalowania.
deinstall (deinstalacja): Pakiet zosta� wybrany do deinstalowania (to znaczy, �e chcemy skasowa� wszystkie pliki pakietu, opr�cz plik�w konfiguracyjnych).
purge (wyczyszczenie): Pakiet zosta� wybrany do wyczyszczenia (to znaczy, �e chcemy skasowa� wszystko, w��cznie z plikami konfiguracyjnymi).

FLAGI PAKIET�W

hold (wstrzymanie): Pakiet oznaczony jako wstrzymany nie jest obs�ugiwany przez dpkg, chyba �e u�yje si� opcji --force-hold.
reinst-required (konieczna-reinstalacja): Pakiet oznaczony jako konieczna-reinstalacja jest uszkodzony i wymaga reinstalacji. Taki pakiet nie mo�e zosta� usuni�ty, chyba �e u�yje si� opcji --force-reinstreq.

DZIA�ANIA

dpkg -i | --install plik_pakietu...

Instalacja pakiet. Je�li zosta�a u�yta opcja --recursive lub -R, plik_pakietu musi oznacza� wybrany katalog.

Instalacja sk�ada si� z nast�puj�cych krok�w:

1. Rozpakowanie plik�w kontrolnych nowego pakietu.

2. Je�li inna wersja tego samego pakietu jest ju� zainstalowana, uruchomienie skryptu prerm starego pakietu.

3. Uruchomienie skryptu preinst, je�li pakiet go zawiera.

4. Rozpakowanie nowych plik�w, ale przechowanie starych na wypadek, gdyby instalacja si� nie powiod�a i trzeba by je odzyska�.

5. Je�li inna wersja tego samego pakietu by�a poprzednio zainstalowana, uruchomienie skryptu postrm starego pakietu. Prosz� zauwa�y�, �e ten skrypt jest uruchamiany po skrypcie preinst nowego pakietu, poniewa� nowe pliki s� zapisywane w tym samym czasie, gdy stare s� kasowane.

6. Konfiguracja pakietu. Bardziej szczeg�owe informacje zawarto przy opisie parametru --configure.

dpkg --unpack plik_pakietu ...

Rozpakowanie pakietu, ale nie konfigurowanie go. Je�li zosta�a u�yta opcja --recursive lub -R, plik_pakietu musi oznacza� wybrany katalog.

dpkg --configure pakiet ... | -a | --pending

Rekonfigurowanie rozpakowanego pakietu. Je�li zamiast nazwy pakietu zosta�a podana opcja -a lub --pending, rekonfiguracja obejmie wszystkie rozpakowane ale nie skonfigurowane pakiety.

Konfigurowanie sk�ada si� z nast�puj�cych krok�w:

1. Rozpakowanie nowych plik�w konfiguracyjnych, ale przechowanie starych na wypadek, gdyby konfigurowanie si� nie powiod�o i trzeba by je odzyska�.

2. Uruchomienie skryptu postinst, je�li pakiet go zawiera.

dpkg -r | --remove | --purge pakiet ... | -a | --pending

Usuwanie zainstalowanych pakiet�w. Parametr -r lub --remove powoduje usuni�cie wszystkich plik�w opr�cz plik�w konfiguracyjnych. Pozwala to unikn�� powt�rnej konfiguracji, gdyby pakiet by� zn�w instalowany p�niej. (Pliki konfiguracyjne s� wymienione w pliku kontrolnym debian/conffiles pakietu). Parametr --purge usuwa wszystko, ��cznie z plikami konfiguracyjnymi. Je�li zamiast nazwy pakietu zosta�a podana opcja -a lub --pending, usuni�te lub wyczyszczone zostan� wszystkie pakiety rozpakowane i wybrane do usuni�cia lub wyczyszczenia z pliku /var/lib/dpkg/status.

Usuni�cie pakietu sk�ada si� z nast�puj�cych krok�w:

1. Uruchomienie skryptu prerm

2. Usuni�cie zainstalowanych plik�w

3. Uruchomienie skryptu postrm

dpkg --print-avail pakiet

Pokazanie szczeg�owych informacji o pakiecie, znalezionych w pliku /var/lib/dpkg/available.

dpkg --update-avail | --merge-avail Packages

Zaktualizowanie bazy danych programu dpkg oraz dselect o dost�pnych pakietach. Opcja --merge-avail powoduje, �e poprzednie informacje s� ��czone z nowymi z pliku Packages. Opcja --update-avail powoduje zast�pienie starych informacji nowymi z pliku Packages. Plik Packages jest dystrybuowany razem z systemem Debian GNU/Linux. dpkg przechowuje informacje z tego pliku w pliku /var/lib/dpkg/available.

dpkg -A | --record-avail plik_pakietu ...

Zaktualizowanie bazy danych programu dpkg oraz dselect o dost�pnych pakietach uwzgl�dniaj�c informacje zawarte w pliku_pakietu. Je�li zosta�a u�yta opcja --recursive lub -R, plik_pakietu musi oznacza� wybrany katalog.

dpkg --forget-old-unavail

Skasowanie informacji o wszystkich niezainstalowanych i niedost�pnych pakietach.

dpkg --clear-avail

Skasowanie informacji o dost�pnych pakietach.

dpkg -l | --list wzorzec-nazwy-pakietu ...

Podanie listy pakiet�w o podanym wzorcu nazwy. Je�li nie podano wzorca-nazwy-pakietu, podanie listy wszystkich pakiet�w z pliku /var/lib/dpkg/available. Do wzorca-nazwy-pakietu mo�na wpisa� zwyk�e operatory powt�rzenia. (Prawdopodobnie potrzebne b�dzie zacytowanie wzorca-nazwy-pakietu aby shell nie rozwin�� tego wzorca. Na przyk�ad, dpkg -l 'libc5*' poda list� wszystkie pakiety, kt�rych nazwa zaczyna si� od "libc5".)

dpkg -s | --status nazwa-pakietu ...

Podanie stanu pakietu o podanej nazwie-pakietu. Polecenie po prostu poda informacje, kt�re znajduj� si� w bazie danych pakiet�w.

dpkg -C | --audit

Wyszukanie pakiet�w, kt�re zainstalowane s� w systemie tylko cz�ciowo. dpkg zasugeruje, co mo�na zrobi� z tymi pakietami, aby w pe�ni dzia�a�y.

dpkg --get-selections [wzorzec...]

Pobranie listy wybranych pakiet�w i wyrzucenie jej na stdout.

dpkg --set-selections

Ustawienie wyboru pakiet�w odczytane ze stdin.

dpkg --yet-to-unpack

Wyszukanie pakiet�w przeznaczonych do zainstalowania, kt�re z pewnych powod�w nie mog�y zosta� zainstalowane.

dpkg -L | --listfiles pakiet ...

Podanie listy plik�w zainstalowanych z pakietu. Pliki, kt�re zosta�y utworzone przez skrypty instalacyjne, nie b�d� podane.

dpkg -S | --search wzorzec-nazwy-pliku ...

Szukanie pliku o podanym wzorcu po�r�d zainstalowanych pakiet�w. Wzorzec mo�e zawiera� zwyk�e operatory powt�rzenia.

dpkg --print-architecture

Podanie architektury docelowej (na przyk�ad, "i386"). Ta opcja jest wykorzystana przez gcc.

dpkg --print-gnu-build-architecture

Podanie wersji GNU docelowej architektury (na przyk�ad, "i486").

dpkg --print-installation-architecture

Podanie architektury hosta dla kt�rego nast�pi instalacja.

dpkg --compare-versions wersja1 op wersja2

Por�wnanie numer�w wersji, gdzie op jest operatorem binarnym. dpkg zwr�ci prawd� (rezultat zerowy) gdy warunek zostanie spe�niony, lub zwr�ci fa�sz (rezultat niezerowy) w przeciwnym razie. Istniej� dwie grupy operator�w, w zale�no�ci od tego w jaki spos�b traktuje si� brak numeru wersji. Operatory, gdy brak numeru wersji oznacza wcze�niejsz� ni� dowolna: lt le eq ne ge gt. Operatory, gdy brak numeru wersji oznacza p�niejsz� ni� dowolna: lt-nl le-nl ge-nl gt-nl. Operatory, aby zachowa� kompatybilno�� z plikiem kontrolnym: < << <= = >= >> >.

dpkg --help

Wy�wietlenie kr�tkiego komunikatu pomocy.

dpkg --force-help

Wy�wietlenie opisu opcji --force-dzia�anie.

dpkg -Dh | --debug=help

Wy�wietlenie opisu opcji debuggera.

dpkg --licence | dpkg --license

Wy�wietlenie licencji dpkg.

dpkg --version

Wy�wietlenie informacji o wersji dpkg.

dpkg-deb-actions

Zajrzyj do dpkg-deb(8), aby pozna� pe�ny opis nast�puj�cych dzia�a�.

dpkg -b | --build katalog [nazwa_pliku]
    Zbudowanie pakietu Debiana.
dpkg -c | --contents nazwa_pliku
    Podanie zawarto�ci pakietu Debiana..
dpkg -e | --control nazwa_pliku [katalog]
    Rozpakowanie plik�w kontrolnych z pakietu.
dpkg -x | --extract nazwa_pliku katalog
    Rozpakowanie plik�w zawartych w pakiecie.
dpkg -f | --field  nazwa_pliku [pola-kontrolne] ...
    Podanie informacji z p�l kontrolnych pakietu.
dpkg --fsys-tarfile nazwa_pliku
    Podanie na stdout archiwum tar, kt�re zawiera pakiet Debiana.
dpkg -I | --info nazwa_pliku [plik-kontrolnye]
    Podanie informacji o pakiecie.
dpkg -X | --vextract nazwa_pliku katalog
    Rozpakowanie pakietu i podanie nazw plik�w, kt�re zawiera pakiet.

OPCJE

--abort-after=number

Zmiana ilo�ci b��d�w, po kt�rych dpkg zaprzestanie dzia�ania. Domy�lna warto�� to 50.

-B|--auto-deconfigure

Gdy pakiet jest usuwany, mo�liwa jest sytuacja, �e kolejny zainstalowany pakiet jest zale�ny od tego usuwanego. Podanie tej opcji spowoduje automatyczne dekonfigurowanie pakiet�w, kt�re s� zale�ne od usuwanego.

-Doktal | --debug=oktal

W��czenie trybu debuggera. oktal jest liczb� �semkow� zale�n� od rz�danych opcji debuggera (te warto�ci mog� ulec zmianie w przysz�o�ci). Parametr -Dh lub --debug=help wy�wietla te warto�ci.

numer  opis
    1   Og�lnie przydatne informacje o post�pie
    2   Wywo�anie i stan skrypt�w kontrolnych
   10   Informacje o ka�dym przetwarzanym pliku
  100   Wi�cej informacji o ka�dym przetwarzanym pliku
   20   Informacje o ka�dym pliku konfiguracyjnym
  200   Wi�cej informacji o ka�dym pliku konfiguracyjnym
   40   Zale�no�ci i konflikty
  400   Wi�cej informacji o zale�no�ciach i konfliktach
1000   Mn�stwo informacji m.in. o plikach info z bazy danych dpkg
2000   Reszta szczeg�owych informacji

--force-dzia�anie | --no-force-dzia�anie | --refuse-dzia�anie

Wymu� (--force-) wykonanie pewnych dzia�a� lub pozostaw domy�lny spos�b (no-force i refuse oznaczaj� to samo) wykonania dzia�a�. dzia�anie to rozdzielona przecinkami lista dzia�a�. --force-help wy�wietla opis tych dzia�a�. Dzia�ania oznaczone przez (*) s� domy�lnie wymuszone.

Ostrze�enie: Te opcje s� zwykle przeznaczone wy��cznie dla do�wiadczonych u�ytkownik�w. U�ycie ich bez pe�nego zrozumienia efektu dzia�ania mo�e spowodowa� uszkodzenie systemu.

auto-select(*): Zaznaczenie pakiet�w do zainstalowania ewentualnie usuni�cia.

downgrade(*): Zainstalowanie pakietu nawet gdy nowsza jego wersja jest ju� zainstalowana.

configure-any: Skonfigurowanie wszystkich rozpakowanych ale nie skonfigurowanych pakiet�w, od kt�rych jest zale�ny bie��cy pakiet.

hold: Dzia�anie obejmie tak�e pakiety oznaczone jako "wstrzymane" (hold).

remove-reinstreq: Usuni�cie pakietu, nawet wtedy gdy jest uszkodzony i wymaga przeinstalowania. Mo�e to spowodowa� pozostawienie cz�ci pakietu w systemie, gdy� zostanie on zapomniany przez dpkg.

remove-essential: Usuni�cie pakietu, nawet wtedy gdy jest on uznany za niezb�dny (essential). Pakiety niezb�dne zawieraj� podstawowe polecenia Unixa. Usuni�cie ich mo�e spowodowa�, �e system przestanie dzia�a�. Nale�y zachowa� szczeg�ln� ostro�no�� przy u�yciu tej opcji.

depends: Zamiana wszystkich problem�w z zale�no�ciami na ostrze�enia.

depends-version: Zignorowanie problem�w z numerami wersji przy sprawdzaniu zale�no�ci.

conflicts: Instalacja, nawet gdy pakiet powoduje konflikt z innym. Powsta� mo�e niebezpiecze�stwo nadpisania plik�w z innego pakietu, dlatego nale�y zachowa� ostro�no�� przy u�yciu tej opcji.

overwrite(*): Nadpisanie plik�w z innych pakiet�w, w przypadku gdy dany plik wyst�puje tak�e w innym pakiecie.

overwrite-dir Nadpisanie katalog�w z innych pakiet�w, w przypadku gdy dany katalog wyst�puje tak�e w innym pakiecie.

overwrite-diverted: Nadpisanie plik�w omini�tych plikami nieomini�tymi.

architecture: Dzia�anie obejmie pakiety z niepoprawn� architektur�.

bad-path: Zignorowanie braku pewnych program�w w �cie�ce zmiennej systemowej PATH.

not-root: Pr�ba (de)instalacji, gdy dpkg nie jest uruchamiany z konta root.

--ignore-depends=pakiet,...

Zignorowanie sprawdzania zale�no�ci od podanych pakiet�w (a �ci�lej rzecz bior�c, sprawdzanie si� odbywa, ale w przypadku konflikt�w wy�wietlane jest tylko ostrze�enie).

--largemem | --smallmem

Zarezerwowanie przez dpkg odpowiedniej ilo�ci pami�ci (gdy dost�pne jest wi�cej ni� 4 MB RAM) lub optymalizacja wykorzystania pami�ci.

--new | --old

Wyb�r pomi�dzy nowym i starym formatem binarnym pakietu. Ta opcja jest przes�ana do dpkg-deb(8).

--nocheck

Brak sprawdzania zawarto�ci pliku kontrolnego podczas budowania pakietu. Ta opcja jest przes�ana do dpkg-deb(8).

--no-act

Podejmowane dzia�ania nie powoduj� �adnych zmian. Ta opcja jest u�yteczna, gdy potrzeba sprawdzi�, czy dzia�anie si� wykona, ale bez powodowania zmian czegokolwiek.

Opcj� --no-act nale�y poda� jako pierwszy parametr, gdy� w przeciwnym razie mo�na otrzyma� niespodziewane efekty. (np. dpkg --purge foo --no-act wyczy�ci pakiet foo, a nast�pnie spr�buje wyczy�ci� pakiet o nazwie --no-act).

-R | --recursive

Dzia�anie obejmie wszystkie pliki *.deb z podanego katalogu, wraz z podkatalogami tego katalogu. Ta opcja mo�e zosta� u�yta wraz z -i, -A, --install, --unpack oraz --avail.

-G

Nie instalowanie pakietu, je�li nowszy jest ju� zainstalowany w systemie. Jest to dok�adnie to samo co --refuse-downgrade.

-R | --root=katalog | --admindir=katalog | --instdir=katalog

Zmiana domy�lnych katalog�w. admindir to domy�lnie /var/lib/dpkg, gdzie przechowywane s� informacje o stanie pakiet�w, itp. instdir to domy�lnie / i oznacza katalog w kt�rym zostan� zainstalowane pliki. instdir oznacza r�wnie� katalog na kt�rym zostanie wykonane polecenie chroot(2) przed wykonaniem skrypt�w kontrolnych pakietu. Oznacza to, �e skrypty b�d� uwa�a� katalog instdir za sw�j katalog g��wny. Zmiana katalogu root na katalog spowoduje zmian� katalogu instdir na katalog, a katalogu admindir na katalog/var/lib/dpkg.

-O | --selected-only

Dzia�anie obejmuje wy��cznie pakiety wybrane do instalacji. Wyb�r mo�e zosta� dokonany przez polecenie dselect lub dpkg, gdy podana jest nazwa pakietu.

-E | --skip-same-version

Nie instalowanie pakietu, je�li o tej samej wersji jest ju� zainstalowany w systemie.

PLIKI

Pliki wymienione poni�ej odnosz� si� do swoich domy�lnych katalog�w. Opcja --admindir mo�e zmieni� lokalizacj� tych plik�w.

/var/lib/dpkg/available: Lista dost�pnych pakiet�w.
/var/lib/dpkg/status: Stan dost�pnych pakiet�w. Ten plik zawiera informacje o tym, czy dany pakiet jest wybrany do skasowania, czy jest zainstalowany, itp. Te informacje s� opisane w sekcji INFORMACJE O PAKIETACH. Poni�sze pliki s� cz�ci� sk�adow� pakiet�w binarnych. Wi�cej informacji o nich mo�na znale�� w deb(5).
control
conffiles
preinst
postinst
prerm
postrm

ZMIENNE �RODOWISKA

DPKG_NO_TSTP: Zdefiniuj t� zmienn� je�li chcesz aby dpkg uruchomi� now� sesj� shella zamiast usuwa� si� w t�o, gdy potrzeba wykona� co� w shellu.
SHELL: Program uruchamiany przez dpkg, gdy trzeba uruchomi� now� sesj� shella.

PRZYK�ADY

Wy�wietlenie wszystkich pakiet�w mog�cych by� zwi�zanymi z edytorem vi:
dpkg -l '*vi*'

Wy�wietlenie informacji z pliku /var/lib/dpkg/available o dw�ch pakietach:
dpkg --print-avail elvis vim | less

Samodzielne przeszukanie informacji o pakietach:
less /var/lib/dpkg/available

Wykasowanie zainstalowanego pakietu elvis:
dpkg -r elvis

Aby zainstalowa� pakiet, nale�y wpierw znale�� go w archiwum lub na CDROM. Plik "aviailable" pokazuje, �e pakiet vim jest w sekcji "editors":
cd /cdrom/hamm/hamm/binary/editors dpkg -i vim_4.5-3.tar.gz

Aby stworzy� kopi� lokalnie wybranych pakiet�w:
dpkg --get-selections >mojepakiety

Ten plik mo�na przenie�� do innego systemu i zainstalowa� te pakiety poprzez:
dpkg --set-selections <mojepakiety

Zwyczajowo do wyboru pakiet�w s�u�y dselect(8), kt�ry daje wi�ksze mo�liwo�ci zmiany ich stanu.

ZOBACZ TAK�E

dselect(8), dpkg-deb(1), deb(5), and deb-control(5)

B��DY

--no-act podaje raczej zbyt ma�o pomocnych informacji.

AUTORZY

dpkg stworzyli:
    Ian Jackson <ian@chiark.chu.cam.ac.uk>
    Klee Dienes <klee@debian.org>
    Erick Branderhorst <branderhorst@heel.fgg.eur.nl>
    Miquel van Smoorenburg <miquels@cistron.nl>
    Kim-Minh Kaplan <kkaplan@cdfhp3.in2p3.fr>
    Michael Shields <shields@crosslink.net>
    Bruce Perens <bruce@pixar.com>
    Streeter <streeter@cae.wisc.edu>
    Matt Welsh <mdw@sunsite.unc.edu>
    Ian Murdock <imurdock@debian.org>
    Colin Plumb
    Branko Lankester

Podr�cznik napisa� Juho Vuori <javuori@cc.helsinki.fi>, a uaktualni� Jim Van Zandt <jrv@vanzandt.mv.com>.