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

ПРОГРАММА:

ИМЯ

apt-ftparchive - Утилита для генерации индексных файлов

СИНТАКСИС

apt-ftparchive [-дск] [--md5] [--удалить связь] [- только чтение] [--содержание] [--арх архитектура]
[-o =строка_конфигурации] [-c =файл_конфигурации]
{пакетов путь... [файл-переопределение [префикс пути]] |
источников путь... [файл-переопределение [префикс пути]] | содержание путь |
освободить путь | генерировать файл_конфигурации .... | чистый файл_конфигурации |
{-v | --version} | {-h | --помощь}}

ОПИСАНИЕ

apt-ftparchive это инструмент командной строки, который генерирует индексные файлы, которые APT использует для
получить доступ к источнику распространения. Индексные файлы должны быть созданы на исходном сайте на основе
о содержании этого сайта.

apt-ftparchive представляет собой надмножество dpkg-scanpackages(1) программа, включающая в себя всю
функциональность через команду packages. Он также содержит генератор файлов содержимого,
содержание, а также продуманные средства «сценария» процесса генерации для полного
архив.

внутренне apt-ftparchive может использовать двоичные базы данных для кэширования содержимого .deb
файл, и он не полагается на какие-либо внешние программы, кроме GZIP(1). При выполнении полного
генерировать его автоматически выполняет проверки изменений файлов и создает желаемый сжатый файл.
выходные файлы.

Если -hили --Помогите задана опция, должна присутствовать одна из команд ниже.

пакеты
Команда packages генерирует файл пакета из дерева каталогов. Требуется
заданный каталог и рекурсивно ищет в нем файлы .deb, создавая запись пакета
в стандартный вывод для каждого. Эта команда примерно эквивалентна dpkg-scanpackages(1).

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

источников
Команда sources генерирует файл индекса источника из дерева каталогов. Требуется
заданный каталог и рекурсивно ищет в нем файлы .dsc, выдавая исходную запись
в стандартный вывод для каждого. Эта команда примерно эквивалентна dpkg-scansources(1).

Если указан файл переопределения, то файл переопределения источника будет искать с
расширение .src. Параметр --source-override может использоваться для изменения источника
переопределить файл, который будет использоваться.

фактов
Команда содержимого создает файл содержимого из дерева каталогов. Требуется
заданный каталог и рекурсивно ищет в нем файлы .deb и читает список файлов
из каждого файла. Затем он сортирует и записывает в стандартный вывод список файлов, соответствующих
пакеты. Каталоги не записываются на выход. Если несколько пакетов владеют одним и тем же
file, то каждый пакет в выводе отделяется запятой.

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

освободить
Команда release создает файл Release из дерева каталогов. Это рекурсивно
ищет в данном каталоге несжатые файлы Packages и Sources, а также
сжатый с GZIP, bzip2 or LZMA а также файлы Release и md5sum.txt по умолчанию
(APT :: FTPArchive :: Release :: Default-Patterns). Дополнительные шаблоны имен файлов могут быть
добавлены путем перечисления их в APT :: FTPArchive :: Release :: Patterns. Затем он пишет в стандартный вывод
файл выпуска, содержащий (по умолчанию) дайджест MD5, SHA1, SHA256 и SHA512 для каждого
.

Значения для дополнительных полей метаданных в файле версии берутся из
соответствующие переменные в APT :: FTPArchive :: Release, например
APT :: FTPArchive :: Release :: Origin. Поддерживаемые поля: Origin, Label, Suite,
Версия, Кодовое имя, Дата, Срок действия, Архитектура, Компоненты, Описание.

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

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

СОЗДАТЬ КОНФИГУРАЦИЯ

Команда generate использует файл конфигурации для описания архивов, которые будут
быть сгенерирован. Он следует типичному формату конфигурации ISC, как показано в инструментах ISC, таких как
привязать 8 и dhcpd. apt.conf(5) содержит описание синтаксиса. Обратите внимание, что
Генерация конфигурации анализируется по частям, но apt.conf(5) разбирается в дереве
манера. Это влияет только на то, как обрабатывается тег области.

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

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

