dpkg-source - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

dpkg-source - інструмент маніпулювання вихідним пакетом Debian (.dsc).

СИНТАКСИС

dpkg-джерело [варіант...] команда

ОПИС

dpkg-джерело пакує та розпаковує вихідні архіви Debian.

Жодна з цих команд не дозволяє об’єднати декілька параметрів в один, і вони цього не роблять
дозволити вказувати значення параметра в окремому аргументі.

КОМАНДИ

-x, --екстракт ім'я файлу.dsc [вихідний каталог]
Розпакуйте вихідний пакет (--екстракт починаючи з dpkg 1.17.14). Один аргумент без варіантів
має бути вказано ім’я файлу контролю вихідних кодів Debian (.dsc). За бажанням
Другий аргумент без параметрів може бути наданий, щоб вказати каталог для вилучення
вихідний пакет до, цього не повинно існувати. Якщо вихідний каталог не вказано, файл
вихідний пакет розпаковується в каталог з ім'ям джерело-версія під течією
робочий каталог.

dpkg-джерело прочитає імена інших файлів, що входять до вихідного пакету
з контрольного файлу; Передбачається, що вони знаходяться в тому самому каталозі, що й файл .dsc.

Для файлів у витягнутому пакеті будуть встановлені дозволи та права власності
до тих, які можна було б очікувати, якби файли та каталоги були просто
було створено - каталоги та виконувані файли будуть 0777, а звичайні файли будуть
бути 0666, обидва модифіковані umask екстракторів; якщо для батьківського каталогу встановлено gid
тоді витягнуті каталоги також будуть, а також усі файли та каталоги
успадковують групову власність.

Якщо вихідний пакет використовує нестандартний формат (зараз це означає всі формати
крім «1.0»), його назва буде збережена в debian/джерело/формат так що
наступні збірки вихідного пакету використовують той самий формат за замовчуванням.

-b, --будувати каталог [параметри, специфічні для формату]
Створіть вихідний пакет (--будувати починаючи з dpkg 1.17.14). Перший аргумент без варіантів
приймається як ім’я каталогу, що містить дебіанізоване джерело (тобто
з підкаталогом debian і, можливо, змінює оригінальні файли). В залежності від
формат вихідного пакета, який використовується для створення пакета, можуть бути додаткові параметри
прийнято.

dpkg-джерело створить вихідний пакет із першим знайденим у цьому форматі
упорядкований список: формат, зазначений символом --формат параметр командного рядка,
формат, зазначений у debian/джерело/формат, «1.0». Повернення до «1.0».
застаріла і буде видалена в якийсь момент у майбутньому, ви повинні завжди
задокументуйте потрібний вихідний формат debian/джерело/формат. Див. розділ ДЖЕРЕЛО
ПАКЕТ ФОРМАТИ для розгорнутого опису різних форматів вихідних пакетів.

--формат друку каталог
Надрукуйте вихідний формат, який буде використаний для створення вихідного пакета if
dpkg-джерело --будувати каталог називався (в тих самих умовах і з тим самим
параметри; починаючи з dpkg 1.15.5).

--перед побудовою каталог
Запустіть відповідний хук формату вихідного пакета (починаючи з dpkg 1.15.8). Це
гачок викликається перед будь-якою збіркою пакета (dpkg-buildpackage називає це дуже
рано навіть раніше debian/правила очистити). Ця команда є ідемпотентною і може бути викликана
кілька разів. Не всі вихідні формати реалізують щось у цьому хуку, а ті
які зазвичай готують вихідне дерево для збірки, наприклад, забезпечуючи це
застосовані виправлення Debian.

--після побудови каталог
Запустіть відповідний хук формату вихідного пакета (починаючи з dpkg 1.15.8). Це
хук викликається після будь-якої збірки пакета (dpkg-buildpackage називає це останнім).
Ця команда є ідемпотентною і може бути викликана кілька разів. Не всі вихідні формати
реалізуйте щось у цьому хуку, а ті, хто зазвичай використовує це, щоб скасувати те, що
--перед побудовою зроблено.

--здійснити [каталог] ...
Записувати зміни у вихідному дереві, в якому розпаковано каталог (починаючи з dpkg 1.16.1). Це
Команда може приймати додаткові параметри залежно від вихідного формату. Це буде
помилка для форматів, де ця операція нічого не означає.

-?, --допомога
Покажіть повідомлення про використання та вийдіть.

