.\" dpkg manual page - dpkg-deb(1) .\" .\" Copyright Š 1995-1996 Ian Jackson .\" Copyright Š 1999 Wichert Akkerman .\" Copyright Š 2006 Frank Lichtenheld .\" Copyright Š 2007-2014 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 2014\-08\-20 "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\-\-ctrl\-tarfile\fP \fIarchive\fP Extracts the control data from a binary package and sends it to standard output in \fBtar\fP format (since dpkg 1.17.14). Together with \fBtar\fP(1) this can be used to extract a particular control file from a package archive. The input archive will always be processed sequentially. .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 Specify which compression strategy to use on the compressor backend, when building a package (since dpkg 1.16.2). Allowed values are \fInone\fP (since dpkg 1.16.4), \fIfiltered\fP, \fIhuffman\fP, \fIrle\fP and \fIfixed\fP for gzip (since dpkg 1.17.0) and \fIextreme\fP for xz. .TP \fB\-Z\fP\fItyp\-kompresji\fP Specify which compression type to use when building a package. Allowed values are \fIgzip\fP, \fIxz\fP, \fIbzip2\fP (deprecated), \fIlzma\fP (deprecated), and \fInone\fP (default is \fIxz\fP). .TP \fB\-\-uniform\-compression\fP Specify that the same compression parameters should be used for all archive members (i.e. \fBcontrol.tar\fP and \fBdata.tar\fP). Otherwise only the \fBdata.tar\fP member will use those parameters. The only supported compression types allowed to be uniformly used are \fInone\fP, \fIgzip\fP and \fIxz\fP. .TP \fB\-\-deb\-format=\fP\fIformat\fP Set the archive format version used when building (since dpkg 1.17.0). Allowed values are \fI2.0\fP for the new format, and \fI0.939000\fP for the old one (default is \fI2.0\fP). The old archive format is less easily parsed by non\-Debian tools and is now obsolete; its only use is when building packages to be parsed by versions of dpkg older than 0.93.76 (September 1995), which was released as i386 a.out only. .TP \fB\-\-new\fP This is a legacy alias for \fB\-\-deb\-format=2.0\fP. .TP \fB\-\-old\fP This is a legacy alias for \fB\-\-deb\-format=0.939000\fP. .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 UWAGI 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 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.) . .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