uscan - Онлайн в облаке

ПРОГРАММА:

ИМЯ

uscan - сканирование / просмотр исходных кодов апстрима на предмет появления новых версий программного обеспечения

СИНТАКСИС

американский [кредита] [путь]

ОПИСАНИЕ

Для базового использования американский выполняется без аргументов из корня Debianized
исходное дерево, где вы видите debian / каталог. Затем обычно происходит следующее:

· американский читает первую запись в debian / журнал изменений чтобы определить имя исходного пакета
и последняя версия апстрима.

· американский обработать линии наблюдения дебиан / часы сверху вниз в одном
проходить.

· американский загружает веб-страницу из указанного URL in дебиан / часы.

· американский извлекает hrefs, указывающие на архив (ы) восходящего потока с веб-страницы, используя
указанный шаблон соответствия in дебиан / часы.

· американский загружает tarball-пакет с самой высокой версией, новее последней
исходная версия.

· американский сохраняет загруженный архив в родительский ../ каталог:
../ - .tar.gz

· американский Запускает mk-origtargz для создания архива с исходным кодом:
../ _ .orig.tar.gz

· Для пакета с несколькими исходными архивами (MUT) вторичный архив исходных текстов
вместо этого будет назван ../ _ .orig- .tar.gz.

· Повторяйте, пока все строки в дебиан / часы обрабатываются.

· американский Запускает обновление для создания дерева исходных текстов Debianized: ../ - / *

Обратите внимание на следующее.

· Для простоты в примерах используется следующий метод сжатия: GZIP .gz суффикс.
Другие методы, такие как xz, bzip2 и LZMA с соответствующими xz, bz2 и LZMA
могут также использоваться суффиксы.

· Новый версия = 4 позволяет обрабатывать несколько пакетов tarball (MUT), но
это редкий случай для упаковки Debian. Для одного tarball-пакета основной ветки разработки,
есть только одна линия часов и нет ../ _ .orig- .tar.gz .

· американский с --подробный опция создает удобочитаемый отчет о американскийисполнение.

· американский с --отлаживать опция создает удобочитаемый отчет о американскийказнь
включая состояния внутренних переменных.

· американский с --деш опция создает отчет о статусе восходящего пакета в формате XML
для других программ, таких как Внешняя система работоспособности Debian.

· Основная цель американский помогает определить, установлена ​​ли последняя версия апстрима
tarball используется или нет; и скачать последнюю версию tarball. Порядок
версии решаются Dpkg --сравнить-версии.

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

ФОРМАТ OF СМОТРЕТЬ ФАЙЛОВ

Текущая версия 4 формата дебиан / часы можно резюмировать следующим образом:

· Ведущие пробелы и табуляции удаляются.

· Пустые строки отбрасываются.

· Очередь, начатая # (хеш) - это строка комментария и опущена.

· Один \ (обратная косая черта) в конце строки удаляется, и следующая строка
объединены после удаления начальных пробелов и табуляции. Составная строка анализируется
одной строкой. (Наличие или отсутствие пространства до хвостохранилища
одинарной \ имеет значение.)

· Первая строка без комментариев:

версия = 4

Это обязательно.

· Следующие строки без комментариев (строки наблюдения) определяют правила выбора
возможные URL-адреса tarball-архива и находятся в одном из следующих трех форматов:

· opts = " ... " http://URL шаблон соответствия [версия [скрипт]]

· http://URL шаблон соответствия [версия [скрипт]]

· opts = " ... "

Здесь,

· opts = " ... " определяет поведение американский. См. «СМОТРЕТЬ ОПЦИИ ФАЙЛОВ».

· http://URL указывает веб-страницу, на которой апстрим публикует ссылку на последний
исходный архив.

· https://URL также может использоваться, как и

· FTP: //URL

