jigdo-file - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

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

СИНТАКСИС

файл jigdo КОМАНДА
[ --зображення=cdrom.iso ] [ --jigdo=cdrom.jigdo ] [ --шаблон=cdrom.template ] [ --сила ] [
БІЛЬШЕ ВАРІАНТИ ] [ ФАЙЛИ ... | --files-from=f ]
загальний КОМАНДИ: зробити шаблон, створити образ, перевірити

ОПИС

Jigsaw Download, або короткий jigdo, — це схема, розроблена в першу чергу для того, щоб полегшити її виконання
поширювати величезні образи файлової системи (наприклад, образи CD (ISO9660) або DVD (UDF)).
Інтернет, але його також можна використовувати для інших даних, які незручно обробляти через його
розмір, як-от аудіо/відео файли або великі пакети програмного забезпечення.

jigdo намагається переконатися, що великий файл (завжди викликається зображення відтепер) завантажується
невеликими частинами, які можна зберігати на різних серверах. Люди, які хочуть завантажити
зображення, зробіть це, сказавши джигдо(1) (НІ РЕАЛІЗОВАНО ЩЕ) завантажте інструмент для обробки
`.jigdo' файл; використовуючи це, джигдо завантажує деталі та збирає зображення. файл jigdo
використовується для підготовки файлів до завантаження.

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

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

Ви можете повністю вибирати, де зберігатимуться окремі частини зображення: вони
може бути в абсолютно різних каталогах на різних серверах (наприклад, через
обмеження пам’яті/пропускної здатності), але це невидимо для людей, які завантажують ваш
зображення. Інформацію про доступні сервери потрібно додати лише до `.jigdo'файл
вами перед розповсюдженням.

Розділ «ДЕТАЛІ» нижче містить технічні відомості про те, як працює jigdo. "ПРИКЛАДИ"
У розділі наведено ряд поширених сценаріїв і може допомогти вам отримати уявлення про те, що таке jigdo
корисно для.

ВАРІАНТИ

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

-h --допомога
Вивести короткий підсумок команд і параметрів.

-H --допомога-всім
Вивести повний підсумок команд і параметрів.

-v -- версія
Вивести версію програми.

-i --зображення=cdrom.iso
Вкажіть розташування файлу, що містить зображення. Зображення – це великий файл
ви хочете поширювати.

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

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

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

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

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

-f --сила
Перезаписуйте наявні вихідні файли без скарг.

--без сили
це is за замовчуванням. Відмовтеся від перезапису існуючих вихідних файлів.

-c --cache=jigdo-cache.db
файл jigdo зазвичай потрібно прочитати весь вміст усіх ФАЙЛИ ви вказуєте.
Якщо ви використовуєте його неодноразово (наприклад, тому що ви робите новий образ компакт-диска доступним щодня),
кешування інформації про файл значно збільшить швидкість роботи програми. The
файл кешу створюється автоматично, якщо його ще немає. Дані зазвичай обидва
читати і записувати до нього.

--без кешу
це is за замовчуванням. Не використовуйте кеш.

--cache-expiry=СЕКУНДИ
Встановити максимальний вік записів кешу. Усі записи, старіші за цей, будуть видалені
кеш. За замовчуванням – 30 днів. Ви можете додати одну з букв `h', `d', `w',
`m', `y' для позначення годин, днів, тижнів, місяців або років відповідно. Значення
`0' або `off' вимикає закінчення терміну дії, тому всі записи залишаться в кеші назавжди.
Дивіться розділ «ФАЙЛИ КЕШУ» нижче для отримання додаткової інформації.

--readbuffer=БАЙТИ
Встановити розмір внутрішніх буферів. За замовчуванням 128k - якщо у вас швидкий диск,
збільшення цього значення може призвести файл jigdo швидше, але в цілому змінюється це
не обов `язково.

--md5-розмір-блоку=БАЙТИ
Нецікаво внутрішній параметр. Встановити розмір блоків, у які розташовуються файли
підрозділяється. За замовчуванням – 128 тис. Якщо ви його зміните, будь-який файл кешу повинен бути
регенерований. внутрішньо, файл jigdo може вибрати трохи більший або менший
value.

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

знаходити(1) є потужним інструментом для створення списків файлів, але обов’язково використовуйте `знаходити
-типу f' якщо можливо - інакше, якщо ви наставляєте знаходити щоб вивести обидва ім’я файлу
і символічне посилання на це ім'я файлу, файл jigdo двічі прочитає вміст файлу.

