jigdo-file - Онлайн в облаке

ПРОГРАММА:

ИМЯ

jigdo-file - Подготовить файлы для загрузки Jigsaw (раздача огромных файлов, например CD
изображений).

СИНТАКСИС

jigdo-файл КОМАНДА
[ --image =cdrom.iso ] [ --jigdo =cdrom.jigdo ] [ --template =cdrom.template ] [ --сила ] [
Подробнее ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ ] [ FILES ... | --files-from =f ]
Общий КОМАНДЫ: сделать шаблон, сделать образ, проверить

ОПИСАНИЕ

Jigsaw Download, или короткое jigdo, - это схема, разработанная в первую очередь для того, чтобы упростить
распространять огромные образы файловой системы (например, образы CD (ISO9660) или DVD (UDF)) по
Интернет, но его также можно использовать для других данных, которые неудобно обрабатывать из-за
размер, например аудио / видео файлы или большие программные пакеты.

jigdo пытается гарантировать, что большой файл (всегда вызываемый изображение с этого момента) загружается
небольшими частями, которые можно хранить на разных серверах. Люди, которые хотят скачать
изображение сделайте это, сказав Jigdo(1) (НЕ ВЫПОЛНЕНО ПОКА ЧТО) скачать инструмент для обработки одного
`.джигдо' файл; используй это, Jigdo загружает части и повторно собирает образ. jigdo-файл
используется для подготовки файлов к загрузке.

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

Например, если вы хотите распространить образ ISO9660, который содержит снимок
FTP-сервер, вы можете проинструктировать jigdo-файл подготовить данные для загрузки таким образом, чтобы
когда люди используют Jigdo скачать изображение, Jigdo фактически извлекает отдельные файлы
с FTP-сервера и собирает их в точную копию вашего образа - во время
скачать! (Если образ не является дампом файловой системы, вы можете использовать раскол(1) для создания небольшого
части, из которых будет собираться изображение.)

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

Раздел «ДЕТАЛИ» ниже содержит технические подробности о том, как работает jigdo. ПРИМЕРЫ
В разделе перечислены несколько распространенных сценариев, которые могут помочь вам понять, что такое jigdo
полезно для.

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

Многие параметры относятся к конкретному КОМАНДА; приведенные ниже являются общими или используются
несколько команд. Дополнительные параметры перечислены ниже с отдельными командами. Все
параметры автоматически игнорируются, если они не применимы к текущей команде. Для любой
БАЙТОВ параметров к опциям, вы можете добавить одну из букв `k ',` M' или `G 'к
количество, которое вы указываете, чтобы указать килобайты, мегабайты или гигабайты.

-h --Помогите
Выведите краткую сводку команд и параметров.

-H --help-all
Вывести полную сводку команд и опций.

-v --версия
Версия выходной программы.

-i --image =cdrom.iso
Укажите расположение файла, содержащего изображение. Изображение - это большой файл,
вы хотите распространять.

-j --jigdo =cdrom.jigdo
Укажите расположение файла описания Jigsaw Download. Файл jigdo - это
удобочитаемый файл, созданный jigdo-файл, куда вы добавляете информацию обо всех
серверы, на которые вы собираетесь загружать файлы. Jigdo загрузит этот файл как
первый шаг получения изображения.

-t --template =cdrom.template
Укажите расположение файла "шаблона" изображения. Файл шаблона представляет собой двоичный файл
Сгенерированно с помощью jigdo-файл, он содержит информацию о том, как собрать изображение и
также (в сжатом виде) все данные с изображения, которые не были найдены ни в одном из
части.

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

В большинстве случаев вам нужно будет указать только один из -i -j -tпотому что любой
отсутствующие имена файлов будут выведены из указанного вами. Это делается сначала
удаляя любое расширение из предоставленного имени и затем ничего не добавляя (если
выведение --изображение), `.джигдо'или `.шаблон'.

-r --report = default | noprogress | quiet | grep
Контролируйте, насколько многословна программа и какой формат имеет вывод: Нет прогресса is
так же, как по умолчанию за исключением того, что сообщения о ходе выполнения «x% done» не печатаются. тихий
ограничивает вывод абсолютно необходимым, в основном сообщениями об ошибках. GREP
только отличается от по умолчанию для сделать шаблон команда: Включает вывод в
простой ` 'формат, который полезен при поиске двоичных файлов
в других двоичных файлах.

-f --сила
Перезаписывать существующие выходные файлы без жалоб.

- нет силы
Эта is домен по умолчанию. Отказаться от перезаписи существующих файлов вывода.

-c --cache =jigdo-cache.db
jigdo-файл обычно требуется прочитать все содержимое всех FILES вы указываете.
Если вы используете его неоднократно (например, потому что вы ежедневно делаете новый образ компакт-диска),
кэширование файловой информации значительно увеличит скорость работы программы. В
файл кеша создается автоматически, если его еще нет. Данные обычно оба
прочитал и написал в него.

--без кеша
Эта is домен по умолчанию. Не используйте кеш.

--cache-expiry =СЕКУНД
Установите максимальный возраст записей кеша. Любые записи старше этого будут удалены из
кеш. По умолчанию 30 дней. Вы можете добавить одну из букв `h ',` d', `w ',
«m», «y» для обозначения часов, дней, недель, месяцев или лет соответственно. Ценность
«0» или «выкл» отключает истечение срока, так что все записи остаются в кеше навсегда.
См. Раздел «КЭШ-ФАЙЛЫ» ниже для получения дополнительной информации.

--readbuffer =БАЙТОВ
Установить размер внутренних буферов. По умолчанию 128k - если у вас быстрый диск,
увеличение этого значения может сделать jigdo-файл быстрее, но в целом изменение
не обязательно.

--md5-размер-блока =БАЙТОВ
неинтересный в нашей внутренней среде, Параметр. Установить размер блоков, в которые помещаются файлы.
подразделяется. По умолчанию 128k. Если вы его измените, любой файл кеша должен быть
регенерированный. Внутри, jigdo-файл может выбрать немного больше или меньше
значения.

-T --files-from =файл
Прочитать имена файлов и каталогов из указанного файла. Если файл это `- ', читать имена
со стандартного ввода. Каждая строка в файле воспринимается как имя, поэтому имена могут
содержат пробелы, но не символы новой строки. Пустая строка вызывает jigdo-файл , чтобы остановить
чтение из файла.