· Некоторые части URL может быть в шаблоне соответствия регулярного выражения, заключенном между ( и )
как /foo/bar-([\.\dpting+)/. (Если совпадают несколько каталогов, самый высокий
версия выбрана.) В противном случае URL принимается дословно.

· шаблон соответствия задает полный шаблон сопоставления строк для hrefs в Интернете
страница. См. «ПОСМОТРЕТЬ ПРИМЕРЫ ФАЙЛОВ».

· Все подходящие детали в ( и ) связаны с . (период) для формирования
исходная версия.

· Если hrefs не содержат каталогов, вы можете объединить это с
предыдущая запись. Т.е., http://URL/шаблон соответствия .

· версия ограничивает доступ к исходному архиву tarball. Новейший
доступная версия выбирается в каждом конкретном случае.

· Debian требует, чтобы загружаемый tarball был новее, чем версия
получен из debian / журнал изменений.

· номер версии как 12.5 требует, чтобы архив исходной программы был новее, чем
номер версии.

· то же требует, чтобы загруженная версия вторичных архивов была в точности
такой же, как и для первого загруженного архива основной ветки разработки. (Только полезно
для MUT)

· предыдущий ограничивает версию файла подписи. (Используется с
pgpmode = предыдущий)

· игнорировать не ограничивает версию вторичных архивов. (Может быть, полезно
для MUT)

· скрипт выполняется в конце американский исполнение с соответствующими аргументами
предоставляемые американский.

· Типичный пакет Debian - это неродной пакет, созданный из одного восходящего потока.
tarball. Только одна строка строки часов в одном из первых двух форматов.
обычно используется с его версия установлен в Debian и скрипт установлен в обновление.

· Собственный пакет не должен указывать скрипт.

· Пакет с несколькими исходными tarball (MUT) должен указывать обновление as скрипт in
последняя строка просмотра и следует пропустить указание скрипт в остальном часы
линий.

· Последний формат строки наблюдения полезен для установки постоянных параметров:
агент пользователя, (сила). Если используется этот формат, за ним должен следовать URL
определение линии (ей) наблюдения.

· [И] в указанном выше формате предназначены для обозначения необязательных частей и не должны использоваться
набрал.

Есть несколько специальных строк, которые заменены на американский чтобы было легко писать
файл часов.

@УПАКОВКА@
Оно заменяется именем исходного пакета, указанным в первой строке файла
debian / журнал изменений .

@ ЛЮБАЯ_ВЕРСИЯ @
Он заменяется законным регулярным выражением исходной версии (захват).

[-_] (\ d [\ - + \.: \ ~ \ da-zA-Z] *)

@ ARCHIVE_EXT @
Он заменяется типичным регулярным выражением расширения файла архива (без захвата).

(? i) \. (?: tar \ .xz | tar \ .bz2 | tar \ .gz | zip)

@ SIGNATURE_EXT @
Он заменяется типичным регулярным выражением расширения файла подписи (без захвата).

(? i) \. (?: tar \ .xz | tar \ .bz2 | tar \ .gz | zip) \. (?: asc | pgp | gpg | sig)

Некоторые расширения файлов не включены в приведенное выше намеренно, чтобы избежать ложных срабатываний.
Вы по-прежнему можете установить такие шаблоны расширений файлов вручную.

СМОТРЕТЬ ФАЙЛОВ ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

американский читает параметры часов, указанные в opts = " ... " чтобы настроить его поведение.
Несколько вариантов option1, option2, option3, ... можно задать как opts = "option1, option2,
option3, ... " . Двойные кавычки необходимы, если в параметрах есть пробелы.

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

Доступные варианты часов:

компонент =компонент
Задайте имя архива вторичного исходного кода как
_ .orig- .tar.gz для пакета MUT.

сжатие =метод
Установите сжатие метод когда тарболл перепакован (постоянный).

Доступны метод значения xz, GZIP (Alias gz), bzip2 (Alias bz2), а также расширение LZMA,
по умолчанию GZIP для обычных архивов и xz для архивов, созданных непосредственно из git
репозиторий.

Если исходный формат debian не 1.0, установите для него значение xz должно помочь уменьшить
размер упаковки при переупаковке.

Обратите внимание на переупаковку архивов исходной версии mk-origtargz происходит только если один
из следующих условий:

· USCAN_REPACK устанавливается в конфигурации devscript. См. «КОНФИГУРАЦИЯ DEVSCRIPT.
ПЕРЕМЕННЫЕ ".

· --переупаковать устанавливается в командной строке. Видеть .

· перепаковать устанавливается в строке просмотра как opts = "repack,...".

· Архив апстрима застежка-молния тип в том числе банка, XPI...

· Файлы-исключены or Файлы-исключены-компонент строфы установлены в debian / авторское право в
сделать mk-origtargz вызвано из американский удалить файлы из архива основной ветки разработки и
упакуйте его. См. «ПРИМЕРЫ ФАЙЛОВ АВТОРСКИХ ПРАВ» и mk-origtargz(1).

перепаковать
Принудительная переупаковка архива основной ветки разработки с помощью сжатия метод.

repacksuffix =суффикс
Добавить суффикс в исходную версию пакета Debian, только если исходный архив
переупакован. Это правило следует использовать только для одного tarball-пакета основной ветки разработки.

Режим =Режим
Установить скачивание архива Режим.

LWP Этот режим является режимом по умолчанию, который загружает указанный тарбол из
URL-адрес архива в Интернете.

мерзавец В этом режиме доступ к исходному архиву git осуществляется напрямую с помощью мерзавец Команда и
упаковывает исходное дерево с указанным тегом в spkg-версия.tar.xz.

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

pgpmode =Режим
Установите проверку подписи PGP / GPG Режим.

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

по умолчанию
Используйте pgpsigurlmangle =условиями, для генерации URL-адреса файла подписи кандидата в восходящем направлении
строка из URL-адреса архива восходящего направления. (дефолт)

Если указанный пгпсигурлмангл пропал, отсутствует, американский проверяет возможные URL-адреса для
файл подписи и предлагает добавить пгпсигурлмангл править.

калечить
Используйте pgpsigurlmangle =условиями, для генерации URL-адреса файла подписи кандидата в восходящем направлении
строка из URL-адреса архива восходящего направления.

следующий
Проверьте этот загруженный файл tarball с файлом подписи, указанным в следующем
смотреть линию. Следующая строка наблюдения должна быть pgpmode = предыдущий. В противном случае нет
происходит проверка.

предыдущий
Проверьте загруженный файл tarball, указанный в предыдущей строке наблюдения, с этим
файл подписи. Предыдущая строка наблюдения должна быть pgpmode = следующий.

себя
Проверьте загруженный файл foo.ext с собственной подписью и извлеките его содержимое
tarball файл как Foo.

нет
Подпись отсутствует. (Без предупреждения.)

разжимать
Распакуйте сжатый архив перед проверкой подписи pgp / gpg.

голый
Отключить весь специальный код конкретного сайта, такой как использование перенаправителя URL-адресов и страницы
изменения содержания. (настойчивый)

пользовательский агент =строка агента пользователя
Задайте строку агента пользователя, используемую для связи с сервером HTTP (S), как строка агента пользователя.
(настойчивый)

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

Pasv, пассивный
Используйте режим PASV для FTP-соединения.

Если режим PASV требуется из-за сетевой среды на стороне клиента, установите американский использовать
Режим PASV через "ОПЦИИ КОМАНДЫ" или "ПЕРЕМЕННЫЕ КОНФИГУРАЦИИ DEVSCRIPT".

активный, нопасв
Не используйте режим PASV для FTP-соединения.

unzipopt =кредита
Добавьте дополнительные параметры для использования с расстегнуть молнию команда, например -a, -аа и -b, Когда
выполняется по mk-origtargz.

dversionmangle =условиями,
Нормализовать строку последней исходной версии, найденной в debian / журнал изменений сравнить это с
доступная исходная версия tarball. Удаление специфического суффикса Debian, такого как
s / \ + dfsg \ d * $ // обычно делается здесь.

dirversionmangle =условиями,
Нормализовать строку пути к каталогу, соответствующую регулярному выражению, в круглых скобках
http://URL как сортируемая строка индекса версии. Используется как путь к каталогу
только индекс сортировки.

Замена типа s / PRE / ~ pre /; s / RC / ~ RC / может помочь.

pagemangle =условиями,
Нормализовать загруженную строку веб-страницы. (Не используйте это, если это не совсем
нужный. В целом, g для этих условиями,.)

Это удобно, если вы хотите получить доступ к репозиториям Amazon AWS или Subversion, в которых <a
href = "/ ..."> не используется.

uversionmangle =условиями,
Нормализовать строки версии кандидата в восходящем направлении, извлеченные из hrefs в источнике
веб-страницу. Он используется в качестве индекса сортировки версий при выборе последней версии.
исходная версия.

Замена типа s / PRE / ~ pre /; s / RC / ~ RC / может помочь.

versionmangle =условиями,
Синтаксическое сокращение для uversionmangle =условиями,, dversionmangle =условиями,

downloadurlmangle =условиями,
Преобразуйте выбранную строку href вышестоящего архива в доступный URL-адрес для
запутанные веб-сайты.

filenamemangle =условиями,
Сгенерировать имя файла архива восходящего потока из выбранной строки href, если соответствие-
описания может извлечь последнюю версию апстрима из выбранного href
нить. В противном случае сгенерируйте имя файла архива восходящего потока из его полной строки URL-адреса.
и установить недостающие из файла сгенерированного архива исходного кода.

Без этой опции имя файла архива апстрима по умолчанию генерируется с использованием
последний компонент URL-адреса и удаление всего после любого символа '?' или '#'.

pgpsigurlmangle =условиями,
Сгенерируйте строку URL-адреса восходящего файла подписи кандидата из вышестоящего архива.
URL.

oversionmangle =условиями,
Сгенерировать строку версии архива с исходным кодом
_ .orig.tar.gz от . Это следует использовать для добавления суффикса
как + dfsg1 в пакет MUT.

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

Каждое искажение править не может содержать ; (точка с запятой), , (запятая) или " (двойная кавычка).

Каждое искажение править ведет себя так, как будто команда Perl "$ строка =~ править"выполняется. Есть
некоторые примечательные детали.

· править может использовать только s, tr и y операций.

s/регулярное выражение/замена/кредита
Соответствие шаблону регулярного выражения и замена целевой строки. Только g, i и x флаги
доступный. Использовать $1 синтаксис обратных ссылок (Нет \1 синтаксис). Выполнение кода
не допускается (т.е. нет (? {}) or (?? {}) конструкции).

y/источник/Dest/ or т /источник/Dest/
Транслитерируйте символы в целевой строке.

ПРИМЕР OF ИСПОЛНЕНИЕ

американский читает первую запись в debian / журнал изменений чтобы определить имя исходного пакета и
последняя версия апстрима.

Например, если первая запись debian / журнал изменений это:

· бар (3: 2.03 + dfsg1-4) нестабильный; срочность = низкая

тогда имя исходного пакета бар а последняя версия пакета Debian -
3: 2.03 + dfsg1-4.

Последняя исходная версия нормализована до 2.03 + dfsg1 удалив эпоху и Debian
доработка.

Если же линия индикатора версия существует правило, последняя версия апстрима дополнительно нормализуется
применяя к нему это правило. Например, если последняя исходная версия 2.03 + dfsg1
указывает на то, что архив с исходным кодом переупакован, суффикс + dfsg1 удаляется строкой
замена s / \ + dfsg \ d * $ // чтобы сделать (dversionmangled) последней исходной версией 2.03 и
его сравнивают с предыдущими версиями tarball-кандидата, такими как 2.03, 2.04, ... найти в
удаленный сайт. Таким образом, установите это правило как:

· opts = "dversionmangle = s / \ + dfsg \ d * $ //"

американский загружает веб-страницу из http://URL указано в дебиан / часы.

· Если имя каталога является частью URL без скобок, ( и ), принимается как
дословно.

· Если имя каталога является частью URL есть круглые скобки, ( и ), то американский рекурсивно
ищет во всех возможных каталогах страницу с самой новой версией. Если
Dirversionmangle существует правило, сгенерированный индекс сортировки используется для поиска новейших
версия. Если для загрузки указана конкретная версия, соответствующая версия
строка имеет приоритет над самой новой версией.

Например, это http://URL можно указать как:

· http://www.example.org/([\ d \.] +) /

Обратите внимание на конечный / в приведенном выше сделать ([\ d \.] +) как каталог.

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

Загруженная веб-страница сканируется на предмет hrefs, определенных в <a href = "/ ... "> тег, чтобы найти
кандидат на исходный tarball hrefs. Эти кандидаты на исходный tarball href совпадают
по шаблону регулярных выражений Perl шаблон соответствия как DL - (?: [\ D \.] +?) / Foo - (. +) \. Tar \ .gz в
сузить список кандидатов. Это сопоставление с шаблоном должно быть закреплено в начале и
конец. Например, кандидатные hrefs могут быть:

· DL-2.02 / foo-2.02.tar.gz

· DL-2.03 / foo-2.03.tar.gz

· DL-2.04 / foo-2.04.tar.gz

Здесь соответствующая строка (. +) in шаблон соответствия рассматривается как кандидат
исходная версия. Если есть несколько совпадающих строк шаблонов захвата в
шаблон соответствия, все они связаны с . (период) для формирования кандидата
исходная версия. Обязательно используйте регулярное выражение без захвата, например (?: [\ d \.] +?) вместо
для части соответствия переменного текста, не связанной с версией.

Затем кандидатами в исходные версии являются:

· 2.02

· 2.03

· 2.04

Имя загруженного файла tarball в основном совпадает с именем файла в удаленном
URL-адрес выбранного href.

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

Href архива восходящего потока, соответствующий самому новому (uversionmangled) кандидату восходящего потока.
Выбирается версия новее (dversionmangled) последней исходной версии.

Если несколько исходных ссылок на tarball, соответствующие одной версии с разными
расширения существуют, выбирается максимальное сжатие. (Приоритет: tar.xz > tar.lzma >
tar.bz2 > tar.gz.)

Если выбранный исходный tarball href является относительным URL-адресом, он преобразуется в абсолютный
URL-адрес с использованием базового URL-адреса веб-страницы. Если <база href = "/ ... "> тег существует в
веб-странице выбранный исходный tarball href преобразуется в абсолютный URL-адрес с использованием
вместо этого указан базовый URL-адрес в базовом теге.

Если же линия индикатора DownloadurLmangle. существует правило, выбранный исходный tarball href нормализуется
применяя к нему это правило. (Это полезно для некоторых сайтов с запутанной загрузкой
URL.)

Если же линия индикатора имя_файла существует правило, загруженное имя файла tarball создается
применение этого правила к выбранному href, если шаблон соответствия может извлечь последние
исходная версия из выбранной строки href. В противном случае сгенерируйте
исходное имя файла tarball из его полной строки URL и установить отсутствующий из
сгенерированное имя файла архива апстрима.

Без имя_файла правило, имя файла архива исходного кода по умолчанию генерируется
беря последний компонент URL и удаляя все после любого '?' или '#'.

американский загружает выбранный архив исходной программы в родительский ../ каталог. Например,
загруженный файл может быть:

· ../foo-2.04.tar.gz

Назовем эту загруженную версию 2.04 в приведенном выше примере обычно как in
следующие.

Если же линия индикатора пгпсигурлмангл существует правило, URL-адрес файла подписи восходящего направления генерируется
применяя это правило к (downloadurlmangled) выбранному исходному архиву href и
файл подписи пытается скачать с него.

Если же линия индикатора пгпсигурлмангл правила не существует, американский предупреждает пользователя, если соответствующий восходящий поток
файл подписи доступен по тому же URL-адресу с суффиксом 4
общий суффикс по возрастанию, GPG, PGP и SIG. (Вы можете избежать этого предупреждения, установив
pgpmode = none.)

Если файл подписи загружен, загруженный tarball-файл проверяется на наличие
аутентичность по загруженному файлу подписи с использованием связки ключей
дебиан / восходящий поток / подписывание-ключ.pgp или бронированный брелок дебиан / восходящий поток / подписывание-ключ.asc
(см. «ПРИМЕРЫ ФАЙЛОВ КЛЮЧЕЙ»). Если его подпись недействительна или сделана не одним из
перечисленные ключи, американский сообщит об ошибке.

Если же линия индикатора надсионный клуб существует правило, исходная версия tarball оверсия генерируется из
загруженная версия апстрима версия применяя это правило. Это правило полезно добавить
суффикс, такой как + dfsg1 к версии всех исходных пакетов пакета MUT для
механизм переупаковки не работает.

американский Запускает mk-origtargz для создания архива с исходным кодом, правильно названного для источника
пакет с .ориг. (или .orig- . для вторичных архивов) в его имени файла.

случай A: упаковка архива основной ветки разработки как есть
mk-origtargz создает символическую ссылку ../бар_ .orig.tar.gz связан с загруженным
локальный архив исходных текстов. Здесь, бар имя исходного пакета, найденное в
debian / журнал изменений. Сгенерированная символическая ссылка может быть:

· ../bar_2.04.orig.tar.gz -> foo-2.04.tar.gz (как есть)

Обычно нет необходимости настраивать opts = "dversionmangle = ... " для этого случая.

случай B: упаковка архива основной ветки разработки после удаления файлов, не относящихся к DFSG
mk-origtargz проверяет глобус имени файла Файлы-исключены строфа в первом
раздел debian / авторское право, удаляет совпадающие файлы, чтобы создать перепакованный апстрим
tarball. Обычно перепакованный tar-архив основной ветки переименовывается с суффикс в
../бар_ .orig.tar.gz используя переупаковка вариант для сингла
пакет upstream. Здесь обновлен, чтобы быть .

Удаление файлов требуется, если файлы несовместимы с DFSG. В таком случае
+ dfsg1 используется как суффикс.

Таким образом, комбинированные параметры установлены как opts = "dversionmangle = s / \ + dfsg \ d * $ //
, repacksuffix = + dfsg1 ", вместо этого.

Например, перепакованный архив исходной программы может быть:

· ../bar_2.04+dfsg1.orig.tar.gz (переупакован)

американский обычно вызывает "обновление --найти --upstream-версия оверсия "для версии = 4
смотреть файл.

Обратите внимание, что --найти опция используется здесь, так как mk-origtargz был призван сделать
* .orig.tar.gz файл уже. американский выборы бар от debian / журнал изменений.

Он создает новое исходное дерево восходящего потока под ../бар- каталог и
Debianize его, используя последнее содержимое пакета.

СМОТРЕТЬ ФАЙЛОВ ПРИМЕРЫ

При написании файла просмотра вы должны полагаться на последнее объявление исходного кода.
страница в Интернете. Вы не должны пытаться угадать структуру архива восходящего потока, если это возможно.
Вот типичные дебиан / часы файлы.

Обратите внимание, что выполнение американский -v or -вв показывает, что именно происходит внутри.

Существование и несуществование помещения до хвостохранилища \ (обратная косая черта)
значительное.

HTTP сайте (Базовый)
Вот пример простого архива исходного кода.

версия = 4
http://example.com/~user/release/foo.html \
файлы / foo - ([\ d \.] +) \. tar \ .gz debian uupdate

Или используя специальные строки:

версия = 4
http://example.com/~user/release/@[электронная почта защищена] \
файлы / @ ПАКЕТ @@ ЛЮБАЯ_ВЕРСИЯ @@ ARCHIVE_EXT @ debian uupdate

Для пакета исходных кодов основной ветки разработки foo-2.0.tar.gz, этот файл часов загружается и создает
Debian ориг.tar файл foo_2.0.orig.tar.gz.

HTTP сайте (пгпсигурлмангл)
Вот пример простого архива исходного кода с соответствующим файлом подписи.
в том же пути к файлу.

версия = 4
opts = "pgpsigurlmangle = s% $%. asc%" http://example.com/release/@[электронная почта защищена] \
файлы / @ ПАКЕТ @@ ЛЮБАЯ_ВЕРСИЯ @@ ARCHIVE_EXT @ debian uupdate

Для пакета исходных кодов основной ветки разработки foo-2.0.tar.gz и файл подписи восходящего направления
foo-2.0.tar.gz.asc, этот файл часов загружает эти файлы, проверяет подлинность с помощью
брелок debian / upstream-key.pgp и создает Debian ориг.tar файл
foo_2.0.orig.tar.gz.

HTTP сайте (pgpmode = следующий / предыдущий)
Вот пример простого архива исходного кода с соответствующим файлом подписи.
в несвязанном пути к файлу.

версия = 4
opts = "pgpmode = next" http://example.com/release/@[электронная почта защищена] \
файлы / (?: \ d +) / @ ПАКЕТ @@ ЛЮБАЯ_ВЕРСИЯ @@ ARCHIVE_EXT @ debian
opts = "pgpmode = предыдущий" http://example.com/release/@[электронная почта защищена] \
files / (?: \ d +) / @ PACKAGE @@ ANY_VERSION @@ SIGNATURE_EXT @ предыдущее обновление uupdate

(?: \ d +) part может быть любым случайным значением. Файл tarball может иметь 53, а подпись
файл может иметь 33.

([\ d \.] +) часть файла подписи имеет строгое требование, чтобы оно соответствовало
исходный архив, указанный в предыдущей строке, имея предыдущий as версия в часах
линии.

HTTP сайте (гибкий)
Вот пример максимальной гибкости архива основной ветки разработки и файла подписи.
.

версия = 4
opts = "pgpmode = next" http://example.com/DL/ \
файлы / (?: \ d +) / @ ПАКЕТ @@ ЛЮБАЯ_ВЕРСИЯ @@ ARCHIVE_EXT @ debian
opts = "pgpmode = prevous" http://example.com/DL/ \
файлы / (?: \ d +) / @ ПАКЕТ @@ ЛЮБАЯ_ВЕРСИЯ @@ ПОДПИСЬ_ЭКСТ @ \
предыдущее обновление

HTTP сайте (базовая МУТ)
Вот пример базовых архивов с несколькими исходными кодами.

версия = 4
opts = "pgpsigurlmangle = s% $%. sig%" \
http://example.com/release/foo.html \
файлы / foo - ([\ d \.] +) \. tar \ .gz debian
opts = "pgpsigurlmangle = s% $%. sig%, component = bar" \
http://example.com/release/foo.html \
files / foobar - ([\ d \.] +) \. tar \ .gz то же самое
opts = "pgpsigurlmangle = s% $%. sig%, component = baz" \
http://example.com/release/foo.html \
files / foobaz - ([\ d \.] +) \. tar \ .gz тот же uupdate

Для основного исходного пакета исходников foo-2.0.tar.gz и вторичный источник вверх по течению
пакеты foobar-2.0.tar.gz и fobaz-2.0.tar.gz которые устанавливаются под бар/ и baz /, это
смотреть загрузки файлов и создает Debian ориг.tar файл foo_2.0.orig.tar.gz,
foo_2.0.orig-bar.tar.gz и foo_2.0.orig-baz.tar.gz. Кроме того, эти архивы исходного кода
проверено их файлами подписей.

HTTP сайте (рекурсивный каталог сканирование)
Вот пример рекурсивного сканирования каталогов на наличие архива основной ветки разработки и его
файлы подписи, выпущенные в каталоге, названном в честь их версии.

версия = 4
opts = "pgpsigurlmangle = s% $%. sig%, dirversionmangle = s / -PRE / ~ pre /; s / -RC / ~ rc /" \
http://tmrc.mit.edu/mirror/twisted/Twisted/([\ d + \.] +) / \
Скрученный - ([\ d \.] +) \. Tar \ .xz debian uupdate

Здесь веб-сайт должен быть доступен по следующему URL-адресу:

http://tmrc.mit.edu/mirror/twisted/Twisted/

Здесь, Dirversionmangle опция используется для нормализации порядка сортировки каталога
имена.

HTTP сайте (альтернатива стенография)
Для простого HTTP-сайта, на котором вы можете напрямую видеть имена файлов архивов, обычные часы
файл:

версия = 4
opts = "pgpsigurlmangle = s% $%. sig%" \
http://www.cpan.org/modules/by-module/Text/ \
Текст-CSV_XS - (. +) \. Tar \ .gz \
дебиан обновление

можно переписать в альтернативной сокращенной форме:

версия = 4
opts = "pgpsigurlmangle = s% $%. sig%" \
http://www.cpan.org/modules/by-module/Text/\
Текст-CSV_XS - (. +) \. Tar \ .gz \
дебиан обновление

Обратите внимание, что шаблон соответствия в первом примере нет каталога и
тонкая разница в пространстве перед хвостохранилищем \.

HTTP сайте (смешной версия)
Для сайта с забавными номерами версий группы в скобках будут объединены с .
(точка), чтобы сделать номер версии очищенной.

версия = 4
http://www.site.com/pub/foobar/foobar_v(\ d +) _ (\ d +) \. tar \ .gz \
дебиан обновление

HTTP сайте (ДФСГ)
Часть исходного кода версии Debian может быть изменена, чтобы указать источник.
пакет был переупакован для очистки файлов, не относящихся к DFSG:

версия = 4
opts = "dversionmangle = s / \ + dfsg \ d * $ //, repacksuffix = + dfsg1" \
http://some.site.org/some/path/foobar- (. +) \. tar \ .gz debian uupdate

См. «ПРИМЕРЫ ФАЙЛОВ АВТОРСКИХ ПРАВ».

HTTP сайте (имя_файлаmangle)
Имя файла архива восходящего потока можно найти, взяв последний компонент URL-адреса и
удаляя все после любого '?' или '#'.

Если это вам не подходит, используйте имя_файла, Например, <A
href = "/http://foo.bar.org/dl/? path = & dl = foo-0.1.1.tar.gz "> может обрабатываться как:

версия = 4
opts = filenamemangle = s /.*=(.*)/$ 1 / \
http://foo.bar.org/dl/\? путь = & dl = foo - (. +) \. tar \ .gz \
дебиан обновление

<A href = "/http://foo.bar.org/dl/? path = & dl_version = 0.1.1 "> может обрабатываться как:

версия = 4
opts = filenamemangle = s /.*=(.*)/ foo- $ 1 \ .tar \ .gz / \
http://foo.bar.org/dl/\? путь = & dl_version = (. +) \
дебиан обновление

Если строка href не имеет версии с использованием шаблона соответствия>, версия может быть получена
из полного URL-адреса, используя имя_файла.

версия = 4
opts = filenamemangle = s &. * / dl /(.*)/ foo \ .tar \ .gz & foo- $ 1 \ .tar \ .gz & \
http://foo.bar.org/dl/([\. \ d] +) / foo.tar.gz \
дебиан обновление

HTTP сайте (скачатьurlmangle)
Опция DownloadurLmangle. может использоваться для изменения URL-адреса файла для загрузки. Этот
можно использовать только с http:// URL-адреса. Это может быть необходимо, если ссылка в сети
страницу нужно каким-то образом преобразовать в ту, которая будет работать автоматически, для
пример:

версия = 4
opts = downloadurlmangle = s / prdownload / download / \
http://developer.berlios.de/project/showfiles.php? group_id = 2051 \
http://prdownload.berlios.de/softdevice/vdr-softdevice- (. +). tgz \
дебиан обновление

HTTP сайте (оверсионный клубок, МУТ)
Опция надсионный клуб может использоваться для искажения версии архива с исходным кодом
(.orig.tar.gz и .orig-bar.tar.gz). К примеру, + dfsg1 можно добавить в апстрим
версия как:

версия = 4
opts = oversionmangle = s /(.*)/$ 1 + dfsg1 / \
http://example.com/~user/release/foo.html \
файлы / foo - ([\ d \.] *). tar.gz debian
opts = "component = bar" \
http://example.com/~user/release/foo.html \
files / bar - ([\ d \.] *). tar.gz тот же uupdate

См. «ПРИМЕРЫ ФАЙЛОВ АВТОРСКИХ ПРАВ».

HTTP сайте (управление страницей)
Опция паж можно использовать для искажения загруженной веб-страницы перед применением других
правила. Нестандартная веб-страница без надлежащего <a href = "/ << ... >> "> записи могут быть
преобразован. Например, если foo.html использования <a фиктивный = " ... ">, это можно преобразовать в
стандартный формат страницы с:

версия = 4
opts = pagemangle = "s /
http://example.com/release/@[электронная почта защищена] \
файлы / @ ПАКЕТ @@ ЛЮБАЯ_ВЕРСИЯ @@ ARCHIVE_EXT @ debian uupdate

Обратите внимание на использование g здесь, чтобы заменить все вхождения.

If foo.html использования ... , это можно преобразовать в стандартный формат страницы с помощью:

версия = 4
opts = "pagemangle = s% ([^ <] *) % 1 доллар %г" \\
http://localhost: $ PORT / \
(?:. *) / @ ПАКЕТ @@ ЛЮБАЯ_ВЕРСИЯ @@ ARCHIVE_EXT @ debian uupdate

Ftp сайте (базовый):
версия = 4
ftp://ftp.tex.ac.uk/tex-archive/web/c_cpp/cweb/cweb- (. +) \. tar \ .gz \
дебиан обновление

Ftp сайте (регулярное выражение особый символы):
версия = 4
ftp://ftp.worldforge.org/pub/worldforge/libs/\
Атлас-C ++ / переходный / Атлас-C \ + \ + - (. +) \. Tar \ .gz debian uupdate

Обратите внимание, что этот URL подключен к ... библиотеки / Атлас-C ++ / ... . Для ++, Первый
один в пути к каталогу является дословным, а один в имени файла экранирован \.

Ftp сайте (смешной версия)
Это еще один способ работы с сайтом с забавными номерами версий, на этот раз с использованием искажений.
(Обратите внимание, что несколько групп будут объединены перед выполнением искажения, и что
изменение будет выполняться только с номером версии базового имени, а не с версией пути
числа.)

версия = 4
opts = "uversionmangle = s / ^ / 0.0./" \
ftp://ftp.ibiblio.org/pub/Linux/ALPHA/wine/\
разработка / Wine - (. +) \. tar \ .gz debian uupdate

sf.net
Для проектов на основе SourceForge qa.debian.org запускает перенаправитель, который позволяет упростить
форма URL. Приведенный ниже формат будет автоматически переписан для использования перенаправителя с
файл часов:

версия = 4
http://sf.net// - (. +) \. tar \ .gz debian uupdate

При покупке недвижимости дерзость, установите файл просмотра как:

версия = 4
http://sf.net/audacity/ Audacity-minsrc - (. +) \. tar \ .gz debian uupdate

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

версия = 4
opts = "uversionmangle = s / -pre / ~ pre /, \
filenamemangle = s% (?:. *) audacity-minsrc - (. +) \. tar \ .xz / download% \
дерзость- $ 1.tar.xz% "\
http://sourceforge.net/projects/audacity/files/audacity/(\ d [\ d \.] +) / \
(?:. *) audacity-minsrc - ([\ d \.] +) \. tar \ .xz / загрузить debian uupdate

Здесь, % используется как разделитель вместо стандартного /.

github.com
Для проектов на основе GitHub вы можете использовать страницу тегов или релизов. URL-адрес архива использует
только версия как имя файла. Вы можете переименовать загруженный архив исходной программы из
в стандарт - .tar.gz через имя_файла:

версия = 4
opts = "filenamemangle = s% (?:. *?)? v? (\ d [\ d.] *) \. tar \ .gz% - $ 1.tar.gz% "\
https://github.com/<user>/<project>/tags \
(?:. *? /)? v? (\ d [\ d.] *) \. tar \ .gz debian uupdate

PyPI
Для проектов на основе PyPI pypi.debian.net запускает перенаправитель, который позволяет более простую форму
URL. Приведенный ниже формат будет автоматически переписан, чтобы использовать перенаправитель с часами.
файл:

версия = 4
https://pypi.python.org/packages/source/<initial>/<project>/ \
- (. +) \. tar \ .gz debian uupdate

При покупке недвижимости cfn-сфера, установите файл просмотра как:

версия = 4
https://pypi.python.org/packages/source/c/cfn-sphere/ \
cfn-сфера - ([\ d \.] +). tar.gz debian uupdate

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

версия = 4
opts = "pgpmode = none, \
https://pypi.python.org/pypi/cfn-sphere/ \
https://pypi.python.org/packages/source/c/cfn-sphere/\
cfn-сфера - ([\ d \.] +). tar.gz #. * debian uupdate

code.google.com
Сайты, которые раньше размещались в сервисе Google Code, следовало перенести в другое место.
(гитхаб?). Пожалуйста, ищите более новый восходящий сайт.

направлять доступ в мерзавец хранилище
Если апстрим публикует свой код только через репозиторий git и у него нет веб-интерфейса
чтобы получить tarball-файл Releaseasse, вы можете использовать uscan с тегами репозитория git.

версия = 4
opts = "mode = git" http://git.ao2.it/tweeper.git \
refs / tags / v ([\ d \.] +) debian uupdate

Пожалуйста, обрати внимание "мерзавец ls-удаленный"используется для получения ссылок на теги. Если тег v20.5 это
новейший тег, в приведенном выше примере загружается спкг-20.5.tar.xz.

АВТОРСКИЕ ПРАВА ФАЙЛОВ ПРИМЕРЫ

Вот пример для debian / авторское право файл, который инициирует автоматическую переупаковку
исходный архив в _ .orig.tar.gz (В debian / авторское право, Файлы
Исключенный и Файлы-исключены-компонент строфы являются частью первого абзаца и там
это пустая строка перед следующими абзацами, которые содержат Файлы и др. строфы.):

Формат: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Исключенные файлы: exclude-this
исключить-dir
* / exclude-dir
.*
* / js / jquery.js

Файлы: *
Авторское право: ...
...

Вот еще один пример debian / авторское право файл, который запускает автоматический
переупаковка нескольких архивов исходного кода в _ .orig.tar.gz и
_ .orig-bar.tar.gz:

Формат: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Исключенные файлы: exclude-this
исключить-dir
* / exclude-dir
.*
* / js / jquery.js
Files-Excluded-bar: исключить-это
исключить-dir
* / exclude-dir
.*
* / js / jquery.js

Файлы: *
Авторское право: ...
...

Посмотреть mk-origtargz(1).

БРЕЛОК ДЛЯ КЛЮЧЕЙ ФАЙЛОВ ПРИМЕРЫ

Предположим, что восходящий поток "американский тест ключ (не секрет) <[электронная почта защищена]>"подписывает свой
пакет и публикует его отпечаток открытого ключа 'CF21 8F0E 7ЕАБ F584 B7E2 0402 C77E 2D68
7254 3ФАФ'который, как вы знаете, является надежным.

Обратите внимание, что короткий keyid 72543ФАФ это последние 4 байта, длинный идентификатор ключа
C77E2D6872543FAF это последние 8 байтов, а отпечаток пальца - это последние 20 байтов
открытый ключ в шестнадцатеричной форме. Вы можете сохранить ввод, используя короткий keyid, но вы должны
проверьте ключ OpenPGP по его отпечатку пальца.

Бронированный файл-брелок дебиан / восходящий поток / подписывание-ключ.asc можно создать с помощью GPG
(или gpg2) следующим образом.

$ gpg --recv-keys "72543FAF"
...
$ gpg --finger "72543FAF"
pub 4096R/72543FAF 2015-09-02
Отпечаток ключа = CF21 8F0E 7EAB F584 B7E2 0402 C77E 2D68 7254 3FAF
uid uscan тестовый ключ (не секрет)[электронная почта защищена]>
sub 4096R/52C6ED39 2015-09-02
$ cd путь / к / -
$ mkdir -p debian / восходящий поток
$ gpg --export --export-options экспорт-минимальный --броня \
'CF21 8F0E 7EAB F584 B7E2 0402 C77E 2D68 7254 3FAF' \
> debian / upstream / подписывание-ключ.asc

Вместо этого можно создать двоичный файл связки ключей, пропустив - броня и изменение
сохранение файла в дебиан / восходящий поток / подписывание-ключ.pgp в приведенном выше примере. Если группа
разработчики подписывают пакет, вам нужно перечислить отпечатки всех их в аргументе
для GPG - экспорт ... чтобы связка ключей содержала все их ключи OpenPGP.

Иногда вы можете задаться вопросом, кто сделал файл подписи. Вы можете получить открытый ключ, используемый для
создать отдельный файл подписи foo-2.0.tar.gz.asc запустив GPG

$ gpg -vv foo-2.0.tar.gz.asc
gpg: armor: НАЧАТЬ ПОДПИСЬ PGP
gpg: заголовок брони: Версия: GnuPG v1
: пакет подписи: алгоритм 1, идентификатор ключа C77E2D6872543FAF
версия 4, создано 1445177469, md5len 0, sigclass 0x00
алгоритм дайджеста 2, начало дайджеста 7a c7
hashed subpkt 2 len 4 (подпись создана 2015)
subpkt 16 len 8 (идентификатор ключа эмитента C77E2D6872543FAF)
данные: [4091 бит]
gpg: предполагается, что подписанные данные находятся в `foo-2.0.tar.gz '
gpg: Подпись сделана 18 октября 2015 г., 11:11:09 JST с использованием идентификатора ключа RSA 72543FAF
...

КОМАНДНАЯ СТРОКА ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

Для базового использования американский не требует установки этих параметров.

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

- без подробностей
Не сообщайте подробную информацию. (дефолт)

--подробный, -v
Сообщите подробную информацию.

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

--деш
Отправлять выходные данные в стиле DEHS (XML-типа) в STDOUT, а все остальные выходные данные uscan отправлять в
СТДЕРР.

--но-дехс
Используйте только традиционный выходной формат uscan. (дефолт)

--скачать, -d
Загрузите новую версию апстрима. (дефолт)

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

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

--нет загрузки, --nodownload
Не скачивайте и не сообщайте информацию.

Можно использовать ранее загруженные архивы tar.

Измените значение по умолчанию на - подпись пропуска.

--подпись
Скачать подпись. (дефолт)

- без подписи
Не загружайте подпись, а проверьте, если она уже загружена.

- подпись пропуска
Не загружайте подпись и не проверяйте подпись.

--безопасно, --отчет
Избегайте запуска небезопасных сценариев, пропуская переупаковку загруженного пакета.
и обновление нового дерева исходных текстов.

Измените значение по умолчанию на --нет загрузки и - подпись пропуска.

Когда цель бега американский собирать статус пакета восходящего потока под
среда, заботящаяся о безопасности, обязательно используйте эту опцию.

--отчет-статус
Это эквивалент установки "--подробный --безопасно".

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

--download-debversion версия
Укажите версию пакета Debian, чтобы загрузить соответствующий выпуск основной ветки разработки.
версия. версия и версия правила учтены. (лучшее усилие
особенность)

--скачать-текущую-версию
Загрузите текущую упакованную версию. (функция максимального усилия)

--check-имя-каталога-уровня N
См. Ниже раздел «Проверка имени каталога» для объяснения этой опции.

--check-dirname-regex регулярное выражение
См. Ниже раздел «Проверка имени каталога» для объяснения этой опции.

--destdir
Установите путь к каталогу для загрузки вместо пути по умолчанию ../, Если
указанный путь не является абсолютным, он будет относиться к одному из текущего каталога
или, если сканирование каталогов включено, исходный каталог пакета.

--упаковка пакет
Укажите имя пакета, который нужно проверить, а не изучать debian / журнал изменений;
это требует --upstream-версия (если версия не указана в смотреть файл)
и --смотреть файл варианты тоже. Кроме того, сканирование каталогов выполняться не будет и
ничего скачивать не будет. Эта опция автоматически устанавливает --нет загрузки и
- подпись пропуска; и, вероятно, наиболее полезен в сочетании с системой DEHS (и
--деш).

--upstream-версия апстрим-версия
Укажите текущую версию основной ветки разработки, а не изучите дебиан / часы or
debian / журнал изменений чтобы определить это. Это игнорируется, если выполняется сканирование каталога.
выполнено и более одного дебиан / часы файл найден.

--смотреть файл файл наблюдения
Укажите файл наблюдения вместо того, чтобы выполнять сканирование каталогов для его определения. Если это
вариант используется без --упаковка, то американский должен вызываться из Debian
дерево исходного кода пакета (так что debian / журнал изменений можно найти, просто поднявшись
через дерево).

- голый
Отключите все коды особых случаев для конкретных сайтов для выполнения перенаправления URL-адресов и страниц
изменения содержания.

- без исключения
Не исключать автоматически файлы, упомянутые в debian / авторское право поле Файлы-исключены.

--pasv
Принудительный режим PASV для FTP-соединений.

--но-пасв
Не используйте режим PASV для FTP-соединений.

--без символической ссылки
Не звони mk-origtargz.

- тайм-аут N
Установите тайм-аут на N секунд (по умолчанию 20 секунд).

--пользователь-агент, --пользователь
Заменить заголовок пользовательского агента по умолчанию.

--Помогите
Дайте краткую информацию об использовании.

--версия
Показать информацию о версии.

американский также принимает следующие параметры и передает их mk-origtargz:

--симлинк
MAKE ориг.tar.gz (с соответствующим расширением) символическая ссылка на загруженные файлы.
(Это поведение по умолчанию.)

- копия
Вместо создания символических ссылок, как описано выше, скопируйте загруженные файлы.

--переименовать
Вместо создания символических ссылок, как описано выше, переименуйте загруженные файлы.

--переупаковать
После загрузки архивов lzma tar, xz tar, bzip tar, gz tar, zip, jar, xip,
перепаковать его до указанного сжатия (см. - сжатие).

Пакет unzip должен быть установлен для повторной упаковки архивов zip и jar,
Пакет mozilla-devscripts должен быть установлен для перепаковки архивов xip, а xz-utils
пакет должен быть установлен для повторной упаковки tar-архивов lzma или xz.

- сжатие [ GZIP | bzip2 | LZMA | xz ]
В случае перепаковки исходных кодов (либо из-за того, что --переупаковать опция
данный или debian / авторское право содержит поле Файлы-исключены) можно
управлять методом сжатия с помощью параметра. По умолчанию GZIP для нормального
tarballs и xz для архивов, созданных непосредственно из репозитория git.

- copyright-file авторский файл
Исключить файлы, указанные в Файлы-исключены в данном авторский файл. Это полезно
при беге американский не в каталоге исходного пакета.

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

Для базового использования американский не требует установки этих переменных конфигурации.

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

USCAN_DOWNLOAD
Если это установлено на нет, то новые исходные файлы загружаться не будут; это
эквивалентно --нет загрузки настройки.

USCAN_SAFE
Если это установлено на Да, то американский позволяет избежать запуска небезопасных сценариев, пропуская оба
перепаковка загруженного пакета и обновление нового дерева исходных текстов; это
эквивалентно --безопасно опции; это также устанавливает значение по умолчанию на --нет загрузки и
- подпись пропуска.

USCAN_PASV
Если установлено значение «да» или «нет», FTP-соединения будут использовать режим PASV или нет.
к, соответственно. Если это установлено по умолчанию, то Сеть :: FTP(3) делает выбор
(в первую очередь на основе FTP_PASSIVE переменная окружения).

USCAN_TIMEOUT
Если установлено число N, затем установите тайм-аут на N секунд. Это эквивалентно
- тайм-аут опцию.

USCAN_SYMLINK
Если установлено значение «нет», тогда упак_версия.orig.tar. {gz | bz2 | lzma | xz} символическая ссылка не будет
сделано (эквивалент --без символической ссылки вариант). Если он установлен на Да or символическая, то
будут сделаны символические ссылки. Если задано переименование, файлы переименовываются (эквивалент
до --переименовать опция).

USCAN_DEHS_OUTPUT
Если это установлено на Да, то будет использоваться вывод в стиле DEHS. Это эквивалентно
--деш опцию.

USCAN_VERBOSE
Если это установлено на Да, то будет предоставлен подробный вывод. Это эквивалентно
--подробный опцию.

USCAN_USER_AGENT
Если установлено, указанная строка пользовательского агента будет использоваться вместо значения по умолчанию. Это
эквивалентно --пользователь-агент опцию.

USCAN_DESTDIR
Если установлено, загруженные файлы будут помещены в этот каталог. Это эквивалентно
--destdir опцию.

USCAN_REPACK
Если установлено значение «Да», то после загрузки файлов bzip tar, lzma tar, xz tar или
zip-архив, uscan перепакует его до указанного сжатия (см. - сжатие).
Это эквивалентно --переупаковать опцию.

USCAN_EXCLUSION
Если установлено значение «нет», файлы, указанные в поле Файлы-исключены of debian / авторское право
будут игнорироваться, и попытки исключения файлов не предпринимаются. Это эквивалентно
- без исключения опцию.

ВЫХОД статус

Статус выхода дает некоторое представление о том, была ли найдена более новая версия; один
посоветовал прочитать вывод, чтобы точно определить, что произошло и были ли
предупреждения, которые следует принять к сведению.

0 Или --Помогите or --версия использовался, или для некоторых смотреть файл, который был исследован,
была обнаружена более новая исходная версия.

1 Не было найдено более новых исходных версий ни для одного из смотреть файлы изучены.

ADVANCED ФУНКЦИИ И ОСОБЕННОСТИ

американский имеет много других расширенных функций, которые пропущены в разделе выше для
простота. Давайте проверим их основные моменты.

американский на самом деле сканирует не только текущий каталог, но и все его подкаталоги в поисках
дебиан / часы обработать их все. См. «Проверка имени каталога».

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

См. «ОПЦИИ КОМАНДНОЙ ЛИНИИ» и «ПЕРЕМЕННЫЕ КОНФИГУРАЦИИ DEVSCRIPT» для получения информации о других вариантах.

На заказ скрипт
Необязательный скрипт параметр в дебиан / часы означает выполнить скрипт с вариантами после
обработка этой строки, если указано.

Для совместимости с другими инструментами, такими как git-buildpackage, может быть неразумно создавать
кастомные скрипты с произвольным поведением. В целом, обновление лучший выбор для не-
собственный пакет и пользовательские сценарии, если они созданы, должны вести себя так, как если бы обновление. По возможности
вариант использования, см.http://bugs.debian.org/748474> как пример.

URL отвлечение внимания
Некоторые популярные веб-сайты изменили структуру своих веб-страниц, что привело к проблемам с обслуживанием.
файл часов. Есть некоторые службы перенаправления, созданные для упрощения обслуживания
смотреть файл. В настоящее время, американский автоматически перенаправляет URL-запросы на следующие
URL-адреса, чтобы справиться с этой ситуацией.

·http://sf.net>

·http://pypi.python.org>

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

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

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

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

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

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

ИСТОРИЯ И ОБНОВЛЕНИЕ

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

Предварительная версия 2
The смотреть синтаксис файлов в то время сильно отличался. Не используйте это. если ты
обновляются с предварительной версии 2 смотреть файла рекомендуется прочитать эту страницу руководства
и начать с нуля.

Версия 2
сценарии разработки версия 2.6.90: Первое воплощение текущего стиля смотреть файлы.

Версия 3
сценарии разработки версия 2.8.12: Введено следующее: правильная обработка специальных регулярных выражений.
символы в части пути, соответствие каталогу / шаблону пути, номер версии в
несколько частей, переделка номера версии. Более поздние версии также представили URL
искажение.

Если вы обновляетесь с версии 2, основная несовместимость заключается в том, что у вас есть несколько
группы в выкройке; тогда как в версии 2 будет использоваться только первый,
все они будут использоваться в версии 3. Чтобы избежать такого поведения, измените не-версию -
группы номеров, которые будут (?: ... ) вместо простого ( ... ) группа.

· американский вызывает обычай скрипт как "скрипт --upstream-версия версия
../spkg_version.orig.tar.gz".

· американский ссылается на стандарт обновление как "обновление --без символической ссылки --upstream-версия
версия ../spkg_version.orig.tar.gz".

Версия 4
сценарии разработки версия 2.15.10: Первое воплощение смотреть файлы, поддерживающие несколько
архивы исходного кода.

Синтаксис файла просмотра ослаблен, чтобы было больше места для чтения.

Если у вас есть собственный сценарий вместо обновление, вы также можете столкнуться с проблемами
обновление с версии 3.

· американский вызывает обычай скрипт как "скрипт --upstream-версия версия".

· американский ссылается на стандарт обновление как "обновление --найти --upstream-версия версия".

Ограничение на --деш поднимается перенаправлением другого вывода в STDERR, когда он
активируется.

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