-- версія
Покажіть версію та вийдіть.

ВАРІАНТИ

Загальний будувати опції
-cконтрольний файл
Вказує основний файл контролю джерела, з якого потрібно читати інформацію. За замовчуванням є
debian / control. Якщо вказано з відносним ім'ям шляху, це інтерпретується, починаючи з
каталог верхнього рівня вихідного дерева.

-lфайл журналу змін
Визначає файл журналу змін для читання інформації. За замовчуванням є
debian/changelog. Якщо вказано з відносним ім'ям шляху, це інтерпретується, починаючи з
каталог верхнього рівня вихідного дерева.

-Fформат журналу змін
Визначає формат журналу змін. Побачити dpkg-parsechangelog(1) для інформації
про альтернативні формати.

--формат=значення
Використовуйте наданий формат для створення вихідного пакета (починаючи з dpkg 1.14.17). Це робить
замінити будь-який наданий формат debian/джерело/формат.

-Vім'я=значення
Встановіть вихідну змінну підстановки. Побачити deb-substvars(5) для обговорення
вихідна заміна.

-Tsubstvars-файл
Прочитати змінні підстановки в substvars-файл; за замовчуванням не читати жодного файлу.
Цю опцію можна використовувати кілька разів для читання змінних підстановки з кількох
файли (починаючи з dpkg 1.15.6).

-Dполе=значення
Замінити або додати поле контрольного файлу виводу.

-Uполе
Видаліть поле контрольного файлу виводу.

-Zстиснення, -- стиснення=стиснення
Вкажіть стиснення, яке використовуватиметься для створених tar-архів і файлів diff (-- стиснення
починаючи з dpkg 1.15.5). Зауважте, що ця опція не призведе до створення існуючих архівів
повторно стиснутий, він впливає лише на нові файли. Підтримувані значення: gzip, bzip2, лзма
та xz. За замовчуванням xz для форматів 2.0 і новіших, і gzip для формату 1.0. xz
підтримується лише з dpkg 1.15.5.

-zрівень, -- рівень стиснення=рівень
Використовуваний рівень стиснення (-- рівень стиснення починаючи з dpkg 1.15.5). Як і в разі -Z it
впливає лише на щойно створені файли. Підтримувані значення: 1 до 9, кращий та швидко.
За замовчуванням - 9 для gzip і bzip2, 6 для xz і lzma.

-i[regex], --diff-ігнорувати[=regex]
Ви можете вказати регулярний вираз perl, щоб відповідати файлам, з яких потрібно відфільтрувати
список файлів для diff (--diff-ігнорувати починаючи з dpkg 1.15.6). (Цей список є
генерується командою find.) (Якщо вихідний пакет створюється як версія 3
вихідний пакет із використанням VCS, це можна використовувати для ігнорування незафіксованих змін
конкретні файли. Використання -i.* ігнорує їх усі.)

Команда -i параметр сам по собі вмикає цей параметр із регулярним виразом за замовчуванням (зберігаючи будь-який
зміна регулярного виразу за замовчуванням, зроблена попереднім використанням --extend-diff-ignore)
який відфільтрує контрольні файли та каталоги найпоширенішої версії
системи керування, файли резервного копіювання та підкачки та вихідні каталоги збірки Libtool. Там
може бути лише один активний регулярний вираз із кількох -i варіанти, тільки останній
ефект

Це дуже корисно для вирізання сторонніх файлів, які включені в diff,
наприклад, якщо ви підтримуєте своє джерело в системі контролю переглядів і хочете використовувати a
checkout, щоб створити вихідний пакет без включення додаткових файлів і
каталоги, які він зазвичай містить (наприклад, CVS/, .cvsignore, .svn/). The
Регулярний вираз за замовчуванням вже дуже вичерпний, але якщо вам потрібно його замінити, будь ласка
зауважте, що за замовчуванням він може відповідати будь-якій частині шляху, тому, якщо ви хочете відповідати
початок імені файлу або лише повні назви файлів, вам потрібно буде вказати необхідні
якоря (наприклад, '(^|/)', '($|/)') себе.

--extend-diff-ignore=regex
Вказаний регулярний вираз perl розширить значення за замовчуванням, яке використовується
--diff-ігнорувати і його поточне значення, якщо встановлено (починаючи з dpkg 1.15.6). Це робиться за допомогою
конкатенація "|regex” до існуючого значення. Цей варіант зручно використовувати в
debian/джерело/параметри щоб виключити деякі автоматично створені файли з автоматичного виправлення
покоління