АрхивКаталог
Задает корень FTP-архива, в стандартной конфигурации Debian это
каталог, содержащий узлы ls-LR и dist.

ПереопределитьDir
Задает расположение файлов переопределения.

CacheDir
Задает расположение файлов кеша.

ФайлЛистДир
Указывает расположение файлов списка файлов, если параметр FileList используется ниже.

По умолчанию Раздел
В разделе «По умолчанию» указаны значения по умолчанию и настройки, управляющие работой
генератор. Другие разделы могут переопределить эти значения по умолчанию с настройкой для каждого раздела.

Пакеты :: Компресс
Устанавливает схемы сжатия по умолчанию для использования в индексных файлах пакета. Это
строка, содержащая список, разделенный пробелами, по крайней мере из одного из: '.' (без сжатия),
gzip и bzip2. По умолчанию для всех схем сжатия установлено значение '. gzip '.

Пакеты :: Расширения
Устанавливает список расширений файлов по умолчанию, которые являются файлами пакетов. По умолчанию это
'.deb'.

Источники :: Сжать
Это похоже на Packages :: Compress, за исключением того, что он контролирует сжатие для
Исходные файлы.

Источники :: Расширения
Устанавливает список расширений файлов по умолчанию, которые являются исходными файлами. По умолчанию это
'.dsc'.

Содержание :: Сжать
Это похоже на Packages :: Compress, за исключением того, что он контролирует сжатие для
Файлы содержимого.

Перевод :: Сжать
Это похоже на Packages :: Compress, за исключением того, что он контролирует сжатие для
Перевод-en мастер-файл.

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

Режим файла
Задает режим всех созданных индексных файлов. По умолчанию 0644. Все индексные файлы
установлены в этот режим без учета маски umask.

Длинное описание
Определяет, следует ли включать длинные описания в файл пакетов или разделять
в главный файл Translation-en.

ДеревоПо умолчанию Раздел
Устанавливает значения по умолчанию для разделов дерева. Все эти переменные являются переменными подстановки
и замените строки $ (DIST), $ (SECTION) и $ (ARCH) их соответствующими
значения.

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

Содержание Возраст
Управляет количеством дней, в течение которых файл содержимого может проверяться без изменения.
Если этот предел превышен, mtime файла содержимого обновляется. Этот случай может произойти
если файл пакета изменен таким образом, что не приводит к новому содержанию
файл [например, переопределить редактирование]. Задержка разрешена в надежде, что новый .debs будет
быть установленным, в любом случае требуя новый файл. По умолчанию 10, единица измерения - дни.

Каталог
Устанавливает верхнюю часть дерева каталогов .deb. По умолчанию
$ (РАСП) / $ (РАЗДЕЛ) / двоичный - $ (АРХИВ) /

SrcDirectory
Устанавливает верхнюю часть дерева каталогов исходного пакета. По умолчанию
$ (РАСП) / $ (РАЗДЕЛ) / источник /

Packages
Устанавливает выходной файл пакетов. По умолчанию $ (DIST) / $ (SECTION) / binary - $ (ARCH) / Packages

Источники
Устанавливает выходной файл источников. По умолчанию $ (DIST) / $ (SECTION) / source / Sources.

Переводы
Устанавливает выходной мастер-файл Translation-en с длинными описаниями, если они должны
не включаться в файл Packages. По умолчанию
$ (DIST) / $ (SECTION) / i18n / Translation-en

Внутренний префикс
Устанавливает префикс пути, который заставляет символическую ссылку вместо этого считаться внутренней ссылкой.
внешней ссылки. По умолчанию $ (DIST) / $ (SECTION) /

Содержание:
Устанавливает выходной файл содержимого. По умолчанию $ (DIST) / $ (SECTION) / Contents - $ (ARCH). Если
этот параметр приводит к тому, что несколько файлов пакетов отображаются в один файл содержимого (как
по умолчанию), затем apt-ftparchive объединит эти файлы пакетов вместе
автоматически.

Содержание :: Заголовок
Устанавливает заголовочный файл для добавления к выводу содержимого.