--шістнадцятковий Вивести контрольні суми в шістнадцятковому форматі замість Base64. Цього не повинно бути
використовується з make-шаблон команду, оскільки отриманий `.jigdo' файл порушує
`.jigdo' формат файлу. Його цільове використання – виготовлення файл jigdo більш сумісний
з іншими утилітами оболонки Unix, наприклад md5сум(1).

--no-hex
це is за замовчуванням. Використовуйте власне кодування контрольних сум jigdo, подібне до Base64.

--debug[=допомога|=всі|=ОДИНИЦЯ,~ОДИНИЦЯ... ]
Увімкнути або вимкнути вихід налагодження. Просто `--debug' еквівалентно `--debug=all'.
Аргументом є розділений комами список імен одиниць, для яких є результат налагодження
бути ввімкненим або вимкненим, якщо перед назві стоїть `~'. Спеціальна назва "все"
означає всі одиниці. За замовчуванням вихід налагодження вимкнено, за винятком одиниць
«стверджувати» і «загальне». Точний список доступних блоків, для яких можна налагодити
бути увімкненим залежить від того, чи був jigdo скомпільований з підтримкою налагодження - the
список можна надрукувати за допомогою `--debug=help'.

ФАЙЛИ Назви файлів або каталогів для використання як вхідних даних. Це ті частини, які є
міститься в зображенні. Якщо одне з імен є каталогом, програма
рекурсивно сканує каталог і додає всі файли, що містяться в ньому. Під час виконання
при цьому він слідує за символічними посиланнями, але уникає циклів символічних посилань.

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

КОМАНДИ

Ім'я команди є першим аргументом без параметра, якому передається файл jigdo. Більшість команд мають
короткі скорочення, а також довгі назви. Команда коротка команда Імена Повинен НЕ be використовуваний in
scripts - там може be несумісні зміни до їх in майбутнє!

ЗРОБИТИ ШАБЛОН, MT
Читає зображення та ФАЙЛИ, створює `.jigdo' і `.шаблон'. Це основна функція
файл jigdo.

Можна вказати і те, і інше --image=- та --files-from=-. У цьому випадку спочатку список
файлів зчитується зі стандартного введення, поки не зустрінеться порожній рядок. Все
після нього вважаються дані зображення. Це може бути корисно, якщо ви використовуєте mkisofs(1) або
подібні програми, які можуть виводити повне зображення на своєму стандартному виводі, тому що
немає необхідності тимчасово зберігати зображення на диску.