найдите(1) - мощный инструмент для создания списков файлов, но обязательно используйте `найдите
Типа f'если возможно - в противном случае, если вы проинструктируете найдите для вывода как имени файла
и символическую ссылку на это имя файла, jigdo-файл дважды прочитает содержимое файла.

--шестнадцатеричный Выводить контрольные суммы в шестнадцатеричном формате вместо формата, подобного Base64. Этого не должно быть
используется с сделать шаблон команда, потому что результирующий `.джигдо'файл нарушает
`.джигдо' формат файла. Его предполагаемое использование - сделать jigdo-файл более интероперабельный
с другими утилитами оболочки Unix, такими как md5sum(1).

- без шестнадцатеричного
Эта is домен по умолчанию. Используйте кодировку контрольных сумм, подобную Base64, в jigdo.

--debug [= помощь | = все | =БЛОК, ~ БЛОК ... ]
Включить или выключить отладочный вывод. Просто «--debug» эквивалентно «--debug = all».
Аргумент представляет собой список разделенных запятыми имен модулей, для которых выводится отладочная информация.
для включения или отключения, если перед именем стоит символ `~ '. Специальное имя `все '
означает все единицы. По умолчанию отладочный вывод отключен, кроме блоков
"утверждать" и "общие". Точный список доступных модулей, для которых возможна отладка.
включаться зависит от того, был ли jigdo скомпилирован с поддержкой отладки -
список можно распечатать с помощью `--debug = help '.

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

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

КОМАНДЫ

Имя команды - это первый аргумент, не являющийся опцией, переданный в jigdo-файл. Большинство команд имеют
короткие сокращения, а также длинные имена. Ассоциация короткие команду имена должен не be используемый in
скрипты - там май be несовместимый изменения в их in домен будущее!

СОЗДАТЬ ШАБЛОН, MT
Читает изображение и FILES, создает `.джигдо'и `.шаблон'. Это основная функциональность
jigdo-файл.

Можно указать оба --image = - и --files-from = -. В этом случае сначала список
файлов читается со стандартного ввода до тех пор, пока не встретится пустая строка. Все
Предполагается, что за ним следуют данные изображения. Это может быть полезно, если вы используете мкисофс(1) или
аналогичные программы, которые могут выводить полное изображение на свой стандартный вывод, потому что
нет необходимости временно хранить образ на диске.

Если FILES аргумент содержит символы `// '(Unix) или` \. \' (Windows), это имеет
особое значение. В окончательном файле jigdo, который загрузят пользователи, каждая из частей
упоминается в разделе «[Parts]» с URI вида «Label: some / filename». (Видеть
Подробное описание приведено ниже в `FORMAT OF .JIGDO FILES '.) В разделе` [Servers]'
отображение меток на серверы в Интернете с такими строками, как
`Метка =http://myserver.org/jigdofiles/'. Используя эту информацию, Jigdo создаст
окончательный URI загрузки для части, `http://myserver.org/jigdofiles/some/filename'.
Указание `// '(или` \. \') В имени файла или каталога служит для `` отсечения '' имен в
правильный уровень каталога. Например, если путь Unix одного из ваших FILES is
`/ path / some / filename ', вы можете сказать jigdo-файл отрезать после `/ path ', передав его
аргумент `/ path // some / filename 'или` / path //', если вы хотите просканировать весь каталог.
Имена путей не обязательно должны быть абсолютными; `somedirectory // 'также возможно.

--метка Метка = / путь
Укажите имя, которое будет использоваться в качестве имени метки для пути на диске. (Влияет на вывод
jigdo файла.) Если вы использовали `// 'в FILES аргументы, как описано выше, jigdo-файл
по умолчанию автоматически выбирает имена меток («A», «B» и т. д.). С этой опцией
вы можете давать ярлыкам более значимые имена. Обратите внимание, что название ярлыка будет только
используется, если один или несколько FILES начинаются с `/ путь // '.

Попробуйте использовать названия ярлыков, которые начинаются с заглавных букв, чтобы устранить неоднозначность.
ясно из таких имен протоколов, как `http ',` ftp'.

--ури Этикетка =http://some.server.org/
По умолчанию, используя --метка как описано выше, вызовет строки формы
`Label = file: / path / 'для записи в раздел` [Servers]' выходного jigdo
файл. Если вы хотите переопределить URI `file: 'так, чтобы строка читалась
`Метка =http://some.server.org/', вы можете сделать это, указав --ури вместе с
--метка. Отдавать просто --ури Этикетка = ... без соответствующего --метка Этикетка = ...
не имеет никакого эффекта, и даже если вы укажете и то, и другое, запись добавляется только в
Раздел «[Серверы]», если на метку ссылается хотя бы одна запись «[Части]».

Предоставленное значение не указывается программой; если он содержит такие символы, как
пробел или любой из символов # "'\, то вы должны заключить его в кавычки. (В Unix вы можете
необходимо дважды заключить значение в кавычки, чтобы защитить его от оболочки, например \\\\ или '\\'
чтобы получить в URI одну обратную косую черту.)

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