Бинкачедб
Устанавливает базу данных двоичного кэша для использования в этом разделе. Несколько разделов могут делиться
та же база данных.

Список файлов
Указывает, что вместо просмотра дерева каталогов apt-ftparchive следует прочитать
список файлов из данного файла. К именам относительных файлов добавляется префикс архива.
каталог.

ИсходныйСписокФайлов
Указывает, что вместо просмотра дерева каталогов apt-ftparchive следует прочитать
список файлов из данного файла. К именам относительных файлов добавляется префикс архива.
каталог. Это используется при обработке исходных индексов.

дерево Раздел
Раздел «Дерево» определяет стандартное файловое дерево Debian, которое состоит из базового каталога,
затем несколько разделов в этом базовом каталоге и, наконец, несколько Архитектур в каждом
раздел. Используемый точный путь определяется переменной подстановки Справочника.

Раздел Tree принимает тег области, который устанавливает переменную $ (DIST) и определяет корень
дерево (путь имеет префикс ArchiveDir). Обычно это такая настройка, как
Диски / Джесси.

Все настройки, определенные в разделе TreeDefault, можно использовать в разделе Tree как
а также три новых переменных.

При обработке раздела дерева apt-ftparchive выполняет операцию, аналогичную:

ибо я в разделах делаю
для j в архитектурах сделать
Сгенерировать для DIST = scope SECTION = i ARCH = j

Разделы
Это список разделов, разделенных пробелами, которые появляются под раздачей;
обычно это что-то вроде main contrib non-free

Архитектуры
Это список всех архитектур, отображаемых при поиске, через пробел.
раздел. Специальная архитектура 'source' используется, чтобы указать, что это дерево имеет
исходный архив. Архитектура "все" указывает на то, что файлы, относящиеся к конкретной архитектуре, такие как
Пакеты не должны включать информацию об архитектуре всех пакетов во всех файлах
поскольку они будут доступны в отдельном файле.

Длинное описание
Определяет, следует ли включать длинные описания в файл пакетов или разделять
в главный файл Translation-en.

БинОверрайд
Устанавливает двоичный файл переопределения. Файл переопределения содержит раздел, приоритет и
адресная информация обслуживающего персонала.

СркОверрайд
Устанавливает исходный файл переопределения. Файл переопределения содержит информацию о разделе.

ЭкстраОверрайд
Устанавливает двоичный файл дополнительного переопределения.

Сркэкстраоверрайд
Устанавливает исходный файл дополнительного переопределения.

биндиректори Раздел
Раздел bindirectory определяет двоичное дерево каталогов без специальной структуры. В
Тег scope указывает расположение двоичного каталога, а настройки аналогичны
раздел «Дерево» без переменных подстановки или настроек «Архитектура раздела».

Packages
Устанавливает вывод файла пакетов.

Источники
Устанавливает исходный файл вывода. Требуется хотя бы один из пакетов или источников.

Содержание:
Устанавливает вывод файла содержимого (необязательно).

БинОверрайд
Устанавливает двоичный файл переопределения.

СркОверрайд
Устанавливает исходный файл переопределения.

ЭкстраОверрайд
Устанавливает двоичный файл дополнительного переопределения.

Сркэкстраоверрайд
Устанавливает исходный файл дополнительного переопределения.

Бинкачедб
Устанавливает кэш БД.

Префикс пути
Добавляет путь ко всем путям вывода.

Список файлов, ИсходныйСписокФайлов
Задает файл списка файлов.

BINARY ПЕРЕОПРЕДЕЛЕНИЕ ФАЙЛОВ

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

Общая форма поля сопровождающего:

old [// oldn] * => new

или просто,

new

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

ИСТОЧНИК ПЕРЕОПРЕДЕЛЕНИЕ ФАЙЛОВ

Исходный файл переопределения полностью совместим с dpkg-scansources(1). Он содержит два
поля разделены пробелами. Первое поле - это имя исходного пакета, второе -
раздел, чтобы назначить его.

ЭКСТРА ПЕРЕОПРЕДЕЛЕНИЕ ФАЙЛОВ

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

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

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

--md5, --sha1, --sha256, --sha512
Сгенерируйте заданную контрольную сумму. По умолчанию эти параметры включены, если выключить
в сгенерированных индексных файлах не будет полей контрольной суммы, где это возможно. Конфигурация
Элементы: APT :: FTPArchive ::Контрольная и APT :: FTPArchive ::Индекс::Контрольная в котором Индекс
быть пакетами, источниками или выпуском и Контрольная может быть MD5, SHA1, SHA256 или SHA512.

-d, --дб
Используйте двоичную кэширующую БД. Это не влияет на команду генерации. Конфигурация
Элемент: APT :: FTPArchive :: DB.

-q, --тихий
Тихий; выводит данные, пригодные для ведения журнала, без индикаторов прогресса. Больше q
будет работать тише максимум до 2. Вы также можете использовать -q = # установить тишину
уровень, переопределив файл конфигурации. Элемент конфигурации: тихий.

--удалить связь
Выполните отключение. Если используется параметр "Внешние ссылки", то этот параметр фактически
позволяет отсоединить файлы. По умолчанию он включен, и его можно отключить с помощью
--no-delink. Элемент конфигурации: APT :: FTPArchive :: DeLinkAct.

--содержание
Выполните генерацию содержимого. Когда этот параметр установлен и индексы пакетов
сгенерированный с помощью БД кеша, то список файлов также будет извлечен и сохранен в
БД для дальнейшего использования. При использовании команды генерации этот параметр также позволяет
создание любых файлов содержимого. По умолчанию включено. Элемент конфигурации:
APT :: FTPArchive :: Содержание.

-s, --источник-переопределить
Выберите файл переопределения источника для использования с командой sources. Элемент конфигурации:
APT :: FTPArchive :: SourceOverride.

- только чтение
Сделайте кэширующие базы данных доступными только для чтения. Элемент конфигурации: APT :: FTPArchive :: ReadOnlyDB.

-a, --арх
Принимать в командах пакетов и содержимого только файлы пакетов, соответствующие * _arch.deb или
* _all.deb вместо всех файлов пакетов по заданному пути. Элемент конфигурации:
APT :: FTPArchive :: Архитектура.

APT :: FTPArchive :: AlwaysStat
apt-ftparchive(1) кэширует как можно больше метаданных в cachedb. Если пакеты
повторно скомпилирован и / или повторно опубликован с той же версией, это приведет к проблемам
поскольку будут использоваться устаревшие кэшированные метаданные, такие как размер и контрольные суммы. С этим
опция включена, этого больше не будет, так как будет проверяться, был ли файл
измененный. Обратите внимание, что для этого параметра по умолчанию установлено значение «false», так как не рекомендуется
загрузить несколько версий / сборок пакета с одинаковым номером версии, поэтому теоретически
Ни у кого не будет этих проблем, и поэтому все эти дополнительные проверки бесполезны.

APT :: FTPArchive :: LongDescription
По умолчанию для этого параметра конфигурации установлено значение «истина», и его следует устанавливать в значение «ложь» только в том случае, если
Архив создан с помощью apt-ftparchive(1) также предоставляет файлы переводов. Обратите внимание, что
Мастер-файл Translation-en может быть создан только с помощью команды generate.

-h, --Помогите
Покажите краткую сводку использования.

-v, --версия
Покажи версию программы.

-c, --config-файл
Конфигурационный файл; Укажите файл конфигурации для использования. Программа прочитает
файл конфигурации по умолчанию, а затем этот файл конфигурации. Если параметры конфигурации
необходимо установить до того, как будут проанализированы файлы конфигурации по умолчанию, укажите файл с
АПТ_КОНФИГ переменная окружения. Видеть apt.conf(5) для информации о синтаксисе.

-o, --вариант
Установите параметр конфигурации; Это установит произвольную опцию конфигурации. В
синтаксис -o Foo :: Bar = бар. -o и --вариант можно использовать несколько раз для установки
разные варианты.

ПРИМЕРЫ

Чтобы создать сжатый файл Packages для каталога, содержащего двоичные пакеты (.deb):

apt-ftparchive пакеты каталог | GZIP > Packages.gz

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