-I[файл-шаблон], --tar-ігнорувати[=файл-шаблон]
Якщо вказано цю опцію, шаблон буде передано до дьоготь(1). --виключити
параметр, коли він викликається для створення файлу .orig.tar або .tar (--tar-ігнорувати з
dpkg 1.15.6). Наприклад, -ICVS змусить tar пропускати каталоги CVS, коли
створення файлу .tar.gz. Опція може бути повторена кілька разів для переліку
кілька шаблонів для виключення.

-I сам по собі додає за замовчуванням --виключити параметри, які відфільтрують файли керування та
каталоги найпоширеніших систем контролю ревізій, файли резервного копіювання та підкачки та
Libtool збирає вихідні каталоги.

Примітка: Хоча вони мають схожі цілі, -i та -I мають дуже різний синтаксис і
семантика. -i можна вказати лише один раз і приймає регулярний вираз, сумісний з perl
який відповідає повному відносному шляху кожного файлу. -I можна вказати декілька
разів і приймає шаблон імені файлу з підстановочними знаками оболонки. Візерунок наноситься на
повний відносний шлях, а також до кожної частини шляху окремо. Точна семантика
дьогтю --виключити варіант дещо складний, див
https://www.gnu.org/software/tar/manual/tar.html#wildcards for a full documentation.

Регулярний вираз за замовчуванням і шаблони для обох параметрів можна побачити у виводі --допомога
команда

Загальний витяг опції
--не копіювати
Не копіюйте оригінальні файли tar-архів поруч із витягнутим вихідним пакетом (оскільки dpkg
1.14.17).

--не перевіряти
Не перевіряйте підписи та контрольні суми перед розпакуванням (починаючи з dpkg 1.14.17).

--require-valid-signature
Відмовтеся розпаковувати вихідний пакунок, якщо він не містить підпису OpenPGP
можна перевірити (починаючи з dpkg 1.15.0) або за допомогою користувача trustedkeys.gpg кільце для ключів,
один із постачальників ключів або один з офіційних брелоків Debian
(/usr/share/keyrings/debian-keyring.gpg та
/usr/share/keyrings/debian-maintainers.gpg).

--ігнорувати-погану-версію
Перетворює погану перевірку версії вихідного пакета в нефатальне попередження (оскільки dpkg
1.17.7). Ця опція потрібна лише при видобутку стародавнього джерела
пакунки зі зламаними версіями, лише для зворотної сумісності.

ДЖЕРЕЛО ПАКЕТ ФОРМАТИ

Якщо ви не знаєте, який вихідний формат використовувати, вам, ймовірно, слід вибрати «3.0 (ковдра)»
або «3.0 (рідний)». Перегляньте https://wiki.debian.org/Projects/DebSrc3.0 для отримання інформації про
розгортання цих форматів у Debian.

Формат: 1.0
Вихідний пакет у цьому форматі складається з одного з a .orig.tar.gz пов'язаний з a .diff.gz
або одиночний .tar.gz (у цьому випадку пакет називається рідний).

Вилучення

Розпакування рідного пакета - це просте вилучення одного tar-архіву в цільову
каталог. Розпакування ненативного пакета виконується спочатку шляхом розпакування файлу .orig.tar.gz та
потім накладення пластиру, що міститься в .diff.gz файл. Позначка часу всіх виправлених файлів
скидається до часу вилучення вихідного пакета (це дозволяє уникнути перекосів часових позначок
до проблем, коли автоматично створені файли виправляються). Diff може створювати нові файли (
таким чином створюється весь каталог debian), але не можна видалити файли (буде порожні файли
залишилося).

Створюємо

Створення рідного пакета — це просто створення єдиного tar-архіву з вихідним каталогом.
Створення ненативного пакета передбачає вилучення оригінального tar-архіву в окремий
Каталог “.orig” і відновлення файлу .diff.gz шляхом порівняння вихідного пакета каталог
з каталогом .orig.

Будувати опції (з --build):

Якщо вказано другий аргумент без параметрів, це має бути ім’я вихідного джерела
каталог або tar-файл або порожній рядок, якщо пакунок є специфічним для Debian і так
не має відмінностей дебіанізації. Якщо другий аргумент не вказано, тоді dpkg-джерело буде виглядати
для вихідного tar-файлу package_upstream-version.orig.tar.gz або оригінал
вихідний каталог каталог.orig залежно від -sx аргументів.