Пользователи версии Windows могут заметить, что разделители каталогов `\ '
преобразованы в `/ 'в URI` file:', которые генерируются по умолчанию. Готово
для увеличения кросс-платформенной совместимости файла: - печать-отсутствует командование
версия для Windows автоматически преобразует символы при печати
URI. Если вы предоставляете свой собственный URI `file: 'под Windows, используя --ури, Вы должны
также поменять местами `/ 'и` \'.

-0 в -9
Установите степень сжатия в выходном файле шаблона, начиная с -0 (без сжатия) до
-9 (максимальное сжатие). По умолчанию -9, что может сделать генерацию шаблона
довольно медленно. По умолчанию используемый алгоритм сжатия такой же, как и для GZIP(1).

--gzip и --bzip2
Выберите алгоритм сжатия gzip или bzip2. По умолчанию - gzip.
Bzip2 обычно дает лучшую степень сжатия, но сжатие значительно
медленнее, чем с gzip.

--мин-длина =БАЙТОВ
Установите минимальную длину детали для jigdo-файл искать это на изображении. В
по умолчанию 1к. Детали меньшего размера никогда не будут обнаружены на изображении, поэтому их
данные будут включены в файл шаблона. Используемый алгоритм поиска требует наличия таких
минимальная длина, иначе создание шаблона может стать очень медленным. если ты
точно знаю, что все твои FILES больше определенной суммы, вы можете
недавнее увеличение jigdo-файлнемного, указав количество с помощью этой опции.
Существует фиксированный абсолютный минимум 256 байтов - все, что ниже, будет беззвучно.
быть установлен на 256.

--merge =ФАЙЛОВ
Включите содержимое ФАЙЛОВ в выводе `.джигдо' файл. Файл может содержать данные
которые вы хотите добавить к выходным данным (например, раздел «[Серверы]» со списком
ваших серверов в качестве записей), или это может быть файл jigdo, полученный ранее выполненным
of jigdo-файл.

Можно указать тот же файл для ввода с помощью - объединить и для вывода с
--джигдо. Однако вам также нужно будет использовать --сила заставить программу перезаписать
старая версия файла jigdo с новой. ФАЙЛОВ может быть "-" для стандартного
вход.

После появления добавить новая информация в предоставленном файле, jigdo-файл не будет вставлять новые
строки в раздел `[Parts] ', если запись для той же контрольной суммы MD5 (но не
обязательно с тем же URI!) уже существует, и он не будет вставлять новые строки
в раздел «[Серверы]», если полностью идентичная запись уже существует.

После появления чтение in существующий ФАЙЛОВ, поведение немного другое: Программа
сохраняет записи в разделе `[Parts] 'с одинаковой контрольной суммой, но разными
URI. Для полностью идентичных записей (та же контрольная сумма и URI) только одна запись
сохранены, а дубликаты удалены. Остался раздел «[Серверы]»
нетронутый.

--image-раздел
Эта is домен по умолчанию. Причины jigdo-файл чтобы добавить раздел «[Изображение]» в «.джигдо'
.

В качестве исключения добавлен новый раздел «[Изображение]». не добавлено, если вы используете - объединить и
файл для слияния содержит раздел «[Image]» со строкой, которая читается как «Template-
MD5Sum = '(конец строки после `='). В этом случае сгенерированные данные шаблона
Значение контрольной суммы MD5 просто добавляется после `= 'первой строки этой формы в
файл - новый раздел «[Image]» не добавляется. Такое поведение полезно
потому что это позволяет вам проходить через - объединить раздел «[Изображение]» с произвольным
содержимого, а затем автоматически добавит контрольную сумму MD5 jigdo-файл,
в разделе «ФОРМАТ ФАЙЛОВ .JIGDO» ниже объясняется содержание раздела «[Изображение]» в
подробнее.

--нет-изображения-раздел
Do не включить раздел «[Изображение]» в «.джигдо' файл. Вам нужно добавить один
сами, если вы воспользуетесь этой опцией. Однако сделать это непросто (вам также необходимо
добавьте строку `Template-MD5Sum 'с правильной контрольной суммой, или Jigdo буду жаловаться), так что
использование этой опции не рекомендуется.