Якщо ФАЙЛИ аргумент містить символи `//' (Unix) або `\.\' (Windows), це має
особливе значення. У остаточному файлі jigdo, який користувачі завантажуватимуть, є кожна частина
на який посилається в розділі `[Частини]' з URI у формі `Мітка: деякий/ім’я файлу'. (Побачити
`ФОРМАТ ФАЙЛОВ .JIGDO' нижче для детального опису.) У розділі `[Сервери]' наведено
зіставлення міток із серверами в Інтернеті з рядками, як
`Мітка=http://myserver.org/jigdofiles/'. Використовуючи цю інформацію, джигдо створить
остаточний URI завантаження для частини, `http://myserver.org/jigdofiles/some/filename'.
Вказування `//' (або `\.\') у назві файлу або каталогу служить для `відрізання' імен у
правильний рівень каталогу. Наприклад, якщо шлях Unix одного з ваших ФАЙЛИ is
`/path/some/filename', ви можете сказати файл jigdo обрізати після `/path', передаючи його
аргумент `/path//some/filename' або `/path//', якщо ви хочете перевіряти весь каталог.
Імена шляхів не повинні бути абсолютними; `somedirectory//' також можливий.

--етикетка Мітка=/шлях
Вкажіть ім’я, яке використовуватиметься як ім’я мітки для шляху на диску. (Впливає на вихід
jigdo.) Якщо ви використовували `//' у файлі ФАЙЛИ аргументи, як описано вище, файл jigdo
за замовчуванням автоматично вибирає назви етикеток (`A', `B' тощо). За допомогою цієї опції,
Ви можете дати ярликам більш значущі імена. Зверніть увагу, що буде лише назва мітки
використовується, якщо один або кілька ФАЙЛИ почати з `/path//'.

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

--урі Мітка=http://some.server.org/
За замовчуванням використовується --етикетка як описано вище, викличе рядки форми
`Label=file:/path/' для запису в розділ `[Сервери]' вихідного jigdo
файл. Якщо ви хочете замінити URI `file:', щоб рядок читався
`Мітка=http://some.server.org/', ви можете зробити це, вказавши --урі разом з
--етикетка. Віддавати просто --урі Мітка =... без відповідного --етикетка Мітка =...
не впливає, і навіть якщо ви вкажете обидва, запис додається лише до
Розділ "[Сервери]", якщо на мітку посилається принаймні один запис "[Частини]".

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

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

Користувачі версії Windows можуть помітити, що роздільники каталогів `\' є
перетворюється на `/' в URI `file:', які генеруються за замовчуванням. Це зроблено
для підвищення міжплатформної сумісності `file:' - друк-відсутня командування
версія для Windows автоматично переконвертує символи, коли друкує файл
URI. У випадку, якщо ви надаєте свої власні URI `file:' під Windows, використовуючи --урі, Ви повинні
також обмінюватися `/' та `\'.

-0 до -9
Встановити ступінь стиснення у вихідному файлі шаблону, від -0 (без стиснення) до
-9 (максимальне стиснення). За замовчуванням є -9, який може створити шаблон
досить повільно. За замовчуванням використовується той самий алгоритм стиснення, що і для gzip(1).

--gzip та --bzip2
Виберіть між алгоритмами стиснення gzip і bzip2. За замовчуванням є gzip.
Bzip2 зазвичай дає кращий коефіцієнт стиснення, але стиснення значно
повільніше, ніж із gzip.

--мінімальна довжина=БАЙТИ
Встановити мінімальну довжину деталі для файл jigdo шукати його на зображенні. The
за замовчуванням 1k. Деталі меншого розміру ніколи не будуть знайдені на зображенні, тому їх
дані будуть включені в файл шаблону. Використовуваний алгоритм пошуку вимагає такого
мінімальна довжина, інакше генерація шаблону може стати надзвичайно повільною. Якщо ви
знати напевно, що всі ваші ФАЙЛИ більші за певну суму, ви можете
збільшити файл jigdoТрохи зменшіть швидкість, вказавши суму за допомогою цієї опції.
Існує абсолютний мінімум 256 байт - все, що нижче, буде безшумно
встановити на 256.

--merge=Фото
Включіть вміст Фото у виводі `.jigdo' файл. Файл може містити дані
який потрібно додати до виводу (наприклад, розділ "[Сервери]" зі списком
ваших серверів як записи), або це може бути вихідний файл jigdo за допомогою попереднього запуску
of файл jigdo.

Можна вказати той самий файл для введення з -- об'єднати а для виведення с
--джигдо. Однак вам також доведеться скористатися --сила щоб програма перезаписувалася
стару версію файлу jigdo з новою. Фото може бути `-' для стандарту
Вхід

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

Коли читання in існуючі Фото, поведінка дещо інша: Програма
заповідників записи в розділі `[Частини]' з ідентичною контрольною сумою, але різними
URI. Для повністю ідентичних записів (одна і та сама контрольна сума та URI) є лише один запис
збережено, а дублікати видалено. Залишився розділ "[Сервери]".
незайманий.

--розділ зображення
це is за замовчуванням. Проєкти файл jigdo щоб додати розділ `[Image]' до `.jigdo'
файлу.

Як виняток, новий розділ "[Зображення]". НЕ додається, якщо ви використовуєте -- об'єднати і
файл для об’єднання містить розділ `[Image]' з рядком, який читає `Template-
MD5Sum=' (кінець рядка після `='). У цьому випадку згенеровані шаблонні дані
Значення контрольної суми MD5 просто додається після `=' першого рядка цієї форми
файлу - жодного нового розділу `[Image]' не додається. Така поведінка корисна
тому що це дозволяє вам проходити через -- об'єднати розділ "[Image]" з довільним
вміст, а потім автоматично додавати контрольну суму MD5 файл jigdo,
розділ `FORMAT OF .JIGDO FILES' нижче пояснює вміст розділу `[Image]' в
більш детально.

