.\" dpkg manual page - dpkg-query(1)
.\"
.\" Copyright ÂŠ 2001 Wichert Akkerman <wakkerma@debian.org>
.\" Copyright ÂŠ 2006-2007 Frank Lichtenheld <djpig@debian.org>
.\" Copyright ÂŠ 2006-2012 Guillem Jover <guillem@debian.org>
.\" Copyright ÂŠ 2008-2011 RaphaĂŤl Hertzog <hertzog@debian.org>
.\"
.\" This is free software; you can 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 of the License, or
.\" (at your option) any later version.
.\"
.\" 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.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program.  If not, see <http://www.gnu.org/licenses/>.
.
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH dpkg\-query 1 2012\-04\-03 "Projekt Debian" "użytki dpkg"
.SH NAZWA
dpkg\-query \- narzędzie przepytywania bazy danych dpkg
.
.SH SKŁADNIA
\fBdpkg\-query\fP [\fIopcja\fP...] \fIpolecenie\fP
.
.SH OPIS
\fBdpkg\-query\fP jest narzędziem służącym do pokazywania informacji o pakietach
wymienionych w bazie danych \fBdpkg\fP.
.
.SH POLECENIA
.TP 
\fB\-l\fP, \fB\-\-list\fP [\fIwzorzec\-nazwy\-pakietu\fP...]
Wypisuje listę pakietów odpowiadających podanemu wzorcu nazwy. Jeśli nie
podano \fIwzorca\-nazwy\-pakietu\fP, wypisuje listę wszystkich pakietów z pliku
\fI/var/lib/dpkg/status\fP, pomijając jednak te, które są oznaczone jako
niezainstalowane (czyli takie, które zostały uprzednio wyczyszczone z plików
konfiguracyjnych \- purge). Do \fIwzorca\-nazwy\-pakietu\fP można wpisać znaki
specjalne powłoki (wildcards). Prawdopodobnie potrzebne będzie zacytowanie
\fIwzorca\-nazwy\-pakietu\fP, aby powłoka nie rozwinęła tego wzorca. Na przykład,
poniższe polecenie wypisze nazwy wszystkich pakietów zaczynających się od
"libc6":