-са, -сп, -ск, -су та -старший не буде перезаписувати існуючі tar-файли або каталоги. Якщо це так
бажаний тоді -SA, -sP, -sK, -СУ та -sR слід використовувати замість цього.

-ск Вказує очікувати вихідне джерело як tar-файл за замовчуванням package_upstream-
версія.orig.tar.розширення. Це залишить це першоджерело на місці як a
tar-файл або скопіюйте його в поточний каталог, якщо його там ще немає. Архівний файл
буде розпаковано в каталог.orig для генерації диф.

-сп Люблю -ск але потім знову видалить каталог.

-су Вказує, що вихідне джерело очікується як каталог за замовчуванням пакет-
upstream-версія.orig та dpkg-джерело створить новий оригінальний архів
з цього.

-старший Люблю -су але видалить цей каталог після його використання.

-ss Вказує, що вихідне джерело доступне і як каталог, і як файл
tarfile. dpkg-джерело використовуватиме каталог для створення diff, але файл tar
створити .dsc. Цю опцію потрібно використовувати обережно - якщо каталог і tar-файл
не збігаються з поганим вихідним архівом буде створено.

-сн Вказує не шукати оригінальне джерело та не створювати відмінності. The
Другий аргумент, якщо вказано, має бути порожнім рядком. Це використовується для Debian-
конкретні пакети, які не мають окремого вихідного джерела, а тому мають
немає відмінностей дебіанізації.

-са or -SA
Вказує шукати оригінальний вихідний архів як tar-файл або як каталог -
другий аргумент, якщо такий є, може бути або порожнім рядком (це еквівалентно
до використання -сн). Якщо буде знайдено tar-файл, він розпакує його, щоб створити diff і
потім видаліть його (це еквівалентно -сп); якщо каталог знайдено, він буде
упакуйте його, щоб створити вихідне джерело, а потім видаліть його (це еквівалентно
до -старший); якщо жодне не знайдено, буде вважатися, що пакет не має дебіанізації
diffs, лише простий вихідний архів (це еквівалентно -сн). Якщо обидва
знаходять тоді dpkg-джерело ігнорує каталог, перезаписуючи його, якщо -SA було
зазначено (це еквівалентно -sP) або викликати помилку, якщо -са було зазначено. -SA
є типовим.

--abort-on-upstream-changes
Процес завершується, якщо згенерований diff містить зміни до файлів за межами
підкаталог debian (починаючи з dpkg 1.15.8). Ця опція заборонена
debian/джерело/параметри але можна використовувати в debian/source/local-options.

Витяг опції (з --екстракт):

У всіх випадках будь-яке існуюче вихідне дерево буде видалено.

-сп Використовується під час вилучення, тоді вихідне джерело (якщо є) буде залишено як tar-файл.
Якщо він ще не розташований у поточному каталозі або якщо наявний але
там інший файл, він буде туди скопійований. (це is дефолт).

-су Розпаковує вихідне дерево джерела.

-сн Гарантує, що вихідне джерело не копіюється в поточний каталог, ні
розпакований. Будь-яке оригінальне дерево джерел, яке було в поточному каталозі, залишається
вилучено

Всі -sX варіанти є взаємовиключними. Якщо ви вкажете більше одного, тільки останній
буде використовуватися.

--skip-debianization
Пропускає застосування debian diff поверх вихідних джерел (оскільки dpkg
1.15.1).

Формат: 2.0
Вилучення підтримується з dpkg 1.13.9, збірка підтримується з dpkg 1.14.8. Також відомий
як перука і ручка. Цей формат не рекомендується для широкого використання, формат «3.0 (ковдра)»
замінює його. Wig&pen був першою специфікацією пакета джерел нового покоління
Формат.

Поведінка цього формату така ж, як і формат «3.0 (ковдра)», за винятком того, що він
не використовує явний список виправлень. Усі файли в debian/патчі/ відповідність perl
регулярне вираження [\w-]+ повинні бути дійсні патчі: вони накладаються під час вилучення.

Під час створення нового вихідного пакета будь-які зміни у вихідному джерелі зберігаються у виправленні
названий zz_debian-diff-auto.