--no-image-section
Do НЕ включити розділ `[Image]' в `.jigdo' файл. Вам потрібно додати один
себе, якщо ви використовуєте цю опцію. Однак зробити це непросто (вам також потрібно
додати рядок `Template-MD5Sum' з правильною контрольною сумою, або джигдо буде скаржитися), так
використання цієї опції не рекомендується.

--сервери-розділ
це is за замовчуванням. Проєкти файл jigdo щоб додати розділ `[Сервери]' до `.jigdo'
файл. У цьому розділі за замовчуванням використовуються URI `file:', що дозволяє негайне повторне складання
зображення з локальної файлової системи, а також корисно, якщо ви хочете відредагувати файл
файлу вручну та замініть URI `file:' іншими URI.

--no-servers-section
Do НЕ додайте розділ `[Сервери]' в кінці `.jigdo' файл. Корисно, наприклад, якщо
ви збираєтеся додати до розділу сценарій.

--match-exec=КОМАНДА SHELL
Щоразу, коли на зображенні знайдено файл, виконайте наданий командний рядок by
передаючи його в оболонку. файл jigdo встановлює ряд змінних середовища за допомогою
інформація про відповідність файлу. Наприклад, якщо файл `/шлях//a/b/файл' був
знайдено на зображенні, а `Label:a/b/file' буде записано в файл `.jigdo'
Файл:

· LABEL="Label" - назва мітки для файлу. У прикладі припускається, що `--етикетка
Label=/path' ви вказали. За відсутності такої опції, LABEL волі
бути встановленим, але порожнім.

· LABELPATH="/path/" - шлях, що відповідає мітці, або іншими словами,
префікс шляху відповідного файлу, який буде НЕ з’явиться у виводі `.jigdo'
файл. Встановлюється навіть без будь-яких `--етикетка' наявний варіант. Закінчується косою рискою.

· MATCHPATH="a/b/" - решта шляху, без назви аркуша, що відповідає
файл. Порожній або закінчується косою рискою.

· LEAF="file" - ім'я аркуша відповідного файлу.

· MD5SUM="lNVdUSqbo2yqm33webrhnw" - сума md5 відповідного файлу, як у Base64
Формат.

· Фото="/path//a/b/file" - для зручності повний шлях до файлу. The
змінна завжди має значення $LABELPATH$MATCHPATH$LEAF.

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

За замовчуванням жодна команда не виконується. Використовуйте --match-exec="", щоб видалити командний рядок, який
було встановлено з використанням цієї опції раніше.

-- жадібний збіг
це is за замовчуванням. Уявіть, що ваше зображення містить a .Тар файл, який у свою чергу
містить інший файл x, і що ви надаєте обидва .Тар і файли всередині нього
в командному рядку. Коли файл jigdo сканує зображення, воно зустрічає початок
в .Тар файл, а потім файл x.

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

--no-greedy-matching
У випадку, коли присутнє велике часткове збіг, а було коротше
підтверджено, ігноруйте невеликий збіг. (Дивіться варіант вище.)

Зробити зображення, MI
Читає `.шаблон'і ФАЙЛИ, створює зображення (або `imagename.tmp'). Забезпечує рудиментарний
спосіб перескладання зображень - джигдо зазвичай краще підходить для цього завдання. Проте в
контрастує з джигдо, ні `.jigdo' потрібен файл.

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

Для всіх інших файлів, які можуть бути частинами зображення, ви повторюєте цей процес. Як тільки
оскільки всі частини присутні, тимчасовий файл буде трохи скорочено (щоб видалити деякі
адміністративні дані, що файл jigdo додається в кінці) та перейменовано на кінцеве зображення
ім'я. Особливо корисна можливість повторної збірки зображення в кілька кроків
збирання файлів зі знімних носіїв, наприклад, кількох старих компакт-дисків.

Використання скриптів зробити образ може визначити, чи завершено створення зображення, перевіривши
статус виходу: 0 означає успішне створення, тоді як 1 означає, що потрібно більше файлів
надається. Інші помилки призводять до статусу виходу 2 ("відновлюється", наприклад, файл не знайдено)
або 3 (не відновлюється, наприклад, помилка запису).

--check-files
це is за замовчуванням. Щоразу, коли будь-яка частина копіюється в зображення, перевірте її ще раз
контрольну суму проти контрольної суми, що зберігається в шаблоні. Рекомендується вам
залиште це увімкненим, навіть якщо це трохи уповільнює створення зображення.

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

ДРУК-БЕЗПЕЧАЄ, PM
Читає `.jigdo', `.шаблон' і (якщо є) `imagename.tmp', виводить список URI
необхідно для повної збірки зображення.

Разом з зробити образ команди, це забезпечує більшість функцій джигдо on
командний рядок.

Для кожної частини, якої ще немає у файлі тимчасового зображення, є контрольна сума файлу
шукав у розділі `[Частини]' файлу jigdo. Будь-яка позначка у відповідному записі
потім розгортається відповідно до визначень мітки в розділі `[Сервери]' та друкується
на стандартному виході. джигдо дозволяє вказати кілька альтернативних місць для кожного
позначку в цьому розділі, але друк-відсутня виведе лише перший для кожного відсутніх
частина

Якщо контрольну суму неможливо знайти в розділі `[Частини]' (це не повинно статися, якщо
ви видалили цей розділ), замість цього виконується пошук `MD5Sum:', так як
з джигдо. (Таким чином, якщо ви хочете позбутися розділу `[Частини]'), ви можете зробити це, якщо ви
перейменувати кожну частину на власну контрольну суму.)

