dpkg-source — Online w chmurze

PROGRAM:

IMIĘ

dpkg-source - narzędzie do manipulacji pakietem źródłowym Debiana (.dsc).

STRESZCZENIE

dpkg-źródło [opcja...] komenda

OPIS

dpkg-źródło pakuje i rozpakowuje archiwa źródłowe Debiana.

Żadne z tych poleceń nie pozwala na połączenie wielu opcji w jedną i tak nie jest
pozwala na określenie wartości opcji w oddzielnym argumencie.

POLECENIA

-x, --wyciąg filenamedsc [katalog wyjściowy]
Wyodrębnij pakiet źródłowy (--wyciąg od dpkg 1.17.14). Jeden argument nieopcjonalny
należy podać nazwę pliku kontroli źródła Debiana (dsc). Opcja
Można podać drugi argument niebędący opcją, aby określić katalog, w którym ma zostać wyodrębniony plik
pakiet źródłowy, to nie może istnieć. Jeśli nie określono żadnego katalogu wyjściowego, plik
pakiet źródłowy jest wyodrębniany do katalogu o nazwie źródło-wersja pod prąd
katalog roboczy.

dpkg-źródło odczyta nazwy innych plików tworzących pakiet źródłowy
z pliku kontrolnego; zakłada się, że znajdują się one w tym samym katalogu co plik dsc.

Pliki w wyodrębnionym pakiecie będą miały ustawione uprawnienia i własność
do tych, których można by się spodziewać, gdyby pliki i katalogi po prostu to zrobiły
zostały utworzone - katalogi i pliki wykonywalne będą miały numer 0777, a zwykłe pliki będą miały numer XNUMX
być 0666, oba modyfikowane przez umask ekstraktorów; jeśli katalog nadrzędny to setgid
wtedy wyodrębnione katalogi również będą, podobnie jak wszystkie pliki i katalogi
odziedziczyć własność grupową.

Jeśli pakiet źródłowy używa niestandardowego formatu (obecnie oznacza to wszystkie formaty
z wyjątkiem „1.0”), jego nazwa zostanie zapisana w debian/źródło/format tak, że
następujące kompilacje pakietu źródłowego domyślnie używają tego samego formatu.

-b, --budować katalog [parametry specyficzne dla formatu]
Zbuduj pakiet źródłowy (--budować od dpkg 1.17.14). Pierwszy argument niebędący opcją
jest przyjmowana jako nazwa katalogu zawierającego zdebianizowane drzewo źródłowe (tj
z podkatalogiem Debiana i być może zmianami w oryginalnych plikach). Zależy od
format pakietu źródłowego użytego do zbudowania pakietu, mogą to być dodatkowe parametry
przyjęty.

dpkg-źródło zbuduje pakiet źródłowy w pierwszym formacie znalezionym w this
lista uporządkowana: format wskazany przez --format opcja wiersza poleceń,
formacie wskazanym w debian/źródło/format, „1.0”. Powrót do „1.0” jest taki
przestarzałe i zostaną usunięte w pewnym momencie w przyszłości, zawsze powinieneś to zrobić
udokumentuj żądany format źródłowy w debian/źródło/format. Patrz sekcja ŹRÓDŁO
PAKIET FORMATY aby uzyskać obszerny opis różnych formatów pakietów źródłowych.

--format wydruku katalog
Wydrukuj format źródłowy, który zostanie użyty do zbudowania pakietu źródłowego if
dpkg-źródło --budować katalog został wezwany (w tych samych warunkach i z tymi samymi
parametry; od dpkg 1.15.5).

--przed zbudowaniem katalog
Uruchom odpowiedni hak formatu pakietu źródłowego (od dpkg 1.15.8). Ten
hook jest wywoływany przed jakąkolwiek kompilacją pakietu (dpkg-buildpackage nazywa to bardzo
wcześnie, nawet wcześniej debian/zasady kleń). To polecenie jest idempotentne i można je wywołać
wiele razy. Nie wszystkie formaty źródłowe implementują coś w tym haku i innych
które zwykle przygotowują drzewo źródłowe do kompilacji, na przykład zapewniając to
zastosowane są łatki Debiana.

--po kompilacji katalog
Uruchom odpowiedni hak formatu pakietu źródłowego (od dpkg 1.15.8). Ten
hook jest wywoływany po dowolnej kompilacji pakietu (dpkg-buildpackage nazywa to ostatnim).
To polecenie jest idempotentne i można je wywołać wiele razy. Nie wszystkie formaty źródłowe
zaimplementuj coś w tym haku, a te, które to robią, zwykle używają go do cofnięcia czego
--przed zbudowaniem zrobił.

--popełniać [katalog] ...
Zapisz zmiany w drzewie źródłowym po rozpakowaniu katalog (od dpkg 1.16.1). Ten
polecenie może przyjmować dodatkowe parametry w zależności od formatu źródłowego. To będzie
błąd dla formatów, w których ta operacja nic nie znaczy.

-?, --help
Pokaż komunikat o użyciu i wyjdź.

--wersja
Pokaż wersję i wyjdź.

OPCJE

