.\" dpkg manual page - dpkg-deb(1) .\" .\" Copyright Š 1995-1996 Ian Jackson .\" Copyright Š 1999 Wichert Akkerman .\" Copyright Š 2006 Frank Lichtenheld .\" Copyright Š 2007-2012 Guillem Jover .\" .\" 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 . . .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH dpkg\-deb 1 2012\-05\-27 "Projekt Debian" "użytki dpkg" .SH NAZWA dpkg\-deb \- narzędzie obsługi plików archiwum Debiana (.deb) . .SH SKŁADNIA \fBdpkg\-deb\fP [\fIopcja\fP...] \fIpolecenie\fP . .SH OPIS \fBdpkg\-deb\fP tworzy, rozpakowuje i podaje informacje o plikach archiwum (czyli pakietach) Debiana. .PP Do instalowania i usuwania pakietów z systemu służy polecenie \fBdpkg\fP. .PP Ponadto można skorzystać z \fBdpkg\-deb\fP wywołując \fBdpkg\fP z odpowiednią opcją, która zostanie przekazana do \fBdpkg\-deb\fP. \fBdpkg\fP uruchomi \fBdpkg\-deb\fP i wykona żądaną operację. . .SH POLECENIA .TP \fB\-b\fP, \fB\-\-build\fP \fIkatalog\fP [\fIarchiwum\fP|\fIkatalog\fP] Tworzy archiwum Debiana z plików zawartych w \fIkatalogu\fP. \fIkatalog\fP musi zawierać podkatalog o nazwie \fBDEBIAN\fP, w którym zawarte są pliki kontrolne, takie jak np. control. Ten katalog \fInie\fP pojawi się w archiwum binarnym pakietu, tylko zostanie umieszczony jako informacje kontrolne pakietu, które opisują właściwości pakietu. Jeśli pominięto opcję \fB\-\-nocheck\fP, \fBdpkg\-deb\fP odczyta plik \fBDEBIAN/control\fP i przetworzy go. Sprawdzi przy tym, czy nie występują w nim błędy składniowe lub inne problemy, a następnie wyświetli nazwę pakietu, który jest tworzony. \fBdpkg\-deb\fP ponadto sprawdzi prawa dostępu skryptów instalacyjnych i innych plików znajdujących się w katalogu \fBDEBIAN\fP. Jeśli nie podano nazwy \fIarchiwum\fP, to \fBdpkg\-deb\fP zapisze pakiet w pliku \fIkatalog\fP\fB.deb\fP. Jeżeli taki pakiet już istnieje, to zostanie nadpisany. Jeśli drugim argumentem jest \fIkatalog\fP, to \fBdpkg\-deb\fP zapisze pakiet pod nazwą \fIkatalog\fP\fB/\fP\fIpakiet\fP\fB_\fP\fIwersja\fP\fB_\fP\fIarch\fP\fB.deb\fP lub \fIkatalog\fP\fB/\fP\fIpakiet\fP\fB_\fP\fIwersja\fP\fB.deb\fP, jeśli nie zostało określone pole \fBArchitecture\fP w pliku kontrolnym. Gdy podany jest \fIkatalog\fP, to nie może zostać użyta opcja \fB\-\-no\-check\fP, ponieważ \fBdpkg\-deb\fP musi przetworzyć plik kontrolny, aby rozpoznać nazwę i wersję pakietu. .TP \fB\-I\fP, \fB\-\-info\fP \fIarchiwum\fP [\fInazwa\-pliku\-kontrolnego\fP...] Dostarcza informacji o pakiecie. Gdy nie podano żadnej \fInazwy\-pliku\-kontrolnego\fP, wyświetlana jest informacja o zawartości pakietu oraz zestawienie wykorzystanych plików kontrolnych. W razie podania \fInazwy\-pliku\-kontrolnego\fP, \fBdpkg\-deb\fP wyświetli zawartość tego pliku. Jeśli ten plik nie istnieje, wyświetlony zostanie komunikat błędu na standardowe wyjście błędów i program zakończy się z kodem błędu 2. .TP \fB\-W\fP, \fB\-\-show\fP \fIarchiwum\fP Wyświetla informację o pakiecie binarnym w formacie określonym opcją \fB\-\-showformat\fP. W domyślnym formacie w każdej linii wyświetlane są nazwa i wersja pakietu, oddzielone od siebie znakiem tabulacji. .TP \fB\-f\fP, \fB\-\-field\fP \fIarchiwum\fP [\fInazwa\-pola\-kontrolnego\fP...] Wyświetla zawartość pliku kontrolnego o nazwie control. Jeśli nie podano żadnej \fBnazwy\-pola\-kontrolnego\fP, to wyświetlana jest zawartość całego pliku control. Jeśli podano \fBnazwę\-pola\-kontrolnego\fP, to \fBdpkg\-deb\fP wyświetli jej zawartość. Gdy podano więcej niż jedną \fBnazwę\-pola\-kontrolnego\fP, to \fBdpkg\-deb\fP wyświetli pola wraz z nazwą (oraz dwukropkiem i spacją) w takiej kolejności, w jakiej są wymienione w pliku kontrolnym. Dla nieodnalezionych pól kontrolnych nie są wyświetlane komunikaty błędów. .TP \fB\-c\fP, \fB\-\-contents\fP \fIarchiwum\fP Wyświetla zawartość archiwum. Wydruk jest podany w takiej postaci, jaką generuje polecenie \fBtar\fP. .TP \fB\-x\fP, \fB\-\-extract\fP \fIkatalog archiwum\fP Rozpakowuje zawartość archiwum do podanego \fIkatalogu\fP. Proszę zauważyć, że rozpakowanie pakietu w katalogu głównym \fInie\fP jest odpowiednikiem zainstalowania pakietu! Do tego celu służy wyłącznie polecenie \fBdpkg\fP. \fIkatalog\fP (ale bez katalogów nadrzędnych) zostanie utworzony jeśli trzeba, a jego uprawnienia zostaną zmodyfikowane tak, aby odpowiadały zawartości pakietu. .TP \fB\-X\fP, \fB\-\-vextract\fP \fIkatalog archiwum\fP Działa podobnie do \fB\-\-extract\fP (\fB\-x\fP) z \fB\-\-verbose\fP (\fB\-v\fP), które wypisuje nazwy plików, które są rozpakowywane. .TP \fB\-R\fP, \fB\-\-raw\-extract\fP \fIarchiwum katalog\fP Rozpakowuje zawartość archiwum do podanego katalogu, a pliki informacji kontrolnych do podkatalogu DEBIAN podanego katalogu. W razie potrzeby, katalog docelowy będzie utworzony. .TP \fB\-\-fsys\-tarfile\fP \fIarchiwum\fP Rozpakowuje pliki z archiwum i wysyła je na standardowe wyjście w postaci formatu polecenia \fBtar\fP. Gdy ta operacja zostanie połączona z \fBtar\fPem, możliwe jest rozpakowanie tylko wybranych plików z archiwum. Wejście będzie zawsze przetwarzane sekwencyjnie. .TP \fB\-e\fP, \fB\-\-control\fP \fIarchiwum\fP [\fIkatalog\fP] Rozpakowuje pliki kontrolne pakietu do podanego \fIkatalogu\fP. Jeśli \fIkatalog\fP nie został określony, pliki są rozpakowywane do podkatalogu \fBDEBIAN\fP w katalogu bieżącym. W razie potrzeby, katalog docelowy będzie utworzony. .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\-\-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. Argumentem jest łańcuch znaków w postaci "${\fInazwa\-pola\fP}", który może się odnosić do dowolnego pola pliku stanu. Listę nazw poprawnych pól można łatwo wygenerować, używając opcji \fB\-I\fP na tym samym pakiecie. Pełne wyjaśnienie opcji formatowania (łącznie z sekwencjami cytowania i rozdzielaniem pól) można znaleźć w opisie opcji \fB\-\-showformat\fP w \fBdpkg\-query\fP(1). Domyślną wartością tego pola jest "${Package}\et${Version}\en". .TP \fB\-z\fP\fIpoziom\-kompresji\fP Określa poziom kompresji używany przez program kompresujący podczas budowania pakietu (domyślnie: 9 w przypadku gzip i bzip9, 6 \- xz i lzma). Akceptowanymi wartościami są 0\-9, gdzie 0 jest tłumaczone na brak kompresji w przypadku gzip i 1 w przypadku bzip2. Przed dpkg 1.16.2 poziom 0 był odpowiednikiem braku kompresji w przypadku wszystkich programów kompresujących. .TP \fB\-S\fP\fIstrategia\-kompresji\fP Określa strategię kompresji używaną przez program kompresujący podczas budowania pakietu (od dpkg 1.16.2). Dozwolone wartości to: \fInone\fP (od wersji 1.16.4 dpkg) i \fIextreme\fP w przypadku xz. .TP \fB\-Z\fP\fItyp\-kompresji\fP Określa typ kompresji używany podczas budowania pakietu. Dozwolonymi wartościami są: \fIgzip\fP, \fIxz\fP, \fIbzip2\fP, \fIlzma\fP oraz \fInone\fP (domyślną wartością jest \fIgzip\fP). .TP \fB\-\-new\fP Zapewnia, że \fBdpkg\-deb\fP utworzy "nowy" format archiwum. Ta opcja jest domyślna. .TP \fB\-\-old\fP Wymusza utworzenie przez \fBdpkg\-deb\fP "starego" formatu archiwum. Ten format jest słabo obsługiwany przez narzędzia spoza dystrybucji Debiana i obecnie jest przestarzały. Ta opcja jest użyteczna jedynie w przypadku korzystania z wersji dpkg wcześniejszej niż 0.93.76 (wrzesień 1995), która była opublikowana jedynie dla i386 a.out. .TP \fB\-\-nocheck\fP Powoduje, że polecenie \fBdpkg\-deb \-\-build\fP nie będzie sprawdzać zawartości archiwum. W ten sposób można utworzyć niepoprawny pakiet, jeśli zajdzie taka potrzeba. .TP \fB\-v\fP, \fB\-\-verbose\fP Włącza wyświetlanie szczegółowych informacji. Obecnie wpływa jedynie na \fB\-\-extract\fP, dzięki czemu zachowuje się ono jak \fB\-\-vextract\fP. .TP \fB\-D\fP, \fB\-\-debug\fP Włącza opcję debugowania. Nie jest to zbyt interesujące. . .SH ŚRODOWISKO .TP \fBTMPDIR\fP Jeśli jest ustawiona, \fBdpkg\-deb\fP będzie jej używał jako katalogu do tworzenia plików i katalogów tymczasowych. . .SH BŁĘDY \fBdpkg\-deb \-I\fP \fIpakiet1\fP\fB.deb\fP \fIpakiet2\fP\fB.deb\fP działa niepoprawnie. Nie ma sprawdzania autentyczności plików \fB.deb\fP, a nawet nie ma prostej sumy kontrolnej. (Narzędzia wyższego poziomu takie jak APT wspierają uwierzytelnianie pakietów \fB.deb\fP pobieranych z danego repozytorium, zaś większość współczesnych pakietów dostarcza plik kontrolny md5sum wygenerowany przez debian/rules. Niestety, nie jest to bezpośrednio wspierane przez narzędzia niższego poziomu.) Nie należy używać \fBdpkg\-deb\fP do instalowania oprogramowania! Do tego celu należy korzystać z \fBdpkg\fP, który zainstaluje poprawnie pliki i uruchomi potrzebne skrypty instalacyjne. . .SH "ZOBACZ TAKŻE" \fBdeb\fP(5), \fBdeb\-control\fP(5), \fBdpkg\fP(1), \fBdselect\fP(1). .SH "TŁUMACZE" Piotr Roszatycki , 1999 .br Bartosz Feński , 2004-2005 .br Robert Luberda , 2006-2008 .br Wiktor Wandachowicz , 2008 .br Michał Kułach , 2012