Формат: 3.0 (рідна)
Підтримується з dpkg 1.14.17. Цей формат є розширенням рідного формату пакета as
визначено у форматі 1.0. Він підтримує всі методи стиснення і ігнорує за замовчуванням
будь-які файли та каталоги VCS, а також багато тимчасових файлів (див. значення за замовчуванням
пов'язаний з -I опція в --допомога вихід).

Формат: 3.0 (ковдру)
Підтримується з dpkg 1.14.17. Вихідний пакет у цьому форматі містить принаймні файл
оригінальний tar-архів (.orig.tar.ext де ext може бути gz, bz2, лзма та xz) і debian
архівований файл (.debian.tar.ext). Він також може містити додаткові оригінальні tar-файли
(.orig-компонент.tar.ext). компонент може містити лише буквено-цифрові символи та дефіси
('-').

Вилучення

Спочатку витягується основний оригінальний tar-архів, а потім усі додаткові оригінальні файли архіву
витягується в підкаталоги, названі на честь компонент частина їх назви файлу (будь-який попередній
існуючий каталог замінено). Архівний файл debian витягується поверх вихідного коду
каталогу після попереднього видалення будь-якого вже існуючого Debian каталог. Зауважте, що debian
tar-архів повинен містити a Debian підкаталог, але він також може містити двійкові файли за межами
цього каталогу (див --include-бінарні файли варіант).

Усі патчі, перераховані в debian/patches/debian.series or debian/patches/series є тоді
застосовано. Якщо використовується перший файл, а другий не існує (або є символічним посиланням),
потім останній замінюється символічним посиланням на перший. Це призначено для спрощення використання
of ковдру керувати набором патчів. Однак зауважте, що поки dpkg-джерело розбирає
правильно серії файлів із явними параметрами, що використовуються для застосування виправлення (зберігаються на кожному
рядок після імені файлу виправлення та одного або кількох пробілів), він ігнорує ці параметри та
завжди очікуйте патчі, які можна застосувати за допомогою -стор.1 можливість ділянку. Таким чином, воно буде випромінювати
попередження, коли він зустрічається з такими параметрами, і збірка, ймовірно, зазнає невдачі.

Мітка часу всіх виправлених файлів скидається до часу вилучення вихідного пакета
(це дозволяє уникнути перекосів позначок часу, які призводять до проблем під час виправлень автоматично створених файлів).

Всупереч ковдруПоведінка за замовчуванням, очікується, що виправлення будуть застосовуватися без будь-яких нечіткостей.
Якщо це не так, ви повинні оновити такі патчі за допомогою ковдруабо dpkg-джерело волі
помилка під час спроби застосувати їх.

Аналогічно до ковдруПоведінка за замовчуванням, патчі також можуть видаляти файли.

Файл .pc/applied-patches створюється, якщо деякі виправлення були застосовані під час
видобуток.

Створюємо

Усі оригінальні файли tar-архів, знайдені в поточному каталозі, витягуються у тимчасовий файл
каталог, дотримуючись тієї ж логіки, що й для розпакування, каталог debian копіюється
у тимчасовий каталог і всі виправлення, крім автоматичного виправлення
(debian-changes-версія or debian-зміни, в залежності від --single-debian-patch) є
застосовано. Тимчасовий каталог порівнюється з каталогом вихідних пакетів. Коли
diff не порожній, збірка не вдається, якщо --single-debian-patch or --автоматична фіксація було
використовується, і в цьому випадку diff зберігається в автоматичному виправленні. Якщо автоматичний патч є
створено/видалено, додається/вилучається з файлу серії та з файлу ковдру метадані.

Будь-яка зміна в двійковому файлі не відображається в diff і, таким чином, призведе до збою
якщо супроводжувач навмисно не вирішив включити цей змінений двійковий файл до
debian tarball (перерахувавши його в debian/source/include-binaries). Конструкція також вийде з ладу
якщо він знаходить двійкові файли в підкаталозі debian, якщо вони не внесені в білий список
через debian/source/include-binaries.

Оновлений каталог debian і список змінених двійкових файлів використовуються для створення
tar-архів debian.

Автоматично згенерований diff також не включає зміни в файлах VCS
багато тимчасових файлів (див. значення за замовчуванням, пов’язане з -i опція в --допомога вихід). в
зокрема, .pc каталог, яким користується ковдру ігнорується під час створення автоматичного
пластир.

Примітка: dpkg-джерело --перед побудовою (І --будувати) гарантує, що всі патчі, перелічені в
файл series застосовуються так, щоб у збірці пакета завжди були застосовані всі виправлення. Це робить
це шляхом пошуку незастосованих патчів (вони перераховані в серія файл, але не в
.pc/applied-patches), і якщо перший патч у цьому наборі можна застосувати без помилок, це
застосовуватиме їх усі. Варіант --без підготовки можна використовувати, щоб вимкнути цю поведінку.

запис зміни

--здійснити [каталог] [ім'я патча] [патч-файл]
Генерує патч, що відповідає локальним змінам, які не керуються
ковдру патч-системи та інтегрує її в систему патчів під назвою ім'я патча.
Якщо ім’я відсутнє, його запитають в інтерактивному режимі. Якщо патч-файл дано, це
використовується як патч, що відповідає локальним змінам для інтеграції. один раз
інтегровано, запускається редактор, щоб ви могли редагувати мета-інформацію в
заголовок патча.

Проходження патч-файл в основному корисний після збою збірки, який попередньо сформував це
файл, і на цій підставі даний файл видаляється після інтеграції. Також зауважте
що зміни, що містяться у файлі виправлення, вже мають бути застосовані до дерева
і що файли, змінені патчем, не повинні мати додаткових незаписаних
зміни.

Якщо генерація виправлення виявить змінені двійкові файли, вони будуть автоматично
доданий в debian/source/include-binaries щоб вони опинилися в tar-архіві Debian
(точно як dpkg-джерело --include-бінарні файли --будувати зробив би).

Будувати опції

--allow-version-of-quilt-db=версія
дозволяти dpkg-джерело щоб створити вихідний пакет, якщо версія файлу ковдру метадані
є вказаним, навіть якщо dpkg-джерело не знає про це (оскільки dpkg
1.15.5.4). Фактично це говорить про те, що дана версія ковдру метадані є
сумісна з версією 2 dpkg-джерело наразі підтримується. Версія о
ковдру метадані зберігаються в .pc/.версія.

--include-removal
Не ігноруйте видалені файли та включайте їх у автоматично згенерований патч.

--include-timestamp
Включіть позначку часу в автоматично згенерований патч.

--include-бінарні файли
Додайте всі змінені двійкові файли в tar-архів debian. Також додайте їх до
debian/source/include-binaries: вони будуть додані за замовчуванням у наступних збірках
і, таким чином, ця опція більше не потрібна.

--без підготовки
Не намагайтеся підготувати дерево побудови, застосувавши латки, які, мабуть, є
не застосовано (починаючи з dpkg 1.14.18).

--single-debian-patch
Скористайтесь debian/patches/debian-changes замість debian/patches/debian-changes-версія
для імені автоматичного виправлення, згенерованого під час збірки (починаючи з dpkg 1.15.5.4).
Ця опція особливо корисна, коли пакет підтримується в VCS і a
набір патчів не може бути надійно згенерований. Натомість поточний diff з upstream
слід зберігати в одному пластирі. Варіант був би введений
debian/source/local-options і буде супроводжуватися a
debian/source/local-patch-header файл, що пояснює, як зміни Debian можуть бути найкращими
переглянуто, наприклад, у VCS, що використовується.

--create-empty-orig
Автоматично створюйте основний оригінальний tar-архів як порожній, якщо він відсутній і якщо
є додаткові оригінальні tar-файли (починаючи з dpkg 1.15.6). Цей варіант є
призначений для використання, коли вихідний пакунок являє собою просто пачку кількох upstream
програмне забезпечення та там, де немає «основного» програмного забезпечення.

--no-unapply-patches, --unapply-patches
За замовчуванням dpkg-джерело автоматично скасує застосування патчів у --після побудови
гачок, якщо він застосував їх під час --перед побудовою (--unapply-patches оскільки dpkg
1.15.8, --no-unapply-patches починаючи з dpkg 1.16.5). Ці варіанти дозволяють
примусово вимкнути або ввімкнути процес скасування виправлення. Ці варіанти є
тільки дозволено debian/source/local-options так що всі згенеровані вихідні пакети
мають таку ж поведінку за замовчуванням.

--abort-on-upstream-changes
Процес не вдається, якщо було створено автоматичне виправлення (починаючи з dpkg 1.15.8).
Цей параметр можна використовувати, щоб переконатися, що всі зміни були належним чином записані
окремий ковдру виправлення перед збіркою вихідного пакета. Цей варіант не є
дозволено debian/джерело/параметри але можна використовувати в debian/source/local-options.

--автоматична фіксація
Процес не завершується, якщо було створено автоматичне виправлення, замість цього
негайно записано в ковдру серії.

Витяг опції

--skip-debianization
Пропускає вилучення tar-архів debian поверх вихідних джерел (оскільки dpkg
1.15.1).

--пропускати патчі
Не накладайте пластирі в кінці екстракції (починаючи з dpkg 1.14.18).

Формат: 3.0 (на замовлення)
Підтримується з dpkg 1.14.17. Цей формат особливий. Це не є справжнім джерелом
формат пакета, але може використовуватися для створення вихідних пакетів із довільними файлами.

Будувати опції

Усі аргументи без параметрів приймаються як файли для інтеграції в згенерований вихідний пакет.
Вони повинні існувати і, бажано, знаходяться в поточному каталозі. Принаймні один файл має бути
дано.

--target-format=значення
Вимагається. Визначає реальний формат згенерованого вихідного пакета. Згенерований
.dsc файл міститиме це значення у своєму сформований поле, а не «3.0 (користувацький)».

Формат: 3.0 (гіт)
Підтримується з dpkg 1.14.17. Цей формат є експериментальним.

Вихідний пакет у цьому форматі складається з одного пакета репозиторію git .git до
утримуйте джерело пакета. Також може бути а .gitshallow редагування списку файлів для
неглибокий клон git.

Вилучення

Пакет клонується як репозиторій git до цільового каталогу. Якщо є а
gitshallow файл, він встановлюється як .git/shalow всередині клонованого репозиторію git.

Зауважте, що за замовчуванням нове сховище матиме ту саму вилучену гілку, що була
перевірено в першоджерелі. (Звичайно «майстер», але це може бути що завгодно.) Будь-який
інші відділення будуть доступні під пульти/походження/.

Створюємо

Перш ніж продовжити, ми перевіряємо, чи немає жодних не-
ігнорувати незафіксовані зміни.

git-пакет(1) використовується для створення пакета репозиторію git. За замовчуванням все
гілки та теги в репозиторії включені в пакет.

Будувати опції

--git-ref=посилання
Дозволяє вказати посилання git для включення в пакет git. Використання вимикає значення за замовчуванням
поведінка включення всіх гілок і тегів. Можна вказати кілька разів. The
посилання може бути ім'ям гілки або тегом, який потрібно включити. Це також може бути будь-який параметр
до якого можна перейти git-rev-list(1). Наприклад, включити лише майстра
відділення, використання --git-ref=майстер. Включати всі теги та гілки, за винятком
приватне відділення, корист --git-ref=--все --git-ref=^приватний

--git-depth=номер
Створює неглибокий клон з історією, обрізаною до вказаної кількості
ревізії.

Формат: 3.0 (bzr)
Підтримується з dpkg 1.14.17. Цей формат є експериментальним. Він створює єдиний tar-архів
містить репозиторій bzr.

Вилучення

Архівний файл розпаковується, а потім bzr використовується для перевірки поточної гілки.

Створюємо

Перш ніж продовжити, ми перевіряємо, чи немає жодних не-
ігнорувати незафіксовані зміни.

Потім конкретна частина VCS вихідного каталогу копіюється до тимчасового
каталог. Перед тим, як цей тимчасовий каталог буде запаковано в tar-архів, виконуються різні очищення
зроблено для економії місця.

ДІАГНОСТИКА

немає джерело формат зазначений in debian/джерело/формат
Файл debian/джерело/формат має завжди існувати та вказувати потрібний вихідний формат.
Для зворотної сумісності передбачається формат «1.0», якщо файл не існує, крім вас
не слід покладатися на це: в якийсь момент у майбутньому dpkg-джерело буде змінено на невдачу
коли цього файлу не існує.

Причина полягає в тому, що формат «1.0» більше не є рекомендованим форматом, як правило, ви повинні
виберіть один із новіших форматів («3.0 (ковдра)», «3.0 (нативний)»), але dpkg-джерело не зробить
це автоматично для вас. Якщо ви хочете й надалі використовувати старий формат, ви повинні це зробити
чітко про це і вставте «1.0». debian/джерело/формат.

різниця змінює після вгору за течією файли
При використанні вихідного формату «1.0», як правило, є поганою ідеєю змінювати вихідні файли безпосередньо
оскільки зміни залишаються прихованими та переважно недокументованими у файлі .diff.gz. Замість вас
має зберігати ваші зміни як виправлення в каталозі debian і застосовувати їх під час збірки.
Щоб уникнути цієї складності, ви також можете використовувати формат «3.0 (ковдра)», який пропонує це
рідно.

не може представляти зміна до файл
Зміни до вихідних джерел зазвичай зберігаються у файлах виправлень, але не всі зміни можуть
бути представлені патчами: вони можуть змінювати лише вміст звичайних текстових файлів. Якщо ви
спробуйте замінити файл чимось іншого типу (наприклад, замінити звичайний
файл із символічним посиланням або каталогом), ви отримаєте це повідомлення про помилку.

нещодавно створений порожній файл файл волі НЕ be представлений in різниця
Порожні файли не можна створити за допомогою файлів виправлень. Таким чином, ця зміна не зафіксована в
вихідний пакет, і ви попереджені про це.

виконуваний файл режим завивки of файл волі НЕ be представлений in різниця
Файли виправлення не записують дозволи файлів, а отже, дозволи на виконання
зберігається у вихідному пакеті. Це попередження нагадує вам про цей факт.

спеціальний режим завивки of файл волі НЕ be представлений in різниця
Файли виправлення не записують дозволи файлів, а отже, змінені дозволи не записують
зберігається у вихідному пакеті. Це попередження нагадує вам про цей факт.

Фото ФОРМАТИ

debian/джерело/формат
Цей файл містить в одному рядку формат, який слід використовувати для створення джерела
пакет (можливі формати описані вище). Не допускаються пробіли на початку або в кінці.

debian/source/include-binaries
Цей файл містить список двійкових файлів (по одному на рядок), які повинні бути включені в файл
tarball debian. Початковий і кінцевий пробіли видаляються. рядки, що починаються з '#' є
коментарі та пропускаються. Порожні рядки ігноруються.

debian/джерело/параметри
Цей файл містить список довгих параметрів, які повинні бути автоматично додані до
набір параметрів командного рядка a dpkg-джерело --будувати or dpkg-джерело --формат друку дзвінок.
Варіанти, як -- стиснення та -- рівень стиснення добре підходять для цього файлу.

Кожен варіант слід винести в окремий рядок. Порожні рядки та рядки, які починаються з '#' є
ігнорується. провідний--' слід видалити, а короткі параметри заборонені. За бажанням
навколо '=Символ ' та необов'язкові лапки допускаються навколо значення.
Ось приклад такого файлу:

# дозвольте dpkg-source створити debian.tar.bz2 з максимальним стисненням
стиснення = "bzip2"
рівень стиснення = 9
# використовувати debian/patches/debian-changes як автоматичний патч
single-debian-patch
# ігнорувати зміни в конфігурації.{sub,gues}
extend-diff-ignore = "(^|/)(config.sub|config.guess)$"

Примітка: формат параметри не приймаються в цьому файлі, ви повинні використовувати debian/джерело/формат
замість цього.

debian/source/local-options
Точно так само debian/джерело/параметри за винятком того, що файл не входить до згенерованого
вихідний пакет. Може бути корисним зберігати налаштування, прив’язані до супроводжувача або до
Репозиторій VCS, де зберігається вихідний пакет.

debian/source/local-patch-header та debian/source/patch-header
Текст довільної форми, який розміщується поверх автоматичного патча, створеного у форматах «2.0» або
«3.0 (ковдру)». local-patch-header не входить до згенерованого вихідного пакету while
патч-заголовок є.

debian/patches/series
У цьому файлі перелічено всі виправлення, які потрібно застосувати (у зазначеному порядку) поверх файлу
вихідний вихідний пакет. Початковий і кінцевий пробіли видаляються. Рядки, які починаються з
"#' є коментарями та пропускаються. Порожні рядки ігноруються. Решта рядків починаються з a
ім'я файлу виправлення (щодо debian/патчі/ каталог) до першого пробілу
або кінець рядка. За бажанням ковдру параметри можуть йти до кінця рядка або до першого
"#' передує один або кілька пробілів (що позначає початок коментаря до кінця
рядок).

Використовуйте dpkg-source онлайн за допомогою служб onworks.net