Rodzajowy budować Opcje
-cplik-kontrolny
Określa główny plik kontrolny źródła, z którego mają być odczytywane informacje. Wartość domyślna to
debian / control. Jeśli podano ze względną nazwą ścieżki, jest ona interpretowana począwszy od
katalog najwyższego poziomu drzewa źródłowego.

-lplik-dziennika zmian
Określa plik dziennika zmian, z którego mają być odczytywane informacje. Wartość domyślna to
debian/list zmian. Jeśli podano ze względną nazwą ścieżki, jest ona interpretowana począwszy od
katalog najwyższego poziomu drzewa źródłowego.

-Fformat dziennika zmian
Określa format dziennika zmian. Widzieć dpkg-parsechangelog(1) w celach informacyjnych
o alternatywnych formatach.

--format=wartość
Użyj podanego formatu do zbudowania pakietu źródłowego (od dpkg 1.14.17). To robi
zastąpić dowolny format podany w debian/źródło/format.

-VNazwa=wartość
Ustaw zmienną podstawienia wyjścia. Widzieć deb-substvars(5) do dyskusji na temat
substytucja wyjścia.

-Tpodstvars-plik
Czytaj zmienne podstawienia w podstvars-plik; domyślnie nie czyta żadnego pliku.
Ta opcja może być użyta wiele razy, aby odczytać podstawione zmienne z wielu
pliki (od dpkg 1.15.6).

-Dpole=wartość
Zastąp lub dodaj pole wyjściowego pliku sterującego.

-Upole
Usuń pole wyjściowego pliku kontrolnego.

-Zkompresja, --kompresja=kompresja
Określ kompresję, która ma być używana dla tworzonych archiwów tar i plików różnicowych (--kompresja
od dpkg 1.15.5). Należy pamiętać, że ta opcja nie spowoduje, że istniejące archiwum tar będzie nieaktywne
ponownie skompresowany, dotyczy to tylko nowych plików. Obsługiwane wartości to: gzip, bzip2, Izma
i xz, Wartość domyślna to xz dla formatów 2.0 i nowszych oraz gzip dla formatu 1.0. xz
jest obsługiwany dopiero od wersji dpkg 1.15.5.

-zpoziom, --poziom kompresji=poziom
Poziom kompresji, którego należy użyć (--poziom kompresji od dpkg 1.15.5). Jak z -Z it
wpływa tylko na nowo utworzone pliki. Obsługiwane wartości to: 1 do 9, Najlepiej, szybki.
Wartość domyślna to 9 dla gzip i bzip2, 6 dla xz i lzma.

-i[regex], --diff-ignore[=regex]
Możesz określić wyrażenie regularne Perla pasujące do plików, z których chcesz odfiltrować
lista plików dla różnicy (--diff-ignore od dpkg 1.15.6). (Ta lista jest
wygenerowany przez polecenie find.) (Jeśli pakiet źródłowy jest budowany w wersji 3
pakiet źródłowy korzystający z VCS, można tego użyć do zignorowania niezatwierdzonych zmian
określone pliki. Użycie -i.* zignoruje je wszystkie.)

Połączenia -i Opcja sama włącza to ustawienie z domyślnym wyrażeniem regularnym (zachowując dowolne
modyfikacja domyślnego wyrażenia regularnego dokonana przez wcześniejsze użycie --extend-diff-ignore)
który odfiltruje pliki kontrolne i katalogi najczęstszej wersji
systemy kontrolne, kopie zapasowe i pliki wymiany oraz Libtool budujący katalogi wyjściowe. Tam
może być tylko jednym aktywnym wyrażeniem regularnym lub wieloma -i opcje zostaną wybrane tylko ostatnie
efekt.

Jest to bardzo pomocne przy wycinaniu zbędnych plików, które zostaną uwzględnione w pliku różnicowym,
np. jeśli utrzymujesz swoje źródło w systemie kontroli wersji i chcesz użyć pliku a
checkout, aby zbudować pakiet źródłowy bez dołączania dodatkowych plików i
katalogi, które zwykle będzie zawierał (np. CVS/, .cvsignore, .svn/). The
domyślne wyrażenie regularne jest już bardzo wyczerpujące, ale jeśli chcesz je zastąpić, proszę
pamiętaj, że domyślnie może pasować do dowolnej części ścieżki, więc jeśli chcesz dopasować
początek nazwy pliku lub tylko pełne nazwy plików, konieczne będzie podanie niezbędnych informacji
kotwice (np. „(^|/)”, „($|/)”) samodzielnie.

--extend-diff-ignore=regex
Określone wyrażenie regularne Perla rozszerzy wartość domyślną używaną przez
--diff-ignore i jego aktualną wartość, jeśli jest ustawiona (od dpkg 1.15.6). Robi to poprzez
łączenie „|regex” do istniejącej wartości. Ta opcja jest wygodna w użyciu
debian/źródło/opcje aby wykluczyć niektóre automatycznie wygenerowane pliki z automatycznej poprawki
generacja.

-I[wzór pliku], --tar-ignore[=wzór pliku]
Jeśli ta opcja jest określona, ​​wzór zostanie przekazany do smoła(1) --wykluczać
opcja, gdy jest wywoływana w celu wygenerowania pliku .orig.tar lub .tar (--tar-ignore ponieważ
dpkg 1.15.6). Na przykład, -ICVS sprawi, że tar pominie katalogi CVS, gdy
wygenerowanie pliku .tar.gz. Opcję można powtórzyć wiele razy, aby wyświetlić listę
wiele wzorców do wykluczenia.

