debuild - Интернет в облаке

ПРОГРАММА:

ИМЯ

debuild - собрать пакет Debian

СИНТАКСИС

дебилд [дебилд кредита] [dpkg-buildpackage кредита] [--lintian-opts Lintian кредита]
дебилд [дебилд кредита] двоичный|двоичная арка|двоичный индекс|чистым ...

ОПИСАНИЕ

дебилд создает все файлы, необходимые для загрузки пакета Debian. Он сначала запускается
dpkg-buildpackage, затем бежит Lintian на .изменения файл создан (при условии, что Lintian
установлен), и, наконец, подписывает .изменения и / или .dsc файлы по мере необходимости (используя
дизайн(1) сделать это вместо dpkg-buildpackage(1) сама; все соответствующие подписи ключей
варианты передаются дальше). Параметры могут быть переданы в dpkg-buildpackage и Lintian, Где
параметры последнего обозначены значком --lintian-opts вариант. Допустимый
варианты в этом случае - линтиан и --но-линтианец заставить или пропустить Lintian шаг,
соответственно. По умолчанию запускается Lintian. Также доступны различные варианты
установка и сохранение переменных среды, как описано ниже в разделе "Среда"
Раздел переменных. В этом методе бега дебилд, мы также сохраняем журнал сборки в
файл ../ _ _ .строить.

Альтернативный способ использования дебилд использовать один или несколько параметров двоичный,
двоичная арка, двоичный индекс и чистымв каком случае дебилд попытается получить root
привилегии, а затем запустить debian / rules с заданными параметрами. А --rootcmd =усиление-корень-
команду or -rусиление-корень-команда опция может использоваться для указания метода получения root
привилегии. В усиление-корень-команда вероятно будет одним из подделка, Sudo or супер. Посмотреть
ниже для дальнейшего обсуждения этого момента. Опять же, варианты сохранения окружающей среды
может быть использовано. В этом случае, дебилд также попытается запустить dpkg-checkbuilddeps первый;
это можно явно запросить или отключить с помощью опций -D и -d соответственно.
Также обратите внимание, что если один из них или -r опция указывается в конфигурационном файле
вариант DEBUILD_DPKG_BUILDPACKAGE_OPTS, то он будет распознан даже в этом методе
призыв дебилд.

дебилд также читает сценарии разработки файлы конфигурации, как описано ниже. Это позволяет
должны быть предоставлены параметры по умолчанию.

Каталог имя контроль

Как и несколько других скриптов в сценарии разработки пакет, дебилд поднимется на
дерево каталогов, пока не найдет debian / журнал изменений файл, прежде чем пытаться построить
упаковка. В качестве защиты от случайных файлов, вызывающих потенциальные проблемы, он проверяет
имя родительского каталога после того, как он найдет debian / журнал изменений файл и проверьте, что
имя каталога соответствует имени пакета. Как именно это происходит?
управляется двумя переменными файла конфигурации DEVSCRIPTS_CHECK_DIRNAME_LEVEL и
DEVSCRIPTS_CHECK_DIRNAME_REGEX, и их соответствующие параметры командной строки --проверить-
уровень имени и --check-dirname-regex.

DEVSCRIPTS_CHECK_DIRNAME_LEVEL может принимать следующие значения:

0 Никогда не проверяйте имя каталога.

1 Проверяйте имя каталога только в том случае, если нам пришлось изменить каталог в нашем поиске
debian / журнал изменений. Это поведение по умолчанию.

2 Всегда проверяйте имя каталога.

Имя каталога проверяется путем проверки, соответствует ли текущее имя каталога (как определено
by PWD(1)) соответствует регулярному выражению, заданному параметром файла конфигурации
DEVSCRIPTS_CHECK_DIRNAME_REGEX или с помощью параметра командной строки --check-dirname-regex регулярное выражение.
Здесь регулярное выражение является регулярным выражением Perl (см. Perlre(3perl)), который будет привязан в начале
и конец. Если регулярное выражение содержит '/', то он должен соответствовать полному пути к каталогу. Если
нет, тогда оно должно соответствовать полному имени каталога. Если регулярное выражение содержит строку «ПАКЕТ»,
это будет заменено именем исходного пакета, как определено из изменений,
значение по умолчанию для регулярного выражения: «ПАКЕТ (-. +)?», таким образом сопоставляя имена каталогов, такие как
ПАКЕТ и ПАКЕТ-версия.

ОКРУЖАЮЩАЯ СРЕДА ПЕРЕМЕННЫЕ