--servers-раздел
Эта is домен по умолчанию. Причины jigdo-файл чтобы добавить раздел «[Серверы]» в раздел «.джигдо'
файл. В этом разделе по умолчанию используются URI-адреса `file: ', что позволяет немедленную повторную сборку.
изображения из локальной файловой системы, а также полезно, если вы хотите отредактировать
file вручную и замените URI `file: 'другими URI.

--no-servers-раздел
Do не добавить раздел «[Серверы]» в конец «.джигдо' файл. Полезно, например, если
вы собираетесь добавить в раздел скрипт.

--match-exec =КОМАНДА ОБОЛОЧКИ
Всякий раз, когда файл найден в изображении, выполните предоставленную командную строку,
передавая его в оболочку. jigdo-файл устанавливает ряд переменных среды с помощью
информация о совпадении файла. Например, если файл `/ путь // a / b / файл' было
найденный на изображении, и `Label: a / b / file 'будет записан в`.джигдо'
файл:

· LABEL= "Метка" - Имя метки для файла. В примере предполагается, что `--метка
Label = / path 'был указан вами. При отсутствии такой опции, LABEL будете
быть установленным, но пустым.

· МЕТКАПУТЬ= "/ path /" - путь, соответствующий метке, или другими словами,
префикс пути к соответствующему файлу, который будет не появляются в выводе `.джигдо'
файл. Устанавливается даже без `--метка'вариант присутствует. Заканчивается косой чертой.

· ПУТЬ СОВПАДЕНИЯ= "a / b /" - остальная часть пути без имени листа совпадающего
файл. Пусто или оканчивается косой чертой.

· LEAF= "файл" - конечное имя найденного файла.

· MD5SUM= "lNVdUSqbo2yqm33webrhnw" - md5sum сопоставленного файла в формате Base64.
формат.

· ФАЙЛОВ= "/ path // a / b / file" - Для удобства полный путь к файлу. В
переменная всегда имеет значение $ LABELPATH $ MATCHPATH $ LEAF.

Пожалуйста, будьте осторожны, чтобы правильно заключить строку, переданную в этот параметр, иначе ваш
предоставленная команда не будет работать с именами файлов, содержащими пробелы. Например, чтобы
создать резервную копию жестких ссылок на совпадающие файлы, используйте следующую опцию: --match-
exec = 'mkdir -p "$ {LABEL: -.} / $ MATCHPATH" && ln -f "$ FILE" "$ {LABEL: -.} / $ MATCHPATH $ LEAF"'

По умолчанию никакие команды не выполняются. Используйте --match-exec = "", чтобы удалить командную строку, которая
был установлен с более ранним использованием этой опции.

--жадное сопоставление
Эта is домен по умолчанию. Представьте, что ваше изображение содержит .tar файл, который в свою очередь
содержит другой файл x, и что вы предоставляете .tar и файлы внутри него
в командной строке. Когда jigdo-файл сканирует изображение, обнаруживает начало
.tar файл, а затем файл x.

На этом этапе необходимо принять решение: должен ли файл меньшего размера x быть записано как
совпадение, или его следует игнорировать в пользу большего (и, следовательно, лучшего) совпадения
домен .tar файл? К сожалению, на данный момент не ясно, будет ли
на самом деле быть полным соответствием .tar, поэтому по умолчанию программа предпочитает небольшие
совпадать.

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

СДЕЛАТЬ-ОБРАЗ, MI
Читает `.шаблон' а также FILESсоздает изображение (или `имя_изображения.tmp'). Обеспечивает элементарное
способ пересборки изображений - Jigdo обычно лучше подходит для этой задачи. Однако в
в отличие от Jigdo, нет.джигдо'требуется файл.

Если изображение должно быть записано в файл (а не в стандартный вывод), можно
создать изображение в несколько шагов, с несколькими вызовами `jigdo-файл сделать образ', в виде
следует: вы сначала вызываете jigdo-файл, указав столько файлов, сколько доступно на этом
время. Программа сканирует файлы, и те, что содержатся в изображении, копируются в
временный файл, имя которого формируется добавлением `.tmp'к имени файла изображения.

Для всех других файлов, которые могут быть частями изображения, вы повторяете этот процесс. Как только
поскольку присутствуют все части, временный файл будет немного усечен (чтобы удалить некоторые
административные данные, которые jigdo-файл добавляется в конце) и переименовывается в окончательное изображение
имя. Возможность пересборки образа в несколько этапов особенно полезна для
сбор файлов со съемных носителей, например, с нескольких старых компакт-дисков.

Скрипты с использованием сделать образ может определить, завершено ли создание изображения, проверив
статус выхода: 0 означает успешное создание, а 1 означает, что необходимо
поставляется. Другие ошибки приводят к статусу выхода 2 ("восстанавливаемый", например, файл не найден)
или 3 (без возможности восстановления, например, ошибка записи).

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

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

ПЕЧАТЬ ОТСУТСТВУЕТ, PM
Читает `.джигдо', `.шаблон'и (если есть) `имя_изображения.tmp', выводит список URI еще
нужно было полностью пересобрать образ.

Вместе с сделать образ команда, это обеспечивает большую часть функциональности Jigdo on
командная строка.