-I sam dodaje wartość domyślną --wykluczać opcje, które odfiltrują pliki kontrolne i
katalogi najpopularniejszych systemów kontroli wersji, kopie zapasowe i pliki wymiany oraz
Libtool buduje katalogi wyjściowe.

Uwaga: Chociaż mają podobne cele, -i i -I mają bardzo różną składnię i
semantyka. -i można określić tylko raz i przyjmuje wyrażenie regularne zgodne z Perlem
która jest dopasowywana do pełnej ścieżki względnej każdego pliku. -I można określić wiele
razy i przyjmuje wzorzec nazwy pliku ze znakami wieloznacznymi powłoki. Wzór jest stosowany do
pełnej ścieżki względnej, ale także do każdej części ścieżki indywidualnie. Dokładna semantyka
smoła --wykluczać opcja jest nieco skomplikowana, patrz
https://www.gnu.org/software/tar/manual/tar.html#wildcards for a full documentation.

Domyślne wyrażenie regularne i wzorce dla obu opcji można zobaczyć na wyjściu funkcji --help
dowództwo.

Rodzajowy wyciąg Opcje
--bez kopii
Nie kopiuj oryginalnych plików tar w pobliżu rozpakowanego pakietu źródłowego (ponieważ dpkg
1.14.17).

--bez sprawdzania
Nie sprawdzaj podpisów i sum kontrolnych przed rozpakowaniem (od dpkg 1.14.17).

--wymagaj-ważnego-podpisu
Odmów rozpakowania pakietu źródłowego, jeśli nie zawiera on podpisu OpenPGP
można zweryfikować (od wersji dpkg 1.15.0) albo za pomocą użytkownika zaufaneklucze.gpg brelok,
jeden z breloczków specyficznych dla dostawcy lub jeden z oficjalnych breloczków Debiana
(/usr/share/keyrings/debian-keyring.gpg i
/usr/share/keyrings/debian-maintainers.gpg).

--ignore-złą-wersję
Zmienia sprawdzenie złej wersji pakietu źródłowego w niekrytyczne ostrzeżenie (ponieważ dpkg
1.17.7). Ta opcja powinna być konieczna tylko podczas wyodrębniania starożytnego źródła
pakiety z uszkodzonymi wersjami, tylko dla kompatybilności wstecznej.

ŹRÓDŁO PAKIET FORMATY

Jeśli nie wiesz, jakiego formatu źródłowego użyć, prawdopodobnie powinieneś wybrać „3.0 (kołdra)”.
lub „3.0 (natywny)”. Zobacz https://wiki.debian.org/Projects/DebSrc3.0, aby uzyskać informacje na temat
wdrożenie tych formatów w Debianie.

Format: 1.0
Pakiet źródłowy w tym formacie składa się z pliku .oryg.tar.gz związane z .rozn.gz
lub singiel .tar.gz (w takim przypadku mówi się, że pakiet to rodzimy).

Ekstrahujący

Wyodrębnianie pakietu natywnego polega na prostym wyodrębnieniu pojedynczego archiwum tar w miejscu docelowym
informator. Wyodrębnianie pakietu innego niż natywny odbywa się poprzez pierwsze rozpakowanie pliku .oryg.tar.gz i
następnie nakładając łatkę zawartą w pliku .rozn.gz plik. Sygnatura czasowa wszystkich poprawionych plików
jest resetowany do czasu wyodrębnienia pakietu źródłowego (pozwala to uniknąć zniekształceń znacznika czasu na początku
na problemy podczas łatania automatycznie generowanych plików). Różnica może tworzyć nowe pliki (
cały katalog Debiana jest tworzony w ten sposób), ale nie może usunąć plików (puste pliki zostaną
zostało).

Budowanie

Budowanie pakietu natywnego polega po prostu na utworzeniu pojedynczego archiwum tar z katalogiem źródłowym.
Budowanie pakietu innego niż natywny wymaga wyodrębnienia oryginalnego archiwum tar w osobnym pliku
Katalog „.orig” i ponowne wygenerowanie pliku .rozn.gz porównując pakiet źródłowy katalog
z katalogiem .orig.

Budować Opcje (z --zbudować):

Jeśli podano drugi argument niebędący opcją, powinna to być nazwa oryginalnego źródła
katalog lub plik tar lub pusty ciąg znaków, jeśli pakiet jest pakietem specyficznym dla Debiana i tak dalej
nie ma różnic w debianizacji. Jeśli nie zostanie podany drugi argument, wówczas dpkg-źródło będzie wyglądać
dla oryginalnego źródłowego pliku tar wersja_pakietu_upstream.oryg.tar.gz lub oryginał
katalog źródłowy katalog.pochodzenie w zależności od -sX argumenty.

-sa, -sp, -sk, -jego i -sr nie nadpisze istniejących plików tar ani katalogów. Jeśli to jest
pożądane wtedy -SA, -sP, -SK, -jego i -Pan powinien być użyty zamiast tego.