Поскольку переменные среды могут повлиять на сборку пакета, часто непреднамеренно,
дебилд очищает среду, удаляя все переменные среды, кроме СРОК,
ГЛАВНАЯ, LOGNAME, ГНУПГХОМ, ПГПАТХ, GPG_AGENT_INFO, DBUS_SESSION_BUS_АДРЕС, ФАКЕРУТКЕЙ,
ДЭБ_*, (C, CPP, СХХ, LD и F)ФЛАГИ переменные и их _ПРИЛОЖЕНИЕEND коллеги и
переменные локали ДЛИННЫЙ и ЛК_*. СРОК устанавливается в "dumb", если он не установлен, и PATH на
"/ usr / sbin:/ USR / бен:/ SBIN:/ бен: / usr / bin / X11 ".

Если требуется передать конкретную переменную среды нетронутой в
процесс сборки, это может быть указано с помощью --preserve-envvar окружение (который также может
быть написано как -e окружение вариант). Окружающую среду можно оставить нетронутой, если использовать
--preserve-env вариант. Однако даже в этом случае PATH будет установлено разумное значение
описано выше. В только способ предотвратить PATH от сброса - указать
--preserve-envvar PATH вариант. Но вас предупреждают, что использование программ нестандартных
места могут легко привести к поломке упаковки, так как она не сможет быть
построен на стандартных системах.

Обратите внимание, что можно добавить каталоги в начало очищенного PATH, С использованием
--prepend-путь вариант. Это полезно, когда кто-то хочет использовать такие инструменты, как CCache or
DistCC для строительства.

Также можно избежать ввода чего-то вроде FOO=бар дебилд -e FOO by
письмо дебилд -e FOO=бар или полная форма дебилд --set-envvar FOO=бар.

Суперпользователь ТРЕБОВАНИЯ

дебилд для правильной работы необходимо запускать от имени суперпользователя. Есть три принципиально
разные способы сделать это. Первый и предпочтительный метод - использование корневых каналов.
команда. Лучше всего использовать, вероятно, подделка(1), поскольку он не предполагает предоставления
никаких настоящих привилегий. супер(1) и Sudo(1) также возможны. Если нет -r (или
--rootcmd) предоставляется вариант (и напомним, что dpkg-buildpackage также принимает -r опция)
и ни один из следующих методов не используется, тогда -rfakeroot будет молча предполагаться.

Второй способ - использовать какую-нибудь команду, например su(1) стать root, а затем сделать
все как root. Однако обратите внимание, что Lintian прервется, если он будет запущен как root или setuid
корень; это можно преодолеть, используя --allow-рут возможность Lintian если ты знаешь что ты
делаем.

Третий возможный метод - иметь дебилд установлен как setuid root. Это не тот
по умолчанию и должен быть установлен системным администратором как таковой. Это
также необходимо понимать, что любой, кто может бегать дебилд как root или setuid root имеет полный
доступ в домен все машина. Поэтому этот метод не рекомендуется, но он будет работать.
дебилд может быть установлен с режимом 4754, чтобы только члены группы-владельца могли
запустить его. Недостатком этого метода будет то, что другие пользователи не смогут
воспользуйтесь программой. Есть много других вариантов этого варианта с использованием нескольких копий.
of дебилд, или использование таких программ, как Sudo or супер для предоставления root-привилегий пользователям
выборочно. Если системный администратор желает это сделать, он должен использовать dpkg-statoverride
программа для изменения разрешений / usr / bin / debuild. Это гарантирует, что эти
разрешения сохраняются при обновлении.

КРЮКИ

дебилд поддерживает несколько крючков при беге dpkg-buildpackage. Обратите внимание, что если любой из
крючки из чистый крючок в окончательная очистка (включительно) используются, дебилд будет подражать некоторым
разделы dpkg-buildpackage процесс, а не запускать их напрямую, так как дпкг-
пакет сборки не поддерживает крючки. Доступны следующие крючки:

dpkg-buildpackage-крючок
Беги раньше dpkg-buildpackage начинается с звонка dpkg-checkbuilddeps.

чистый крючок
Беги раньше dpkg-buildpackage работает debian / rules чистым для очистки исходного дерева.
(Бегите, даже если дерево не очищается, потому что -нк используется.)

dpkg-источник-крючок
Бегите после очистки дерева и перед запуском dpkg-источник. (Беги, даже если дпкг-
источник не вызывается, потому что -b, -Bили -A используется.)

dpkg-build-крючок
Беги за dpkg-источник и перед звонком debian / rules строить. (Беги, даже если это
сборка только для исходного кода, поэтому debian / rules строить не называется.)

dpkg-бинарный крючок
Бегать между debian / rules строить и debian / rules двоичный(-арх). Запустить только если
бинарный пакет строится.

dpkg-genchanges-хук
Запускать после сборки двоичного пакета и перед вызовом dpkg-genchanges.