Для каждой части, которая еще не присутствует во временном файле образа, контрольная сумма файла равна
искал в разделе `[Parts] 'файла jigdo. Любая метка в соответствующей записи
затем расширяется в соответствии с определениями меток в разделе «[Серверы]» и печатается
на стандартный вывод. Jigdo позволяет указать несколько альтернативных местоположений для каждого
ярлык в этом разделе, но печать-отсутствует будет выводить только первый для каждого отсутствующего
часть.

Если контрольная сумма не может быть найдена в разделе «[Parts]» (этого не должно произойти, если
вы удалили этот раздел), вместо этого выполняется поиск MD5Sum:', как
Jigdo. (Таким образом, если вы хотите избавиться от раздела «[Parts]», вы можете сделать это, если вы
переименуйте каждую часть в свою контрольную сумму.)

--ури Этикетка =http://some.server.org/
Заменить записи в `.джигдо'для любого ярлыка с выбранным вами URI.
В приведенном выше примере запись `[Parts] 'в` Label: some / filename' вызовет
линия `http://some.server.org/some/filename'для печати.

Предоставленное значение не указывается программой; если он содержит такие символы, как
пробел или любой из символов # "'\, то вы должны заключить его в кавычки. (В Unix вы можете
необходимо дважды заключить значение в кавычки, чтобы защитить его от оболочки, например \\\\ или '\\'
чтобы получить в URI одну обратную косую черту.)

ПЕЧАТЬ-ОТСУТСТВУЕТ-ВСЕ, PMA
Так же, как печать-отсутствует, эта команда выводит список URI, необходимых для полного
заново собрать образ. Тем не мение, Найти альтернативные места загрузки печатаются вместо
только один. В выводе URI файла отделяются от URI других файлов с помощью
пустые строки. В --ури опция имеет тот же эффект, что и для печать-отсутствует.

ПРОВЕРЯТЬ, РЕД
Читает изображение (предположительно сгенерированный с помощью сделать образ) и `.шаблон', проверяет правильность
контрольная сумма изображения.

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

СКАНИРОВАНИЕ, SC
Читает все FILES и помещает их в кеш, если они еще не кэшированы. В
--кэш опция должна присутствовать для этой команды.

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

- сканировать весь файл
Немедленно прочтите все содержимое файла и сохраните его в кеше.

МД5СУМ, MD5
Читает все FILES и распечатывает контрольные суммы MD5 их содержимого. Эта команда довольно
похож на md5sum(1), за исключением того, что контрольная сумма выводится в кодировке, подобной Base64, которая
также используется в других местах jigdo-файл.

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

В списке контрольных сумм, выводимом на стандартный вывод, только часть имени файла, следующая за
печатается любой `// '(или` \. \' в Windows). Любой --кэш будет использоваться для запроса файлов '
Контрольные суммы MD5 и / или запись контрольных сумм отсканированных файлов.

СПИСОК-ШАБЛОН, LS
Читает `.шаблон'файл и выводит низкоуровневую информацию об изображении и всех частях
содержащиеся в нем, включая смещение, длину и контрольную сумму.

Вы также можете использовать эту команду с временными файлами изображений (указав что-то вроде
--template = imagename.tmp) - в этом случае вывод также различает части, которые
были записаны в изображение и части, которые не были записаны.

Точный формат вывода может несовместимо меняться между разными версиями jigdo. В
могут быть выведены следующие разные типы строк. have-file встречается только для.tmp'
files, указывая на файл, который уже был успешно записан во временный файл:

в шаблоне смещение в изображении
файл необходимости смещение в изображении файл-md5sum filestart-rsyncsum
иметь файл смещение в изображении файл-md5sum filestart-rsyncsum
информация об изображении длина изображения изображение-md5sum размер rsyncsum

ПОДРОБНЕЕ

Jigsaw Download был создан с учетом формата образов компакт-дисков ISO9660, однако
следующее также применимо ко многим другим форматам файловых систем, а также к архивам tar и
несжатые zip-архивы. Образ компакт-диска содержит информацию для организации
файловая система (заголовок с именем диска и т. д., данные каталога ISO9660, данные расширений, таких как
Joliet или RockRidge, нулевое заполнение) и файлы, содержащиеся на компакт-диске. Важно
свойство, на которое опирается jigdo, заключается в том, что каждый файл хранится в одном непрерывном разделе
изображение; он не делится на две или более частей.

После появления jigdo-файл дается количество файлов, которые могут содержаться в изображении, он обнаруживает
присутствует ли какой-либо из файлов, используя "скользящую контрольную сумму", основанную на той, которая использовалась
by Rsync(1). Полученные данные записываются в файл `.шаблон'файл: Если раздел
изображение не может быть сопоставлено (например, это была информация каталога), данные сжимаются и
написано прямо в шаблон. Однако, если соответствующий файл был найден, его данные будут
опущено в шаблоне. Вместо этого используется только ссылка (контрольная сумма файла MD5).
вставлен в шаблон.

Обратите внимание, что данные шаблона содержат только двоичные данные, они не содержат имен файлов.
или URI, поскольку его нелегко отредактировать в случае, если какое-либо из этих значений необходимо изменить.
Вся эта информация хранится в папке `.джигдо'файл, текстовый файл, в который вы можете добавлять URL
для вашего сервера (ов). Файл jigdo обеспечивает сопоставление каждой контрольной суммы MD5 с одним или несколькими
альтернативные места загрузки для соответствующей части.

Помимо сопоставления сумм MD5 с URI, файл jigdo также содержит указатель URI
в место загрузки файла шаблона. Таким образом, Jigdo нужен только инструмент для скачивания
получить один URI (тот, что у `.джигдо'файл), чтобы иметь возможность скачать и заново собрать
полное изображение.