-sk Określa, że ​​domyślnie oczekuje się oryginalnego źródła w postaci pliku tar pakiet_upstream-
wersja.orig.tar.rozbudowa. Pozostawi to oryginalne źródło na miejscu jako plik
tar lub skopiuj go do bieżącego katalogu, jeśli jeszcze go tam nie ma. Plik tar
zostanie rozpakowany katalog.pochodzenie do generowania mechanizmu różnicowego.

-sp Jak -sk ale później ponownie usunę katalog.

-jego Określa, że ​​domyślnie oczekuje się, że oryginalnym źródłem będzie katalog pakiet-
wersja upstream.pochodzenie i dpkg-źródło utworzy nowe oryginalne archiwum źródłowe
z tego.

-sr Jak -jego ale usunie ten katalog po jego użyciu.

-ss Określa, że ​​oryginalne źródło jest dostępne zarówno jako katalog, jak i jako plik
plik tar. dpkg-źródło użyje katalogu do utworzenia różnicy, ale plik tar do
utwórz dsc. Opcji tej należy używać ostrożnie - jeśli katalog i plik tar
nie pasują, zostanie wygenerowane złe archiwum źródłowe.

-SN Określa, że ​​nie należy szukać żadnego oryginalnego źródła i nie generować porównania. The
drugi argument, jeśli został podany, musi być pustym ciągiem znaków. Jest to używane w Debianie-
specyficzne pakiety, które nie mają oddzielnego źródła pierwotnego i dlatego je posiadają
brak różnic w debianizacji.

-sa or -SA
Określa, że ​​oryginalne archiwum źródłowe będzie wyszukiwane w postaci pliku tar lub katalogu -
drugim argumentem, jeśli istnieje, może być albo albo pusty ciąg znaków (jest to równoważne
do używania -SN). Jeśli zostanie znaleziony plik tar, rozpakuje go, aby utworzyć plik różnicowy i
usuń go później (jest to równoznaczne z -sp); jeśli katalog zostanie znaleziony, tak się stanie
spakuj go, aby utworzyć oryginalne źródło, a następnie usuń je (jest to równoważne
do -sr); jeśli nie zostanie znalezione żadne z nich, zostanie przyjęte założenie, że pakiet nie ma debianizacji
diffs, tylko proste archiwum źródłowe (jest to odpowiednik -SN). Jeśli oba
znajdują się wtedy dpkg-źródło zignoruje katalog, nadpisując go, jeśli -SA była
określony (jest to równoważne z -sP) lub zgłoś błąd if -sa został określony. -SA
jest wartością domyślną.

--abort-on-upstream-changes
Proces kończy się niepowodzeniem, jeśli wygenerowana różnica zawiera zmiany w plikach spoza
podkatalog debian (od dpkg 1.15.8). Ta opcja jest niedozwolona
debian/źródło/opcje ale może być używany w debian/source/opcje-lokalne.

Wyciąg Opcje (z --wyciąg):

We wszystkich przypadkach wszelkie istniejące oryginalne drzewo źródłowe zostanie usunięte.

-sp Używane podczas rozpakowywania, oryginalne źródło (jeśli istnieje) zostanie pozostawione jako plik tar.
Jeśli nie znajduje się on jeszcze w bieżącym katalogu lub jeśli istnieje istniejący ale
znajduje się tam inny plik, zostanie on tam skopiowany. (To zdjęcie is dotychczasowy domyślnym).

-jego Rozpakowuje oryginalne drzewo źródłowe.

-SN Zapewnia, że ​​oryginalne źródło nie zostanie skopiowane do bieżącego katalogu ani
rozpakowany. Każde oryginalne drzewo źródłowe, które znajdowało się w bieżącym katalogu, pozostaje nadal
oddalony.

Wszystko -sX opcje wykluczają się wzajemnie. Jeśli podasz więcej niż jeden, tylko ostatni
będzie użyty.

--pomiń debianizację
Pomija zastosowanie mechanizmu różnicowego Debiana na źródłach nadrzędnych (ponieważ dpkg
1.15.1).

Format: 2.0
Ekstrakcja obsługiwana od dpkg 1.13.9, budowanie obsługiwane od dpkg 1.14.8. Znany także
jako peruka i długopis. Ten format nie jest zalecany do powszechnego użytku, format „3.0 (kołdra)”
zastępuje go. Wig&pen był pierwszą specyfikacją pakietu źródłowego nowej generacji
Format.

Zachowanie tego formatu jest takie samo jak w przypadku formatu „3.0 (pikowana)”, z tą różnicą, że
nie używa jawnej listy poprawek. Wszystkie pliki w debian/łatki/ pasujące do perla
wyrażenie regularne [\w-]+ muszą to być ważne poprawki: są one stosowane w czasie ekstrakcji.

Podczas budowania nowego pakietu źródłowego wszelkie zmiany w źródle źródłowym są przechowywane w łatce
o imieniu zz_debian-diff-auto.

Format: 3.0 (rodzinny)
Obsługiwane od wersji dpkg 1.14.17. Ten format jest rozszerzeniem natywnego formatu pakietu, takiego jak
zdefiniowany w formacie 1.0. Obsługuje wszystkie metody kompresji i domyślnie je ignoruje
dowolne pliki i katalogi specyficzne dla VCS, a także wiele plików tymczasowych (patrz wartość domyślna
związany z -I opcja w --help wyjście).