--урі Мітка=http://some.server.org/
Замінити записи в `.jigdo' для будь-якої мітки з URI на ваш вибір.
У наведеному вище прикладі запис `[Parts]' `Label:some/filename' призведе до
рядок `http://some.server.org/some/filename' для друку.

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

ДРУКУВАТИ-ВІДСУТНО-ВСЕ, PMA
Так само, як друк-відсутня, ця команда виводить список URI, які все ще потрібні повністю
знову зібрати зображення. однак, всі замість них друкуються альтернативні місця завантаження
тільки один. У виводі URI для файлу відокремлюються від URI інших файлів за допомогою
пусті рядки. The --урі опція має той самий ефект, що і для друк-відсутня.

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

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

СКАНУВАТИ, SC
Читає всі ФАЙЛИ і вводить їх у кеш, якщо вони вже не кешовані. The
--кеш для цієї команди має бути присутнім параметр.

--no-scan-whole-file
це is за замовчуванням. Це викликає лише перше --md5-розмір блоку байтів кожного файлу
бути прочитаним. Якщо кеш використовується пізніше файл jigdo зробити образ, решта
файл буде прочитано, як тільки ці перші байти будуть розпізнані у вхідному зображенні.

--сканувати-цілий-файл
Негайно прочитайте весь вміст файлу та збережіть його в кеші.

MD5SUM, MD5
Читає всі ФАЙЛИ і виводить контрольні суми MD5 їх вмісту. Ця команда цілком
схожий на md5сум(1), за винятком того, що контрольна сума виводиться в кодуванні, подібному до Base64
також використовується в інших місцях файл jigdo.

Команда ФАЙЛИ аргументи обробляються так само, як і інші команди, тобто
що рекурсія автоматично виконується для будь-яких аргументів, які є каталогами, і що
символічні посилання не відображаються, за винятком випадків, коли файли, на які вони вказують, недоступні
безпосередньо.

У списку контрольної суми, надрукованому на стандартному виводі, лише частина назви файлу
будь-який `//' (або `\.\' у Windows) друкується. Будь-який --кеш буде використовуватися для запиту файлів'
Контрольні суми MD5 та/або запис контрольних сум відсканованих файлів.

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

