NAZWA¶

dpkg-gencontrol - tworzy pliki kontrolne Debiana

SKŁADNIA¶

dpkg-gencontrol [opcja...]

OPIS¶

dpkg-gencontrol czyta informacje z rozpakowanego drzewa źródeł pakietu Debiana i generuje plik kontrolny pakietu binarnego (domyślnie jest to debian/tmp/DEBIAN/control), upraszczając podczas tego procesu pola dotyczące zależności. Pola Pre-Depends, Depends, Recommends oraz Suggests są upraszczane w tej właśnie kolejności przez usuwanie zależności o których wiadomo, że są prawdziwe, ponieważ wynikają z innych, przetworzonych już mocniejszych zależności. Usunięte także będą wszelkie zależności pakietu od samego siebie (dokładniej: usunięte będą wszystkie zależności, które będą prawdziwe po zainstalowaniu bieżącej wersji pakietu). Mówiąc językiem logiki, zachowana będzie część wspólna ze zbioru wszystkich zależności dotyczących tego samego pakietu. Porządek zależności jest zachowywany w takim stopniu, w jakim jest to tylko możliwe: jeżeli jakaś zależność musi być usunięta z powodu innej zależności występującej dalej w danym polu, wypierająca zależność zajmie miejsce tej usuwanej. Pozostałe pola relacyjne ( Enhances, Conflicts, Breaks, Replaces oraz Provides) także są indywidualnie upraszczane przez wyliczanie sumy różnych zależności, jeśli w danym polu pakiet jest wymieniony wiele razy. dpkg-gencontrol dodaje ponadto wpis dotyczący pakietu binarnego do debian/files.

OPCJE¶

-vwersja

Ustawia numer wersji generowanego pakietu binarnego.

-Vnazwa=wartość

Ustawia zmienną podstawienia wyjścia. Szczegółowy opis podstawiania zmiennych wyjściowych znajduje się w deb-substvars(5).

-Tplik-zmiennych-podst

Odczytuje zmienne podstawiania z pliku-zmiennych-podst; domyślnie jest to debian/substvars. Opcja może być użyta wielokrotnie, aby odczytać podstawiania z wielu plików.

-Dpole=wartość

Nadpisuje lub dodaje wyjściowe pole pliku kontrolnego.

-Upole

Usuwa wyjściowe pole pliku kontrolnego.

-cplik-kontrolny

Określa główny plik kontrolny, z którego będą czytane informacje. Domyślnie jest to debian/control.

-lplik-dziennika-zmian

Określa dziennik zmian, z którego będą czytane informacje. Domyślnym plikiem jest debian/changelog.

-fplik-z-listą-plików

Czyta lub zapisuje listę plików wydania do pliku podanego jako argument tej opcji, zamiast do pliku debian/files.

-Fformat-dziennika-zmian

Określa format dziennika zmian. Więcej informacji o alternatywnych formatach można znaleźć w dpkg-parsechangelog(1).

-ppakiet

Generuje informacje o pakiecie binarnym pakiet. Jeżeli plik kontrolny pakietu źródłowego wymienia tylko jeden pakiet binarny, to opcję tę można pominąć, w przeciwnym wypadku wymagane jest wskazanie, dla którego pakietu binarnego wygenerować informacje.

-nnazwa_pliku

Określa, że nazwą pliku pakietu będzie nazwa_pliku zamiast normalnej nazwy pliku w postaci pakiet_wersja_architektura.deb

-is, -ip, -isp

Te opcje są ignorowane w celu zachowania kompatybilności ze starszymi wersjami dpkg-dev, obecnie są uznawane za przestarzałe. Poprzednio były używane do nakazania programowi dpkg-gencontrol włączenia pól Section i Priority do pliku kontrolnego. Obecnie jest to domyślne zachowanie. Aby uzyskać poprzednie zachowanie, można użyć opcji -U, dzięki której można usunąć powyższe pola z pliku kontrolnego.

-Pkatalog-budowania-pakietu

Mówi programowi dpkg-source, że pakiet jest budowany w katalogu-budowania-pakietu, zamiast w debian/tmp. Katalog ten jest używany do znalezienia domyślnych wartości zmiennej podstawiania Installed-Size i pola w pliku kontrolnym o tej samej nazwie (przy użyciu du) oraz domyślnej lokalizacji pliku wynikowego.

-O

Wypisuje plik kontrolny na standardowe wyjście, a nie do pliku debian/tmp/DEBIAN/control (lub katalogu-budowania-pakietu /DEBIAN/control, gdy użyto -P).

-?, --help

Wyświetla informację o użytkowaniu i kończy działanie.

--version

Wyświetla informację o wersji i pomyślnie kończy działanie.

PLIKI¶

debian/control

Główny plik kontrolny, zawierający niezależne od wersji informacje zarówno o pakiecie źródłowym, jak i o pakietach binarnych, które są tworzone z pakietu źródłowego.

debian/files

Lista wygenerowanych plików, które są częścią przygotowywanego wydania. dpkg-gencontrol zapisuje tutaj przypuszczalne nazwy plików-pakietów binarnych generowanych z pliku kontrolnego.

TŁUMACZE¶

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