Format: 3.0 (kołdra)
Obsługiwane od wersji dpkg 1.14.17. Pakiet źródłowy w tym formacie zawiera co najmniej plik
oryginalny plik tar (.orig.tar.ext gdzie ext może być gz, bz2, Izma i xz) i debian
archiwum tar (.debian.tar.ext). Może także zawierać dodatkowe oryginalne pliki tar
(.oryg-składnik.smoła.ext). składnik może zawierać tylko znaki alfanumeryczne i łączniki
(„-”).

Ekstrahujący

Najpierw wyodrębniany jest główny oryginalny plik tar, a następnie wszystkie dodatkowe oryginalne pliki tar
wyodrębnione w podkatalogach nazwanych na cześć składnik część nazwy pliku (dowolna
istniejący katalog zostanie zastąpiony). Plik tar Debiana jest rozpakowywany na górze źródła
katalogu po uprzednim usunięciu wszelkich istniejących wcześniej debian informator. Należy pamiętać, że plik debian
tar musi zawierać plik tar debian podkatalogu, ale może on również zawierać pliki binarne na zewnątrz
tego katalogu (patrz --include-binaries opcja).

Wszystkie poprawki wymienione w debian/patches/debian.series or debian/łatki/seria są wtedy
stosowany. Jeśli używany jest pierwszy plik, a drugi nie istnieje (lub jest dowiązaniem symbolicznym),
następnie ten ostatni jest zastępowany dowiązaniem symbolicznym do pierwszego. Ma to na celu uproszczenie użytkowania
of kołdra do zarządzania zestawem poprawek. Należy jednak pamiętać, że podczas dpkg-źródło analizować
poprawnie szereguje pliki z jawnymi opcjami używanymi do stosowania łatek (przechowywane w każdym pliku
wiersz po nazwie pliku łatki i jedną lub więcej spacji), ignoruje te opcje i
zawsze oczekuj poprawek, które można zastosować za pomocą -s1 opcja łata. W ten sposób wyemituje
ostrzeżenie, gdy napotka takie opcje, a kompilacja prawdopodobnie się nie powiedzie.

Znacznik czasu wszystkich poprawionych plików jest resetowany do czasu wyodrębnienia pakietu źródłowego
(pozwala to uniknąć zniekształceń znaczników czasu prowadzących do problemów podczas łatania automatycznie generowanych plików).

Przeciwnie do kołdradomyślne zachowanie, oczekuje się, że poprawki zostaną zastosowane bez żadnych problemów.
Jeżeli tak nie jest, warto odświeżyć takie łatki kołdralub dpkg-źródło będzie
wystąpił błąd podczas próby ich zastosowania.

Podobny do kołdrajest domyślnym zachowaniem, łatki mogą również usuwać pliki.

Plik .pc/applied-patches jest tworzony, jeśli w trakcie instalacji zostały zastosowane jakieś poprawki
ekstrakcja.

Budowanie

Wszystkie oryginalne pliki tar znalezione w bieżącym katalogu są rozpakowywane tymczasowo
katalogu, postępując zgodnie z tą samą logiką, co przy rozpakowywaniu, kopiowany jest katalog Debiana
w katalogu tymczasowym i wszystkie łatki z wyjątkiem łatki automatycznej
(zmiany-debian-wersja or zmiany debiana, zależy od --pojedyncza-łatka-debianowa) są
stosowany. Katalog tymczasowy jest porównywany z katalogiem pakietu źródłowego. Kiedy
diff nie jest pusty, kompilacja zakończy się niepowodzeniem, chyba że --pojedyncza-łatka-debianowa or --automatyczne zatwierdzanie został
używany, w takim przypadku różnica jest przechowywana w automatycznej łatce. Jeśli automatyczna poprawka jest
utworzony/usunięty, jest dodawany/usuwany z pliku serii i z pliku kołdra metadane.

Jakakolwiek zmiana w pliku binarnym nie jest reprezentowana w pliku różnicowym i dlatego doprowadzi do awarii
chyba że opiekun celowo zdecydował się dołączyć zmodyfikowany plik binarny do pliku
debian tarball (poprzez umieszczenie go w debian/source/include-binaries). Budowa również zakończy się niepowodzeniem
jeśli znajdzie pliki binarne w podkatalogu Debiana, chyba że zostały umieszczone na białej liście
przez debian/source/include-binaries.

Następnie do wygenerowania używany jest zaktualizowany katalog Debiana i lista zmodyfikowanych plików binarnych
archiwum tar Debiana.

Automatycznie wygenerowana różnica nie obejmuje również zmian w konkretnych plikach VCS
wiele plików tymczasowych (patrz wartość domyślna powiązana z -i opcja w --help wyjście). W
w szczególności, szt katalog używany przez kołdra jest ignorowany podczas generowania automatu
łata.