.nf
  \fBdpkg\-query \-l \(aqlibc6*\(aq\fP
.fi

Pierwsze trzy kolumny wyniku pokazują żądane działanie, stan pakietu i
błędy, w tej kolejności.

Żądane działanie:
.nf
  u = Unknown (nieznane)
  i = Install (instalacja)
  h = Hold    (zatrzymanie)
  r = Remove  (usunięcie)
  p = Purge   (wyczyszczenie)
.fi

Stan pakietu:
.nf
  n = Not\-installed     (niezainstalowany)
  c = Config\-files      (pliki konfiguracyjne)
  H = Half\-installed    (częściowo zainstalowany)
  U = Unpacked          (rozpakowany)
  F = Half\-configured   (częściowo skonfigurowany)
  W = Triggers\-awaiting (oczekuje na wyzwalacze)
  t = Triggers\-pending  (przetwarzane wyzwalacze)
  i = Installed         (zainstalowany)
.fi

Oznaczenia błędów:
.nf
  <puste>             (brak)
  R = Reinst\-required (wymagana ponowna instalacja)
.fi

Wielka litera stanu lub błędu oznacza, że pakiet może powodować wiele
problemów. Podręcznik \fBdpkg\fP(1) zawiera informacje na temat powyższych
stanów i oznaczeń.

Format wyjścia tej opcji nie jest konfigurowalny, ale automatycznie się
zmienia, dostosowując się do szerokości terminalu. Jest to przeznaczone dla
ludzi i nie musi być łatwo parsowalne przez maszynę. Patrz opcje \fB\-W\fP
(\fB\-\-show\fP) and \fB\-\-showformat\fP, aby dowiedzieć się, jak skonfigurować
format wyjścia.
.TP 
\fB\-W\fP, \fB\-\-show\fP [\fIwzorzec\-nazwy\-pakietu\fP...]
Zupełnie tak jak opcja \fB\-\-list\fP, ta opcja wyświetli wszystkie pakiety
pasujące do danego wzorca. Jednakże użytkownik może dostosować format
wyjścia do swoich potrzeb za pomocą opcji \fB\-\-showformat\fP. W domyślnym
formacie dla każdego pasującego pakietu wyświetlana jest pojedyncza linia
zawierająca jego nazwę (poszerzoną o oznaczenie architektury w przypadku
pakietów \fIMulti\-arch\fP \fBsame\fP) oraz \- po znaku tabulacji \- zainstalowaną
wersję.
.TP 
\fB\-s\fP, \fB\-\-status\fP \fInazwa\-pakietu\fP...
Podanie stanu pakietu o podanej nazwie. Polecenie po prostu wyświetli
informacje, które znajdują się w bazie danych pakietów. Gdy wypisane jest
wiele \fInazw\-pakietu\fP, to żądane wpisy stanu są oddzielone pustym wierszem,
z tą samą kolejnością jak podano w liście argumentów.
.TP 
\fB\-L\fP, \fB\-\-listfiles\fP \fInazwa\-pakietu\fP...
Podanie listy plików zainstalowanych z \fInazwy\-pakietu\fP. Gdy zainstalowanych
jest wiele \fInazw\-pakietu\fP, to żądane listy plików są oddzielone pustym
wierszem, z tą samą kolejnością jak żądana lista argumentów. Jednakże pliki,
które zostały utworzone przez skrypty instalacyjne pakietu, nie będą podane.
.TP 
\fB\-\-control\-list\fP \fInazwa\-pakietu\fP
Wypisuje pliki kontrolne zainstalowane w systemie z \fInazwy\-pakietu\fP. Mogą
być one użyte jako argumenty wejściowe do \fB\-\-control\-show\fP.
.TP 
\fB\-\-control\-show\fP \fInazwa\-pakietu\fP \fIplik\-kontrolny\fP
Wypisuje \fIplik\-kontrolny\fP zainstalowany w systemie z \fInazwy\-pakietu\fP na
standardowe wyjście.
.TP 
\fB\-c\fP, \fB\-\-control\-path\fP \fInazwa\-pakietu\fP [\fIplik\-kontrolny\fP]
Wyświetla listę ścieżek dla plików kontrolnych instalowanych w systemie
przez pakiet o podanej \fInazwie\-pakietu\fP. Jeśli podany jest
\fIplik\-kontrolny\fP, wyświetlana jest jedynie ścieżka dla tego pliku
kontrolnego, o ile tylko istnieje. \fBUwaga\fP: to polecenie jest przestarzałe,
proszę używać w zamian \fB\-\-control\-list\fP i \fB\-\-control\-show\fP.
.TP 
\fB\-S\fP, \fB\-\-search\fP \fIwzorzec\-wyszukiwania\-nazwy\-pliku\fP...
Szukanie pliku, którego własnością są pliki odnoszące się do podanego
wzorca. Wzorzec może zawierać zwykłe operatory powtórzenia. Polecenie to nie
wyszuka dodatkowych plików tworzonych przez skrypty instalacyjne pakietów
oraz nie wyświetli alternatyw.
.TP 
\fB\-p\fP, \fB\-\-print\-avail\fP \fInazwa\-pakietu\fP...
Wyświetla szczegółowe informacje na temat pakietu \fInazwa\-pakietu\fP,
pochodzące z pliku \fI/var/lib/dpkg/available\fP. Gdy wypisane jest wiele
\fInazw\-pakietu\fP, żądane wpisy \fIavailable\fP są oddzielone pustym wierszem, z
tą samą kolejnością jak podano w liście argumentów.

Użytkownicy nakładek opartych o APT powinni używać \fBapt\-cache show\fP
\fIpackage\-name\fP zamiast tej opcji, ponieważ plik \fIavailable\fP jest
utrzymywany w aktualności jedynie przy użyciu \fBdselect\fP.
.TP 
\fB\-?\fP, \fB\-\-help\fP
Wyświetla informację o użytkowaniu i kończy działanie.
.TP 
\fB\-\-version\fP
Wyświetla informację o wersji i pomyślnie kończy działanie.
.
.SH OPCJE
.TP 
\fB\-\-admindir=\fP\fIkatalog\fP
Zmienia położenie bazy danych \fBdpkg\fP. Domyślnie jest to \fI/var/lib/dpkg\fP.
.TP 
\fB\-\-load\-avail\fP
Ładuje również dostępne pliki podczas używania poleceń \fB\-\-show\fP i
\fB\-\-list\fP, które obecnie domyślnie jedynie odpytują pliki stanu.
.TP 
\fB\-f\fP, \fB\-\-showformat=\fP\fIformat\fP
Opcja jest używana do podania formatu wyjścia produkowanego przez
\fB\-\-show\fP. Format jest łańcuchem znaków, który będzie wyświetlony dla
każdego wypisanego pakietu.

W łańcuchu formatu, \(lq\fB\e\fP\(rq jest znakiem cytowania:

.nf
    \fB\en\fP  nowa linia
    \fB\er\fP  powrót karetki
    \fB\et\fP  tabulacja
.fi

\(lq\fB\e\fP\(rq poprzedzający jakikolwiek inny znak znosi specjalne znaczenie
następującego po nim znaku, co może być przydatne dla \(lq\fB\e\fP\(rq oraz
\(lq\fB$\fP\(rq.

Informacje o pakiecie można wyświetlać, dodając odwołania do pól pakietu z
użyciem składni "\fB${\fP\fIpole\fP[\fB;\fP\fIszerokość\fP]\fB}\fP". Pola są wyrównywane do
prawej strony, chyba że \fIszerokość\fP jest liczbą ujemną, w którym to wypadku
będzie użyte wyrównanie do lewej strony. Rozpoznawane są następujące
\fIpola\fP, ale niekoniecznie są one włączane w pliku statusu (trafiają tam
tylko pola wewnętrzne lub pola zawarte w binarnym pakiecie):

.nf
    \fBArchitecture\fP
    \fBBugs\fP
    \fBConffiles\fP (wewnętrzne)
    \fBConfig\-Version\fP (wewnętrzne)
    \fBConflicts\fP
    \fBBreaks\fP
    \fBDepends\fP
    \fBDescription\fP
    \fBEnhances\fP
    \fBEssential\fP
    \fBFilename\fP (wewnętrzne, związane z interfejsem)
    \fBHomepage\fP
    \fBInstalled\-Size\fP
    \fBMD5sum\fP (wewnętrzne, związane z interfejsem)
    \fBMSDOS\-Filename\fP (wewnętrzne, związane z interfejsem)
    \fBMaintainer\fP
    \fBOrigin\fP
    \fBPackage\fP
    \fBPre\-Depends\fP
    \fBPriority\fP
    \fBProvides\fP
    \fBRecommends\fP
    \fBReplaces\fP
    \fBRevision\fP (przestarzałe)
    \fBSection\fP
    \fBSize\fP (wewnętrzne, związane z interfejsem)
    \fBSource\fP
    \fBStatus\fP (wewnętrzne)
    \fBSuggests\fP
    \fBTag\fP (zwykle nie w .deb, ale w plikach Packages repozytorium)
    \fBTriggers\-Awaited\fP (wewnętrzne)
    \fBTriggers\-Pending\fP (wewnętrzne)
    \fBVersion\fP
.fi

Poniższe pola są wirtualne i są tworzone przez \fBdpkg\-query\fP z wartości
pobranych z innych pól (proszę zauważyć, że nie używają one prawidłowych
nazw pól w plikach kontrolnych):

.nf
    \fBbinary:Package\fP
    \fBbinary:Summary\fP
    \fBdb:Status\-Abbrev\fP
    \fBsource:Package\fP
    \fBsource:Version\fP
.fi

Domyślnym formatem jest \(lq\fB${binary:Package}\et${Version}\en\fP\(rq. Można
również zażądać wszystkich pozostałych pól z pliku status (tj. pól
zdefiniowanych przez użytkownika). Zostaną one wypisane w takiej postaci, w
jakiej znajdują się w pliku status, nie będzie więc dokonywana żadna
konwersja czy sprawdzanie błędów. \fBbinary:Package\fP jest specjalnym polem,
które wyświetla nazwę pakietu z oznaczeniem architektury (takim jak
"libc6:amd64"), jeśli pakiet posiada pole \fIMulti\-Arch\fP z wartością \fBsame\fP
i w związku z tym jego nazwa mogłaby być niejednoznaczna. Aby wyświetlić
nazwę opiekuna pakietu dpkg i zainstalowaną wersję tego pakietu, można
uruchomić:

.nf
  \fBdpkg\-query \-W \-f=\(aq${binary:Package} ${Version}\et${Maintainer}\en\(aq dpkg\fP
.fi
.
.SH "KOD WYJŚCIA"
.TP 
\fB0\fP
Żądane zapytanie zakończyło się powodzeniem.
.TP 
\fB1\fP
Wystąpiły problemy podczas przetwarzania linii poleceń lub wykonywania
odpytywania, w tym nie znaleziono pliku lub pakietu (z wyjątkiem dla
\-\-control\-path).
.
.SH ŚRODOWISKO
.TP 
\fBDPKG_ADMINDIR\fP
Jeśli jest ustawiona i nie użyto opcji \fB\-\-admindir\fP, będzie używana jako
katalog danych dpkg.
.TP 
\fBCOLUMNS\fP
Zmienna ta wpływa na wyjście polecenia \fB\-\-list\fP, zmieniając jego szerokość.
.
.SH "ZOBACZ TAKŻE"
\fBdpkg\fP(1).

.SH "TŁUMACZE"
Piotr Roszatycki <dexter@debian.org>, 1999
.br
Bartosz Feński <fenio@debian.org>, 2004-2005
.br
Robert Luberda <robert@debian.org>, 2006-2008
.br
Wiktor Wandachowicz <siryes@gmail.com>, 2008
.br
Michał Kułach <michal.kulach@gmail.com>, 2012