окончательная чистка крючком
Беги за dpkg-genchanges и перед финалом debian / rules чистым. (Беги, даже если мы
не очищают дерево после сборки, что является значением по умолчанию.)

линтиан-крюк
Беги (один раз) перед звонком Lintian. (Беги, даже если мы не звоним Lintian.)

подписывающий крючок
Беги после звонка Lintian до того, как состоится какое-либо подписание. (Беги, даже если мы не
подписывать что угодно.)

post-dpkg-buildpackage-хук
Беги, когда все будет готово.

Команда ловушки может быть указана в файле конфигурации, например,
DEBUILD_SIGNING_HOOK = 'foo' (обратите внимание, что дефис меняется на подчеркивание!) Или как команду
вариант линии - подписи-крючок-фу. В команде будут произведены определенные процентные замены.
в теме: %% будет заменен одиночным % знак, %p будет заменено названием пакета, %v
по номеру версии пакета, %s по номеру исходной версии, %u по исходной версии
количество. Ни один %s ни %u будет содержать эпоху. %a будет 1 если немедленно
необходимо выполнить следующее действие и 0 если нет (например, в dpkg-источник крючок %a
станет 1 if dpkg-источник должен быть запущен и 0 если не). Затем он будет передан
shell, чтобы иметь дело, поэтому он может включать перенаправления и прочее. Например, чтобы только запустить
домен dpkg-источник крючок если dpkg-источник должен быть запущен, ловушка может выглядеть примерно так: "if [
% a -eq 1]; тогда ...; fi ".

Пожалуйста, взять заботится крючки, поскольку их неправильное использование может привести к пакетам, которые FTBFS (не
сборка из исходников). Они могут быть полезны для создания снимков вещей или чего-то подобного.

Наконец, только dpkg-buildpackage-крючок и крючки из линтиан-крюк и далее можно использовать
if dpkg-крест установлено. (Это потому, что внутри дебилд пополнения
dpkg-buildpackage, но он не пытается повторно реализовать dpkg-крест замена
этот сценарий.)

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

Подробнее см. Выше.

--no-conf, --noconf
Не читайте файлы конфигурации. Это можно использовать только как первый вариант
дается в командной строке.

--rootcmd =усиление-корень-команда, -rусиление-корень-команда
Команда для получения привилегий root (или поддельных).

--preserve-env
Не очищайте среду, кроме PATH.

--preserve-envvar =вар, -eвар
Не чистите вар переменная из среды.

If вар заканчивается звездочкой ("*"), затем все переменные с именами, соответствующими
часть вар прежде, чем будет сохранена звездочка.

--set-envvar =вар=ценностное , -eвар=ценностное
Установите переменную среды вар в ценностное и не удаляйте его из
окружающей среды.

--prepend-path =ценностное
После того, как нормализованный PATH будет установлен, добавьте ценностное к нему.

- линтиан
Run Lintian после dpkg-buildpackage. Это поведение по умолчанию, и оно
отменяет любую директиву файла конфигурации наоборот.

--но-линтианец
Не беги Lintian после dpkg-buildpackage.

--no-tgz-проверить
Даже если мы бежим dpkg-buildpackage а номер версии имеет Debian
ревизии, не проверяйте, что .orig.tar.gz файл или .ориг каталог существует до
запуск сборки.

--tgz-проверить
Если мы бежим dpkg-buildpackage и номер версии имеет ревизию Debian,
проверьте, что .orig.tar.gz файл или .ориг каталог существует до запуска
строить. Это поведение по умолчанию.

--имя пользователя username
При подписании используйте списание вместо дизайн. username указывает учетные данные
использоваться.

--Foo-крючок=крючок
Установите крючок, как описано выше. Если крючок пусто, это снимает крючок.

--clear-крючки
Удаляет все крючки. Их можно восстановить с помощью более поздних параметров командной строки.

--check-имя-каталога-уровня N
См. Раздел выше Каталог имя контроль для объяснения этой опции.

--check-dirname-regex регулярное выражение
См. Раздел выше Каталог имя контроль для объяснения этой опции.

-d Не беги dpkg-checkbuilddeps чтобы проверить зависимости сборки.

-D Run dpkg-checkbuilddeps чтобы проверить зависимости сборки.

КОНФИГУРАЦИЯ ПЕРЕМЕННЫЕ

Два файла конфигурации /etc/devscripts.conf и ~ / .devscripts получены из оболочки
в этом порядке, чтобы установить переменные конфигурации. Параметры командной строки можно использовать для
переопределить некоторые из этих параметров файла конфигурации, в противном случае --no-conf вариант может быть
используется для предотвращения чтения этих файлов. Настройки переменных среды игнорируются, когда эти
файлы конфигурации читаются. В настоящее время распознаются следующие переменные:

DEBUILD_PRESERVE_ENV
Если это установлено на Да, то это то же самое, что и --preserve-env командной строки
используемый параметр.

DEBUUILD_PRESERVE_ENVVARS
Какие переменные среды сохранить. Это должен быть список разделенных запятыми
переменные. Это соответствует использованию, возможно, нескольких --preserve-envvar or -e
настройки.

DEBUILD_SET_ENVVAR_вар=ценностное
Это соответствует --set-envvar =вар=ценностное .

DEBUILD_PREPEND_PATH
Это соответствует --prepend-путь.

DEBUILD_ROOTCMD
Установка этой переменной на прог является эквивалентом -rпрог.

DEBUILD_TGZ_CHECK
Установка этой переменной на нет такой же, как --no-tgz-проверить командной строки.

DEBUUILD_SIGNING_USERNAME
Установка этой переменной аналогична использованию --имя пользователя командной строки.

DEBUILD_DPKG_BUILDPACKAGE_OPTS
Это параметры, которые следует передать при вызове dpkg-buildpackage.
Они даются перед любыми параметрами командной строки. Из-за проблем с цитированием оболочки, если
слово, содержащее пробелы, требуется в качестве единственного варианта, дополнительные кавычки будут
требуется. Например, чтобы гарантировать, что ваш собственный ключ GPG всегда используется, даже для
спонсируемые загрузки, файл конфигурации может содержать строку:

DEBUILD_DPKG_BUILDPACKAGE_OPTS = "- к'Джулиан Гилби[электронная почта защищена]> '-sa "

что дает ровно два варианта. Без лишних одинарных кавычек дпкг-
пакет сборки разумно жаловаться, что Гилби нераспознанный вариант (это
не начинается с - подписать).

Кроме того, если этот параметр содержит какие-либо -r, -d or -D варианты, они всегда будут использоваться
счет дебилд. Обратите внимание, что -r опция в этой переменной переопределит
установка в DEBUILD_ROOTCMD.

РАЗБОРКА_FOO_КРЮК
Переменная-хука для Foo крюк. См. Раздел о крючках выше, чтобы узнать больше.
Детали. По умолчанию это пусто.

DEBUILD_LINTIAN
Должны ли мы бежать Lintian? Если это установлено на нет, то Lintian запускаться не будет.

DEBUILD_LINTIAN_OPTS
Это параметры, которые следует передать при вызове Lintian, Они есть
перед любыми параметрами командной строки, и эта переменная используется как
описано для DEBUILD_DPKG_BUILDPACKAGE_OPTS Переменная.

DEVSCRIPTS_CHECK_DIRNAME_LEVEL, DEVSCRIPTS_CHECK_DIRNAME_REGEX
См. Раздел выше Каталог имя контроль для объяснения этих
переменные. Обратите внимание, что это переменные конфигурации всего пакета и будут
поэтому повлиять на все сценарии разработки скрипты, которые проверяют их значение, как описано в
их соответствующие manpages и в devscripts.conf(5).

ПРИМЕРЫ

Чтобы создать свой собственный пакет, просто запустите дебилд изнутри исходного дерева. дпкг-
пакет сборки(1) параметры могут быть указаны в командной строке.

Типичные параметры командной строки для создания только двоичных пакетов без подписания
.changes файл (или несуществующий файл .dsc):

разбирать -i -us -uc -b

Изменить -b в -S собрать только исходный код.

Пример использования Lintian чтобы проверить полученные пакеты и передать ему параметры:

отладить --lintian-opts -i

Обратите внимание на порядок опций здесь: дебилд сначала идут варианты, затем dpkg-buildpackage
единицы, а затем, наконец, варианты проверки. (А также Lintian вызывается по умолчанию.) Если вы найдете
вы используете то же самое dpkg-buildpackage варианты неоднократно, рассмотрите возможность использования
DEBUILD_DPKG_BUILDPACKAGE_OPTS вариант файла конфигурации, как описано выше.

Чтобы создать пакет для спонсируемой загрузки, учитывая foobar_1.0-1.dsc и соответствующие
исходные файлы, выполните что-то вроде следующих команд:

dpkg-source -x foobar_1.0-1.dsc
компакт-диск foobar-1.0
отладка -k0x12345678

где 0x12345678 заменяется вашим идентификатором ключа GPG или другим идентификатором ключа, например, вашим адресом электронной почты.
адрес. Опять же, вы также можете использовать DEBUILD_DPKG_BUILDPACKAGE_OPTS файл конфигурации
вариант, как описано выше, чтобы не вводить -k вариант каждый раз, когда вы делаете
спонсируемая загрузка.

Используйте debuild онлайн с помощью сервисов onworks.net