Uwaga: dpkg-źródło --przed zbudowaniem (I --budować) zapewni, że wszystkie poprawki wymienione w pliku
series są stosowane, dzięki czemu kompilacja pakietu zawsze zawiera wszystkie poprawki. To robi
można to zrobić, znajdując niezastosowane poprawki (są one wymienione w pliku seria plik, ale nie w
.pc/applied-patches) i jeśli pierwszą łatkę z tego zestawu można zastosować bez błędów, to
zastosuje je wszystkie. Opcja --bez-przygotowania można użyć do wyłączenia tego zachowania.

Nagranie zmiany

--popełniać [katalog] [nazwa-łatki] [plik-łatki]
Generuje poprawkę odpowiadającą lokalnym zmianom, którymi nie zarządza
kołdra patch system i integruje go w systemie patch pod nazwą nazwa-łatki.
Jeśli brakuje nazwy, zostanie ona zapytana interaktywnie. Jeśli plik-łatki jest dane, to
służy jako łatka odpowiadająca lokalnym zmianom do integracji. Raz
zintegrowany, uruchamiany jest edytor, dzięki któremu możesz edytować metainformacje w pliku
nagłówek poprawki.

Przechodzący plik-łatki jest przydatny głównie po niepowodzeniu kompilacji, które to wygenerowało
i na tej podstawie dany plik jest usuwany po integracji. Uwaga również
że zmiany zawarte w pliku poprawki muszą już zostać zastosowane w drzewie
oraz że pliki zmodyfikowane przez łatkę nie mogą mieć dodatkowych niezarejestrowanych plików
zmiany.

Jeśli podczas generowania łatki wykryte zostaną zmodyfikowane pliki binarne, zostaną one automatycznie usunięte
dodaje się debian/source/include-binaries tak, że wylądują w archiwum Debiana
(dokładnie jak dpkg-źródło --include-binaries --budować zrobiłby).

Budować Opcje

--allow-wersja-kołdry-db=wersja
Dopuszczać dpkg-źródło do zbudowania pakietu źródłowego, jeśli wersja kołdra metadanych
jest tym określonym, nawet jeśli dpkg-źródło nie wie o tym (ponieważ dpkg
1.15.5.4). W rzeczywistości oznacza to, że dana wersja pliku kołdra metadane są
kompatybilny z wersją 2 dpkg-źródło obecnie obsługuje. Wersja
dotychczasowy kołdra metadane są przechowywane w .pc/.wersja.

--włączenie-usunięcie
Nie ignoruj ​​usuniętych plików i dołącz je do automatycznie wygenerowanej łatki.

--include-znacznik czasu
Dołącz sygnaturę czasową do automatycznie wygenerowanej poprawki.

--include-binaries
Dodaj wszystkie zmodyfikowane pliki binarne do archiwum Debiana. Dodaj je także do
debian/source/include-binaries: zostaną dodane domyślnie w kolejnych kompilacjach
i dlatego ta opcja nie jest już potrzebna.

--bez-przygotowania
Nie próbuj przygotowywać drzewa kompilacji poprzez nakładanie łat, które najwyraźniej są
niestosowane (od dpkg 1.14.18).

--pojedyncza-łatka-debianowa
Zastosowanie debian/patches/debian-changes zamiast debian/patches/debian-changes-wersja
jako nazwę automatycznej łatki wygenerowanej podczas kompilacji (od wersji dpkg 1.15.5.4).
Ta opcja jest szczególnie przydatna, gdy pakiet jest utrzymywany w systemie VCS i a
Nie można wiarygodnie wygenerować zestawu poprawek. Zamiast tego bieżąca różnica z upstream
należy przechowywać w jednym plastrze. Opcja zostałaby wprowadzona
debian/source/opcje-lokalne i towarzyszyć mu będzie a
debian/source/local-patch-header plik wyjaśniający, w jaki sposób zmiany Debiana mogą być najlepsze
poddane przeglądowi, na przykład w używanym systemie VCS.

--utwórz-pusty-oryg
Automatycznie utwórz główny oryginalny plik tar jako pusty, jeśli go brakuje i jeśli
istnieją dodatkowe oryginalne tarballe (od dpkg 1.15.6). Ta opcja jest
przeznaczony do użycia, gdy pakiet źródłowy jest po prostu pakietem wielu plików źródłowych
oprogramowania i tam, gdzie nie ma „głównego” oprogramowania.

--no-unapply-patches, --odinstaluj-łaty
Domyślnie dpkg-źródło automatycznie cofnie zastosowanie poprawek w pliku --po kompilacji
hook, jeśli faktycznie je zastosował --przed zbudowaniem (--odinstaluj-łaty od dpkg
1.15.8, --no-unapply-patches od dpkg 1.16.5). Te opcje na to pozwalają
wymuś wyłączenie lub włączenie procesu usuwania łatek. Te opcje są
dozwolone tylko debian/source/opcje-lokalne tak, aby wszystkie wygenerowane pakiety źródłowe
domyślnie zachowują się tak samo.

--abort-on-upstream-changes
Proces kończy się niepowodzeniem, jeśli została wygenerowana automatyczna łatka (od wersji dpkg 1.15.8).
Opcji tej można użyć, aby mieć pewność, że wszystkie zmiany zostały prawidłowo zapisane w
oddzielny kołdra poprawki przed kompilacją pakietu źródłowego. Ta opcja nie jest
dozwolone w debian/źródło/opcje ale może być używany w debian/source/opcje-lokalne.