ФОРМАТ OF .ДЖИГДО FILES

Общий формат файла `.джигдо'файлы следует за файлом `. Начальная'файлы, которые также используются
Проекты Gnome и KDE для некоторых данных. Файл разбит на разделы, каждый из которых
предваряется строкой "[Имя раздела]". Внутри каждого раздела строки имеют вид
Метка = значение. Такие строки ниже также называются "записями". Все `.джигдо'файлы используют UTF-8 как
их кодировка символов.

Комментарии начинаются с символа `# 'и продолжаются до конца строки.
Пробелы игнорируются в начале и конце строки, а также слева и справа от раздела.
имена и знак `= 'в записях. Кроме того, утилиты jigdo разбили текст
значение ввода (то есть часть после `= ') в слова, разделенные пробелами, как и
Оболочка Unix. Для предотвращения этого могут использоваться одинарные '' и двойные "" кавычки, например, URI
содержащие пробелы, разделяются на части. Точно так же символы со специальным значением (
символы '"# \ и пробел / табуляция) должны быть заключены в кавычки с \, чтобы появиться в значении. Как и в случае
оболочки, существует разница между '' и "": внутри '' символы "# \ и
пробелы теряют свое особое значение и становятся обычными символами, тогда как внутри "",
только символы # и пробелы теряют свое особое значение - другими словами,
Обратные косые черты все еще работают внутри "", но не "".

`.джигдо'файлы могут быть сжаты с помощью GZIP(1). jigdo-файл всегда выводит
несжатые файлы, которые можно сжать самостоятельно. джигдо-лайт поддерживает одиночные
несжатые и сжатые файлы.

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

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

Ниже приводится описание имен отдельных разделов, используемых jigdo.

ДЖИГДО РАЗДЕЛ
[Джигдо]
Version = 1.1
Генератор = jigdo-file / 1.0.0

Информация об используемой версии формата файла jigdo и программе, которая
сгенерировал это. Должен быть один такой раздел на `.джигдо' файл.

ОБРАЗ РАЗДЕЛ
[Образ]
Имя файла ="имя файла для экономия on пользователя Посмотреть диск "
Шаблон ="URI в котором в получать шаблон файл"
Template-MD5Sum=OQ8riqT1BuyzsrT9964A7g
ShortInfo =одна линия описание of домен изображение (200 символы Максимум.)
Информация =длинной описание (5000 символы Максимум.)

Значение для записи `Template 'может быть либо URL-адресом (абсолютным, либо относительно URL-адреса).
файла jigdo) или строку вида `этикетка:пути(НЕВЫПОЛНЕННЫЙ), как описано
внизу.

Запись Template-MD5Sum добавлена jigdo-файл и задает контрольную сумму MD5
сгенерировано `.шаблон' файл. Он используется Jigdo для выявления случаев, когда загруженный
данные шаблона повреждены или принадлежат другому изображению.

В отличие от других значений записи, значения записей ShortInfo и Info являются не раскол
до слов, вместо этого все цитаты сохраняются.

Значение записи `Info 'особенное в том, что Jigdo(1) может дополнительно анализировать разметку XML
это содержит. Если в разметке есть ошибки, такие как несбалансированные / неподдерживаемые теги, строка будет
отображается буквально, без разбора XML. Поддерживаемые теги: (жирный),
(курсив), (шрифт пишущей машинки), (подчеркивание), (крупный шрифт),
(меньший шрифт) и (Разрыв строки). Поддерживаемые объекты включают <
(`<'),> (`>') и & (`& '). Обратите внимание, что вся запись `Info 'должна быть в одной строке в
файл jigdo.

Этот раздел может повторяться несколько раз, но все, кроме первого, будут проигнорированы. Этот
полезно, например, при создании файла `.джигдо'файл образа DVD, если у вас уже есть
`.джигдо'файлов для компакт-дисков с одинаковым содержимым: вы можете просто `[Включить]' (см. ниже)
Файлы jigdo компакт-дисков находятся в конце файла jigdo DVD после его раздела «[Image]».

ЧАСТЕЙ РАЗДЕЛ
[Части]
xJNkjrq8NYMraeGavUpllw = LabelA: part0
GoTResP2EC6Lb_2wTsqOoQ = LabelA: part1
kyfebwu6clbYqqWUdFIyaw = LabelB: some / path / part2
-J9UAimo0Bqg9c0oOXI1mQ=http://some.where.com/part3

Все строки в разделе, который обеспечивает сопоставление контрольных сумм MD5 с URI, имеют
тот же формат: Слева от `= 'контрольная сумма (закодированная с помощью Base64-подобного
кодировка), а справа строка, соответствующая части с этим
контрольная сумма; либо полный URI, либо строка вида `этикетка:пути', который
расширен до одного или нескольких URI путем поиска определений для этикетка в
Раздел «[Серверы]».

В случае, если конкретная контрольная сумма MD5 не может быть найдена ни в каком разделе «[Parts]» с помощью Jigdo,
программа выполнит поиск MD5Sum:', например, для
`MD5Sum: xJNkjrq8NYMraeGavUpllw ', если вы удалили строку для` part0' выше.

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

В файле может быть любое количество разделов «[Parts]»; все они считаются, когда
поиск контрольных сумм MD5.

jigdo-файл всегда помещает раздел «[Parts]» в конец файла, и даже
перестраивает любой файл, указанный с помощью - объединить чтобы в конце оставался только один такой раздел. Этот
сделано, чтобы позволить Jigdo для отображения информации из раздела «[Изображение]», пока
остальная часть этого файла все еще загружается.

СЕРВЕРЫ РАЗДЕЛ
[Серверы]
LabelA =http://myserver.org/
LabelA =ftp://mirror.myserver.org/
LabelB = LabelC: подкаталог /
LabelC =http://some.where.com/jigdo/

Все строки в разделе, который обеспечивает отображение меток сервера на сервер
местоположения имеют одинаковый формат: слева от знака `= 'дается имя метки, и
справа значение, до которого нужно расширить имя метки.

Название ярлыка, которое появляется несколько раз в этом разделе, указывает на альтернативную загрузку.
расположение частей, которые имеют метку в разделе «[Parts]». Эта запись делает
добавить зеркала в файл jigdo очень просто.

Как показано в приведенном выше примере, значения меток могут сами ссылаться на другие метки. В
в этом случае запись `LabelB: some / path / part2 'в разделе` [Parts]' расширится до
`http://some.where.com/jigdo/subdirectory/some/path/part2'. Петли в этикетке
определения приводят к неопределенному поведению, и этого следует избегать.

В файле может быть любое количество разделов «[Серверы]»; все они считаются, когда
поиск ярлыков. Любой из `[Parts] 'или` [Servers]', но не оба, могут быть исключены из
файл jigdo.

КОММЕНТАРИЙ РАЗДЕЛ
[Комментарий]
Любой текст, кроме строк, не должен начинаться с символа «[».

Весь текст, следующий за строкой «[Комментарий]» или «[комментарий]», игнорируется, вплоть до следующей строки с
метка раздела.

ВКЛЮЧАЮТ ДИРЕКТИВА
[Включают http://some.url/file.jigdo]

Строки этой формы вызывают загрузку содержимого указанного файла jigdo и
разбирается так же, как и основной файл jigdo. Эффект будет таким же, как при копировании включенного
содержимое файла в файл, содержащий директиву include. (Исключение: любой
относительные URL-адреса всегда разрешаются с использованием URL-адреса `.джигдо'файл, содержащий этот
относительный URL.)

Аргумент URL-адреса может быть абсолютным или относительным URL-адресом. Предполагается, что относительные URL-адреса
относительно URL-адреса файла jigdo, который содержит директиву include. Включает банку
быть вложенными, но создание цикла директив include является ошибкой. это не возможное
использовать URL-адреса формы `этикетка:пути'.

URL-адрес не может заключаться в кавычки "". Любые символы `] 'в аргументе должны быть экранированы как
`% 5D 'и любые пробелы как`% 20'.

Директивы Include поддерживаются только Jigdo, они игнорируются джигдо-лайт.

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

КЭШ FILES

Любой файл, указанный с помощью --кэш опция используется для хранения информации о FILES
представлены jigdo-файл. При запросе кеша файл считается неизменным (и
кэшированные данные используются) только если имя файла, размер файла и время последнего изменения (mtime) совпадают
точно. Для совпадения имени файла используется не все имя файла, а только его часть.
после любого `// ', так что любые изменения в части до` //' не аннулируют
кеш.

Старые записи кэша удаляются из кеша, если они не были прочитаны или записаны в
на время, указанное в --cache-expiry. Записи не немедленно удалили
из кеша, если файл, на который они ссылаются, больше не существует - это позволяет
кэшировать информацию о файлах на съемном носителе.

Только истечение срока действия кеша после jigdo-файл сделал свою основную работу - есть ли старые записи
доступны до истечения срока, они будут сохранены. Например, если программа
запускается со сроком действия по умолчанию 30 дней, но обращается к файлу кеша с записями
сгенерировано 2 месяца назад, затем записи в этом кеше будете считаться, и только те
записи кэша, которые не были нужны во время запуска программы, будут истекать.

Из-за особенностей базовой библиотеки базы данных (libdb3) файлы кеша никогда не
сжимаются, они только растут. Если в вашем кеш-файле истек срок действия большого количества записей и
вы хотите, чтобы он уменьшился, вы можете просто удалить его (конечно, тогда все будет
для регенерации) или используйте утилиты, прилагаемые к libdb3, чтобы выгрузить и восстановить
базу данных с помощью команды типа `db3_dump старый-cache.db | db3_load новый-cache.db'. Для Debian,
эти программы поставляются в пакете libdb3-util.

Если другой --md5-размер блока указан, необходимо перечитать весь файл, чтобы
обновить запись в кэше. Если другой --мин-длина указан, только первый
Необходимо перечитать байты файла md5-block-size.

ПРИМЕРЫ

ПОДГОТОВКА ВАШ CD ОБРАЗ Для РАСПРЕДЕЛЕНИЕ
Вы создали образ компакт-диска `изображение.iso'из некоторых файлов, хранящихся в каталоге
`/ главная / ftp'на жестком диске, который также доступен в Интернете какftp://mysite.org'. В качестве
вы не хотите тратить пространство, эффективно размещая одни и те же данные дважды (один раз в виде файлов на
FTP-сервер, находящийся внутри изображения), и вам надоело, что загрузка пользователей прерывается
после 200 МБ и их перезапуска загрузки десятки раз вы решаете использовать jigdo.
Как подготовить изображение к загрузке?

На самом деле нужна всего одна команда:

jigdo-файл сделать шаблон --image = image.iso --jigdo = / главная / ftp / image.jigdo
--template = / home / ftp / image.template / главная / ftp // --метка Mysite = / home / ftp --ури
Mysite =ftp://mysite.org/

Теперь люди могут указать Jigdo в `ftp://mysite.org/image.jigdo', чтобы загрузить ваше изображение. В
файл шаблона должен быть доступен как `ftp://mysite.org/image.template'.

Обратите внимание, что ничто не мешает вам сделать то же самое для FTP-сервера, который не
администрируется вами - в этом случае вам нужно только разместить `.джигдо'и `.шаблон'
файлы на вашем собственном сервере / домашней странице.

ПОДГОТОВКА AN ПРОИЗВОЛЬНЫЙ БОЛЬШОЙ ФАЙЛОВ Для РАСПРЕДЕЛЕНИЕ
Мы предполагаем, что у вас есть большой файл, не являющийся файловой системой, например `фильм.mpeg'. Потому что
из-за проблем с пространством, вы хотите распределить данные на двух серверах.

В этом случае части изображения нужно сгенерировать искусственно с помощью раскол
команда. Например, чтобы создать блоки размером 4 МБ каждый, используйте `раскол -b 4m фильм.mpeg часть'.
Скопируйте полученные файлы `частьXX'в два каталога `1'и `2'то, что вы создаете,
в соответствии с тем, как вы хотите, чтобы файлы распределялись между серверами. Затем создайте
jigdo и файлы шаблонов сjigdo-файл сделать шаблон --image = movie.mpeg 1 // 2 //'. Ты
нужно будет отредактировать `.джигдо'и укажите правильные URI для двух серверов, которые
вы собираетесь загрузить файл `частьXX'файлы в.

ИНДИВИДУАЛЬНЫЕ ВЕРСИИ OF ИЗОБРАЖЕНИЙ
Поскольку при необходимости можно назначить разные URI для каждой части изображения,
jigdo очень гибкий. Только один пример - возможность кастомизированных версий
images: Предположим, кто-то распространяет образ компакт-диска, и вы хотите сделать несколько
небольшие изменения в нем и распространять свою собственную версию. Вы загружаете файл `официальный .iso' CD
изображение с Jigdo (передавая ему URL-адрес `официальный.jigdo'), запишите его на CD-R, сделайте свой
изменения (скажем, добавление файлов из папки `мои файлы'на жестком диске) и создайте свой
собственная версия,моя версия.iso'. Затем вы инструктируете jigdo-файл создать jigdo и
файлы шаблонов для вашего измененного изображения, используя команду

jigdo-файл сделать шаблон --image = myversion.iso / mnt / cdrom / мои файлы// --метка
Мой = myfiles / --ури Мой =http://my.homepage.net/ --merge = official.jigdo
в то время как `официальный .iso'монтируется под `/ mnt / cdrom'. Используя - объединитьты сказал джигдо-
файл взять содержимое `официальный.jigdo', добавьте к нему новый раздел `[Image]' для
`моя версия.iso'и запишите полученный файл jigdo в `моя версия.jigdo' - а сейчас
`моя версия.jigdo'предлагает два изображения для загрузки: исходную версию и измененную
версия. (Если вы не хотите, чтобы он предлагал официальную версию, отредактируйте ее и удалите
Раздел «[Изображение]», в котором перечислены «официальный .iso».)

Теперь вы можете загрузить файл `.джигдо'файл,.шаблон'файл, а также файлы в `мои файлы'
к `http://my.homepage.net/'. Таким образом, чтобы люди могли загрузить ваше измененное изображение, вы делаете
не необходимо загрузить полное содержимое изображения в ваше веб-пространство, но только те изменения, которые вы
сделал!

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

ОБЪЕДИНЕНИЕ МНОГО УПРАВЛЯЕМЫЙ JIGDO ИЗОБРАЖЕНИЙ INTO ONE
Также не проблема объединить данные из нескольких источников, использующих jigdo. Например, если
пяти разных и не связанных между собой серверов, каждый из которых распространяет разные образы компакт-дисков через
jigdo, вы можете создать собственный образ DVD, содержащий данные со всех этих компакт-дисков.
Когда люди используют Jigdo для загрузки изображения извлекаются отдельные файлы с DVD
из тех же источников, что и оригинальные компакт-диски.

Следовательно, даже если вы будете распространять файл размером 3.2 ГБ через свое веб-пространство,
фактический объем данных, хранящихся на вашем сервере, будет порядка нескольких
МБ.

Используйте jigdo-файл онлайн на сервисах onworks.net