Ви також можете використовувати цю команду з тимчасовими файлами зображень (вказавши щось на кшталт
--template=ім'я зображення.tmp) – у цьому випадку вихідні дані також розрізняють частини, які
були записані до зображення та частини, які не були записані.

Точний формат виведення може змінюватися несумісно між різними випусками jigdo. The
можна вивести наступні різні типи рядків. `have-file' зустрічається лише для `.tmp'
файли, що вказує на файл, який уже успішно записаний у тимчасовий файл:

в шаблоні зміщення в зображенні
файл потреби зміщення в зображенні файл-md5sum filestart-rsyncum
мати-файл зміщення в зображенні файл-md5sum filestart-rsyncum
зображення-інформація довжина зображення зображення-md5sum rsyncum-size

ПОДРОБИЦІ

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

Коли файл jigdo надається кількість файлів, які можуть міститися в зображенні, він виявляє
чи є будь-який із файлів із використанням "зобов'язкової контрольної суми", натхненної використаною
by rsync(1). Отримані дані записуються в файл `.шаблон' файл: якщо розділ файлу
зображення не знайдено (наприклад, це була інформація про каталог), дані стискаються і
записується безпосередньо в шаблон. Однак якщо відповідний файл знайдено, його дані є
виключено з шаблону. Натомість є лише посилання (контрольна сума MD5 файлу).
вставлено в шаблон.

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

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

ФОРМАТ OF .JIGDO ФАЙЛИ

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

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

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

(Поведінка, яка може змінитися в майбутньому і на яку не слід покладатися: джигдо
додатково підтримує будь-яку кількість об’єднаних частин відкритого тексту та gzipped у файлах
- наприклад, ви можете стиснути `.jigdo', а потім додайте пару рядків
нестиснені дані до кінця.)

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

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

ДЖІГДО РОЗДІЛ
[Джигдо]
Version = 1.1
Генератор=jigdo-файл/1.0.0

Інформація про версію використовуваного формату файлу jigdo та програму
створив його. Повинен бути один такий розділ на `.jigdo' файл.

IMAGE РОЗДІЛ
[Зображення]
Ім'я файлу="ім'я файлу та цінності економія on user's диск"
Шаблон=«URI де до отримувати шаблон файл"
Template-MD5Sum=OQ8riqT1BuyzsrT9964A7g
Коротка інформація=однолінійний description of зображення (200 символи макс.)
Інформація=довго description (5000 символи макс.)

Значенням для запису "Шаблон" може бути URL-адреса (абсолютна або відносна до URL-адреси).
файлу jigdo) або рядок у формі `етикетка:ім'я шляху'(НЕРЕАЛІЗОВАНО), як описано
нижче.

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

На відміну від інших значень записів, значення записів `ShortInfo' та `Info' є НЕ розкол
у словах, замість цього всі цитування збережено.