--automatyczne zatwierdzanie
Proces nie zakończy się niepowodzeniem, jeśli wygenerowano automatyczną łatkę, a wręcz przeciwnie
natychmiast zapisane w kołdra series.

Wyciąg Opcje

--pomiń debianizację
Pomija wyodrębnianie archiwum tar Debiana na wierzchu źródeł źródłowych (ponieważ dpkg
1.15.1).

--pomiń łaty
Nie nakładać łatek na koniec ekstrakcji (od dpkg 1.14.18).

Format: 3.0 (zwyczaj)
Obsługiwane od wersji dpkg 1.14.17. Ten format jest wyjątkowy. Nie reprezentuje prawdziwego źródła
format pakietu, ale można go używać do tworzenia pakietów źródłowych z dowolnymi plikami.

Budować Opcje

Wszystkie argumenty nieopcyjne są traktowane jako pliki do zintegrowania z wygenerowanym pakietem źródłowym.
Muszą istnieć i najlepiej znajdować się w bieżącym katalogu. Przynajmniej jeden plik musi być
dany.

--format docelowy=wartość
Wymagane. Określa rzeczywisty format wygenerowanego pakietu źródłowego. Wygenerowane
Plik .dsc będzie zawierał tę wartość w swoim pliku utworzony pole, a nie „3.0 (niestandardowe)”.

Format: 3.0 (git)
Obsługiwane od wersji dpkg 1.14.17. Ten format jest eksperymentalny.

Pakiet źródłowy w tym formacie składa się z pojedynczego pakietu repozytorium git .iść do
przechowuj źródło pakietu. Może być również gitshallow zmiany listy plików dla
płytki klon gita.

Ekstrahujący

Pakiet jest klonowany jako repozytorium git do katalogu docelowego. Jeśli tam jest
gitshallow, jest instalowany jako .git/płytkie w sklonowanym repozytorium git.

Zauważ, że domyślnie nowe repozytorium będzie miało wyewidencjonowaną tę samą gałąź, co poprzednio
sprawdzone w oryginalnym źródle. (Zazwyczaj „mistrz”, ale może to być cokolwiek.) Dowolny
pozostałe oddziały będą dostępne pod piloty/pochodzenie/.

Budowanie

Zanim przejdziemy dalej, przeprowadzamy pewne kontrole, aby upewnić się, że nie mamy żadnych nie-
ignorowane niezatwierdzone zmiany.

pakiet git(1) służy do generowania pakietu repozytorium git. Domyślnie wszystkie
gałęzie i znaczniki w repozytorium są zawarte w pakiecie.

Budować Opcje

--git-ref=ref
Umożliwia określenie git ref, który ma zostać uwzględniony w pakiecie git. Użyj wyłącza ustawienie domyślne
zachowanie włączania wszystkich gałęzi i tagów. Można określić wielokrotnie. The
ref może być nazwą gałęzi lub znacznika, który należy uwzględnić. Może to być także dowolny parametr
które można przekazać git-rev-lista(1). Na przykład, aby uwzględnić tylko plik główny
oddział, użyj --git-ref=gospodarz. Aby uwzględnić wszystkie znaczniki i gałęzie z wyjątkiem
oddział prywatny, użyj --git-ref=--wszystko --git-ref=^prywatny

--git-głębia=numer
Tworzy płytki klon z historią obciętą do określonej liczby
poprawki.

Format: 3.0 (bzr)
Obsługiwane od wersji dpkg 1.14.17. Ten format jest eksperymentalny. Generuje pojedynczy plik tar
zawierający repozytorium bzr.

Ekstrahujący

Paczka tar jest rozpakowywana, a następnie bzr jest używany do sprawdzania bieżącej gałęzi.

Budowanie

Zanim przejdziemy dalej, przeprowadzamy pewne kontrole, aby upewnić się, że nie mamy żadnych nie-
ignorowane niezatwierdzone zmiany.

Następnie część katalogu źródłowego specyficzna dla VCS jest kopiowana do katalogu tymczasowego
informator. Zanim ten katalog tymczasowy zostanie spakowany do archiwum tar, wykonywane są różne czynności porządkowe
zrobione, żeby zaoszczędzić miejsce.

DIAGNOSTYKA

Nie źródło format określony in debian/źródło/format
Plik debian/źródło/format powinien zawsze istnieć i wskazywać żądany format źródłowy.
Aby zapewnić kompatybilność wsteczną, zakładany jest format „1.0”, gdy plik nie istnieje oprócz Ciebie
nie powinniśmy na tym polegać: w pewnym momencie w przyszłości dpkg-źródło zostanie zmodyfikowany tak, aby zakończył się niepowodzeniem
gdy ten plik nie istnieje.

Powodem jest to, że format „1.0” nie jest już zalecanym formatem, a raczej powinien być zalecany
wybierz jeden z nowszych formatów („3.0 (quilt)”, „3.0 (natywny)”), ale dpkg-źródło nie zrobie
to automatycznie dla Ciebie. Jeśli chcesz nadal używać starego formatu, powinieneś to zrobić
wyraźnie to zaznacz i wstaw „1.0”. debian/źródło/format.

dotychczasowy diff modyfikuje dotychczasowy następujący pod prąd pliki
W przypadku korzystania z formatu źródłowego „1.0” bezpośrednie modyfikowanie plików źródłowych jest zazwyczaj złym pomysłem
ponieważ zmiany zostają ukryte i w większości nieudokumentowane w pliku .diff.gz. Zamiast ciebie
powinien zapisać zmiany jako łatki w katalogu Debiana i zastosować je w czasie kompilacji.
Aby uniknąć tej złożoności, możesz również użyć formatu „3.0 (kołdra)”, który to oferuje
natywnie

nie może reprezentować zmiana do filet
Zmiany w źródłach nadrzędnych są zwykle przechowywane z plikami poprawek, ale nie wszystkie zmiany mogą to zrobić
być reprezentowane za pomocą łatek: mogą zmieniać jedynie zawartość plików tekstowych. Jeśli ty
spróbuj zastąpić plik czymś innego typu (na przykład zastępując zwykły plik
plik z dowiązaniem symbolicznym lub katalogiem), pojawi się ten komunikat o błędzie.

nowo stworzony pusty filet filet będzie nie be reprezentowane in diff
Za pomocą plików poprawek nie można utworzyć pustych plików. Zatem zmiana ta nie jest rejestrowana w
source i zostaniesz o tym ostrzeżony.

plik wykonywalny tryb perms of filet będzie nie be reprezentowane in diff
Pliki poprawek nie rejestrują uprawnień do plików, a zatem uprawnienia do plików wykonywalnych nie
przechowywane w pakiecie źródłowym. To ostrzeżenie przypomina o tym fakcie.

specjalny tryb perms of filet będzie nie be reprezentowane in diff
Pliki poprawek nie rejestrują uprawnień do plików, a zatem zmodyfikowane uprawnienia nie
przechowywane w pakiecie źródłowym. To ostrzeżenie przypomina o tym fakcie.

FILE FORMATY

debian/źródło/format
Plik ten zawiera w jednej linii format, który powinien zostać użyty do zbudowania źródła
pakiet (możliwe formaty opisano powyżej). Niedozwolone są spacje początkowe ani końcowe.

debian/source/include-binaries
Ten plik zawiera listę plików binarnych (po jednym w wierszu), które powinny zostać uwzględnione w pliku
archiwum tar Debiana. Spacje początkowe i końcowe są usuwane. Linie zaczynające się od '#' są
komentarze i są pomijane. Puste linie są ignorowane.

debian/źródło/opcje
Ten plik zawiera listę długich opcji, które powinny być automatycznie dołączane do pliku
zestaw opcji wiersza poleceń a dpkg-źródło --budować or dpkg-źródło --format wydruku połączenie.
Opcje takie jak --kompresja i --poziom kompresji dobrze pasują do tego pliku.

Każdą opcję należy umieścić w osobnej linii. Puste linie i linie zaczynające się od „#' są
ignorowane. Prowadzenie '--' należy usunąć, a krótkie opcje nie są dozwolone. Opcjonalny
dozwolone są spacje wokół '=Wokół wartości dozwolone są symbole ' i opcjonalne cudzysłowy.
Oto przykład takiego pliku:

# pozwól dpkg-source utworzyć plik debian.tar.bz2 z maksymalną kompresją
kompresja = „bzip2”
poziom kompresji = 9
# użyj debian/patches/debian-changes jako automatycznej łatki
pojedyncza łatka-debianowa
# ignoruj ​​zmiany w konfiguracji.{sub, Guess}
Extend-diff-ignore = "(^|/)(config.sub|config.guess)$"

Uwaga: format opcje nie są akceptowane w tym pliku, powinieneś użyć debian/źródło/format
zamiast.

debian/source/opcje-lokalne
Dokładnie jak debian/źródło/opcje z tą różnicą, że plik nie jest uwzględniany w wygenerowanym pliku
pakiet źródłowy. Przydatne może być przechowywanie preferencji powiązanych z opiekunem lub plikiem
Repozytorium VCS, w którym przechowywany jest pakiet źródłowy.

debian/source/local-patch-header i debian/source/patch-header
Dowolny tekst umieszczany na górze automatycznej łatki wygenerowanej w formatach „2.0” lub
„3.0 (kołdra)”. nagłówek-lokalnej-łatki nie jest uwzględniony w wygenerowanym pakiecie źródłowym while
nagłówek poprawki jest.

debian/łatki/seria
Plik ten zawiera listę wszystkich poprawek, które należy zastosować (w podanej kolejności).
nadrzędny pakiet źródłowy. Spacje początkowe i końcowe są usuwane. Linie zaczynające się od
"#' są komentarzami i są pomijane. Puste linie są ignorowane. Pozostałe linie zaczynają się od a
nazwa pliku poprawki (względem debian/łatki/ katalog) aż do pierwszego znaku spacji
lub koniec linii. Opcjonalny kołdra opcje mogą trwać aż do końca linii lub pierwszej
"#' poprzedzony jedną lub kilkoma spacjami (oznaczającymi początek komentarza aż do końca
linia).

Użyj dpkg-source online, korzystając z usług onworks.net