Значення запису `Info' є особливим у цьому джигдо(1) може додатково аналізувати XML-розмітку
це містить. Якщо розмітка містить помилки, наприклад незбалансовані/непідтримувані теги, це рядок
відображається буквально, без розбору XML. Підтримувані теги є (жирний),
(курсив), (шрифт друкарської машинки), (підкреслити), (більший шрифт),
(менший шрифт) і (розрив рядка). Підтримувані сутності включають <
(`<'), > (`>') і & (`&'). Зауважте, що весь запис «Інформація» має бути в одному рядку
файл jigdo.

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

ЧАСТИНИ РОЗДІЛ
[Частини]
xJNkjrq8NYMraeGavUpllw=LabelA:part0
GoTResP2EC6Lb_2wTsqOoQ=LabelA:part1
kyfebwu6clbYqqWUdFIyaw=LabelB:деякий/шлях/частина 2
-J9UAimo0Bqg9c0oOXI1mQ=http://some.where.com/part3

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

У випадку, якщо конкретну контрольну суму MD5 неможливо знайти в жодному розділі `[Частини]' джигдо,
програма виконає пошук `MD5Sum:', наприклад для
`MD5Sum:xJNkjrq8NYMraeGavUpllw', якщо ви видалили рядок для `part0' вище.

Контрольна сума, що з’являється кілька разів у цьому розділі, вказує на альтернативне завантаження
місця розташування деталі.

У файлі може бути будь-яка кількість розділів `[Частини]'; всі вони вважаються коли
пошук контрольних сум MD5.

файл jigdo завжди розміщує розділ `[Частини]' в кінці файлу, і це рівномірно
змінює порядок будь-якого файлу, зазначеного за допомогою -- об'єднати мати лише один такий розділ наприкінці. Це
робиться, щоб дозволити джигдо щоб відобразити інформацію з розділу `[Image]', поки
решта цього файлу все ще завантажується.

СЕРВЕРИ РОЗДІЛ
[Сервери]
Мітка A=http://myserver.org/
Мітка A=ftp://mirror.myserver.org/
LabelB=LabelC:підкаталог/
МіткаC=http://some.where.com/jigdo/

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

Назва мітки, що з’являється кілька разів у цьому розділі, вказує на альтернативне завантаження
розташування деталей, які використовують мітку в розділі `[Частини]'. Це позначення робить
дуже легко додати дзеркала до файлу jigdo.

Як показано в прикладі вище, значення мітки можуть самі посилатися на інші мітки. в
у цьому випадку запис "LabelB:some/path/part2" у розділі "[Parts]" розгорнеться до
`http://some.where.com/jigdo/subdirectory/some/path/part2'. Петлі в етикетці
визначення призводять до невизначеної поведінки, і їх слід уникати.

У файлі може бути будь-яка кількість розділів `[Сервери]'; всі вони вважаються коли
пошук етикеток. Будь-яку з `[Частини]' або `[Сервери]', але не обидва, можна опустити з
файл jigdo.

ЯК РОЗДІЛ
[Коментар]
Будь-який текст, за винятком рядків, не повинен починатися з "[".

Весь текст після рядка "[Коментар]" або "[Коментар]" ігнорується, аж до наступного рядка з
етикетка розділу.

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

Рядки цієї форми викликають завантаження вмісту вказаного файлу jigdo і
аналізується так само, як і основний файл jigdo. Ефект буде таким же, як і копіювання включеного
вміст файлу у файл, який містить директиву include. (Виняток: будь-який
відносні URL-адреси завжди вирішуються за допомогою URL-адреси `.jigdo' файл, який містить це
відносна URL-адреса.)

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

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

Директиви включення підтримуються лише джигдо, вони ігноруються джигдо-лайт.

Директива include завершує будь-який попередній розділ, але не розпочинає новий. в
іншими словами, новий розділ завжди повинен починатися після рядка включення, джигдо НЕ
дозволити звичайним записам відображатися під `[Включити]'.

CACHE ФАЙЛИ

Будь-який файл, зазначений у файлі --кеш Опція використовується для зберігання інформації про ФАЙЛИ
представлений до файл jigdo. Під час запиту до кешу файл вважається незмінним (і
використовуються кешовані дані), лише якщо ім’я файлу, розмір файлу та час останньої зміни (mtime) збігаються
точно. Для відповідності імені файлу використовується не повне ім’я файлу, а лише його частина
після будь-якого `//', так що будь-які зміни до частини перед `//' не будуть недійсними
кеш.

Старі записи кешу видаляються з кешу, якщо вони не були прочитані або записані в них
за кількість часу, зазначену с --cache-expiry. Записи є НЕ негайно видалено
з кешу, якщо файл, на який вони посилаються, більше не існує - це дає можливість
кешувати інформацію про файли на знімних носіях.

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

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

Якщо інше --md5-розмір блоку вказано, весь файл потрібно повторно прочитати
оновити його запис кешу. Якщо інше --мінімальна довжина вказано, лише перше
Байти `md5-block-size' файлу потрібно перечитати.

ПРИКЛАДИ

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

Насправді потрібна лише одна команда:

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

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

Зауважте, що ніщо не заважає вам зробити те ж саме для FTP-сервера, який не є
керований вами - у цьому випадку вам потрібно лише розмістити файл `.jigdo' і `.шаблон'
файли на власному сервері/домашній сторінці.

ПІДГОТОВКА AN АРБІТРАЖ LARGE Фото ДЛЯ ПОШИРЕННЯ
Ми припускаємо, що у вас є великий файл, який не є файловою системою, наприклад `фільм.mpeg'. Тому що
через проблеми з простором, ви хочете розподілити дані на двох серверах.

У цьому випадку частини зображення потрібно створити штучно за допомогою розкол
команда. Наприклад, щоб створити фрагменти по 4 МБ кожен, використовуйте `розкол -b 4m фільм.mpeg частина'.
Скопіюйте отримані файли `частинаXX«у два каталоги».1' і `2що ви створюєте,
відповідно до того, як ви хочете, щоб файли розподілялися між серверами. Далі створіть
jigdo та файли шаблонів із `файл jigdo make-шаблон --image=movie.mpeg 1// 2//'. ти
потрібно буде відредагувати файл `.jigdo' та надайте правильні URI для двох серверів, які
ви збираєтеся завантажити файл `частинаXX' файли до.

НАСТАВЛЕНО ВЕРСІЇ OF ФОТО
Оскільки за потреби можна призначити інший URI для кожної частини зображення,
jigdo дуже гнучкий. Лише один приклад - це можливість налаштувань версій
зображення: припустимо, що хтось розповсюджує образ компакт-диска, а ви хочете створити кілька
невеликі зміни до нього та розповсюджуйте свою власну версію. Ви завантажуєте файл `офіційний.iso'CD
зображення за допомогою джигдо (передаючи йому URL-адресу `офіційний.jigdo'), запишіть його на CD-R, зробіть свій
зміни (скажімо, додавання файлів із файлу `мої файли' на вашому жорсткому диску) і створіть свій
власна версія, `myversion.iso'. Далі ви інструктуєте файл jigdo для створення джигдо і
файли шаблонів для вашого зміненого зображення за допомогою команди

файл jigdo make-шаблон --image=myversion.iso /mnt/cdrom/ мої файли// --етикетка
Мої=мої файли/ --урі Мій=http://my.homepage.net/ --merge=official.jigdo
поки `офіційний.iso" монтується під "/mnt/cdrom'. З допомогою -- об'єднати, ви сказали джигдо-
файл взяти вміст `офіційний.jigdo', додайте до нього новий розділ `[Зображення]' для
`myversion.iso' і запишіть отриманий файл jigdo в `myversion.jigdo' - так що тепер
`myversion.jigdo' пропонує два зображення для завантаження, оригінальну версію та вашу модифіковану
версія. (Якщо ви не хочете, щоб він пропонував офіційну версію, відредагуйте її та видаліть файл
Розділ `[Зображення]' зі списком `офіційний.iso'.)

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

(Якщо ви внесли дуже мало змін, ви також можете опустити параметр `myfiles' в
команду вище, тоді всі ваші зміни потраплять у новий файл шаблону.)

КОМБІНІРОВАННЯ БАГАТО КЕРУВАЄТЬСЯ JIGDO ФОТО INTO ONE
Також без проблем об’єднати дані з кількох джерел, які використовують jigdo. Наприклад, якщо
з п’яти різних і не пов’язаних між собою серверів, кожен з яких розповсюджує різні образи компакт-диска через
jigdo, ви можете створити налаштований образ DVD, який містить дані з усіх цих компакт-дисків.
Коли люди використовують джигдо щоб завантажити ваше зображення, завантажуються окремі файли на DVD
з тих самих джерел, що й оригінальні компакт-диски.

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

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