Debmirror

НАЗВАНИЕ

debmirror - сценарий с поддержкой ftp, http, hftp и хранилищ пакетов для создания частичного зеркала Debian

ОБЗОР

debmirror [опции] каталог_копии

ОПИСАНИЕ

Эта программа скачивает и сопровождает частичное локальное зеркало Debian. Она может копировать любое сочетание архитектур, дистрибутивов и разделов. Полностью поддерживается передача файлов по ftp и хранилища пакетов. Она также выполняет блокирование и создаёт файлы, отслеживающие обновления.

Для поддержки хранилищ пакетов эта программа копирует в три этапа.

1. скачивание файлов Packages и Sources	Сначала она скачивает все файлы Packages и Sources для того подмножества Debian, получение которого было указано.
2. удаление неизвестных файлов	Из локальной копии удаляются все файлы и каталоги, не указанные в списке.
3. скачивание всего остального	Файлы Packages и Sources просматриваются в целях создания списка перечисленных в них файлов. К списку добавляются дополнительные файлы. Программа проверяет по списку наличие и актуальность каждого файла, используя для этого размер файла (и, на выбор, md5sum). Скачиваются все необходимые файлы.

ОПЦИИ

каталог_копии	Этот необходимый параметр указывает, где будет находиться каталог локальной копии. Если каталог не существует, он будет создан. Будьте аккуратны! Если вы укажете вместо каталога_копии свой домашний каталог, содержимое вашего домашнего каталога гарантированно будет заменено на копию архива Debian!
–debug	Включить подробный вывод диагностических сообщений, включая копию управляющего соединения протокола ftp.
–progress -p	Отображать индикатор выполнения при скачивании файлов.
–verbose -v	Отображать индикатор выполнения между скачиваниями файлов.
–source	Включать в копию архивы с исходными текстами (по умолчанию).
–nosource	Не включать в копию архивы с исходными текстами.
–md5sums -m	Использовать проверку сумм md5 для определения правильности данных, если файл в локальной копии совпадает по размеру. Опция отключена по умолчанию, поскольку такое поведение излишне параноидально и медленно.
–passive	Скачивать в пассивном режиме.
–host=удалённый_узел -h	Указывает удалённый узел, с которого нужно скачивать файлы. По умолчанию используется узел ftp.debian.org, но очень приветствуется использование ближайшего зеркала.
–user=имя_пользователя -u	Указывает имя пользователя, которое необходимо указать для входа на удалённый узел. Полезно при общении с безумными прокси-серверами. По умолчанию используется имя пользователя anonymous.
–passwd=пароль_пользователя	Указывает пароль пользователя, который необходим для входа на удалённый узел ftp. Опция используется вместе с опцией –user и по умолчанию используется пароль anonymous@.
–method=ftp\|hftp\|http\|rsync -e	Указывает способ скачивания файлов. В настоящее время поддерживаются следующие способы: ftp, hftp (ftp через http-прокси), http или rsync. Для подключения к серверу rsync нужно поместить перед корневым каталогом символ ’:’ (например, :debian, что означает узел::debian).
–proxy=http://пользователь:пароль@узел:порт/	Указывает http-прокси (такой как Squid), который нужно использовать при скачивании файлов по http и hftp.
–timeout=секунды -t	Указывает время ожидания ответа в сетевых соединениях (в ftp или rsync). Укажите большее значение времени ожидания, если скачивание завершается ошибкой. По умолчанию используется время ожидания в 300 секунд.
–root=каталог -r	Указывает каталог на удалённом узле, который является корневым для архива Debian. По умолчанию используется каталог /debian, который подходит для большинства зеркал. В корневом каталоге находится подкаталог dists/.
–dist=один[,другой,..] -d один	Указать дистрибутив (sarge, etch, lenny, sid) Debian для копирования. Этот ключ может использоваться несколько раз, а в одной опции может быть указано несколько дистрибутивов, разделённых запятыми. Использование ссылок (stable, testing, unstable) может привести к неожиданным результатам, но вы можете добавить эти ссылки вручную. По умолчанию копируется sid.
–section=один[,друогй,..] -s один	Указывает раздел Debian для копирования. По умолчанию копируются разделы main,contrib,non-free,main/debian-installer.
–arch=одна[,другая,..] -a одна	Указывает архитектуры процессоров, для которых нужно скачивать двоичные пакеты. По умолчанию используется опция –arch=i386. При указании –arch=none архитектурно-зависимые двоичные пакеты скачиваться не будут.
–postcleanup	Удалить все неизвестные файлы и каталоги в локальной копии только после завершения процесса копирования и только если не было ошибок. Такое поведение используется по умолчанию.
–cleanup	Удалить все неизвестные файлы и каталоги в локальной копии (смотри шаг 2 выше).
–nocleanup	Не удалять неизвестные файлы и каталоги из локальной копии после завершения процесса копирования.
–ignore=регулярное_выражение	Никогда не удалять файлы, чьи имена совпадают с указанным регулярным выражением. Опция может быть указана несколько раз.
–exclude=регулярное_выражение	Никогда не скачивать файлы, чьи имена совпадают с указанным регулярным выражением. Опция может быть указана несколько раз.
–exclude-deb-section=регулярное_выражение	Никогда не скачивать файлы, раздел Debian которых (games, doc, oldlibs, science, …) совпадает с регулярным выражением. Опция может быть указана несколько раз.
–limit-priority=регулярное_выражение	Ограничить скачивание файлами, чьи приоритеты Debian (required, extra, optional, …) совпадают с регулярным выражением. Опция может быть указана несколько раз.
–include=регулярное_выражение	Не исключать файлы, чьи имена совпадают с регулярным выражением. Опция может быть указана несколько раз.
–skippackages	Не скачивать повторно файлы Packages и Sources. Полезно, если вы знаете, что они актуальны.
–adddir каталог	Дополнительно скачивать файлы Packages и Sources из указанного каталога на удалённом узле (каталог относительно корня архива Debian). Если вы в прошлом пользовались опцией вида –adddir dists/proposed-updates, то теперь вы должны воспользоваться опцией следующего вида: –dist <dist>-proposed-updates. Эта возможность в настоящее время устарела и скоро будет удалена.
–getcontents	Скачивать файлы Contents.архитектура.gz.
–max-batch=число	Скачать не более max-batch файлов (и игнорировать оставшиеся).
–rsync-batch=число	Скачивать не более указанного количества файлов при каждом вызове rsync, а затем повторить.
–ignore-missing-release	Не завершить работу с ошибкой, если отсутствует файл Release.
–ignore-release-gpg	Не завершить работу с ошибкой, если отсутствует файл Release.gpg.
–dry-run	Изобразить процесс копирования. При указании этой опции программа по-прежнему будет скачивать файлы метаданных в каталог .temp, но не будет заменять старые файлы метаданных, не будет скачивать файлы deb и архивы с исходными текстами и только лишь изобразит процесс очистки.
–rsync-options=опции	Указать использование альтернативных опций rsync. По умолчанию используются опции -aIL –partial. Нужно соблюдать осторожность при указании альтернативных опций, чтобы не нарушить работу программы. Лучше просто добавить необходимые опции к указанным выше. В большинстве случаев добавляют опцию –bwlimit=x, чтобы избежать забивания канала.
–ignore-small-errors	Обычно debmirror докладывает об ошибке, если не удалось скачать какой либо deb-файл или архив исходных текстов. При этом он не обновляет метаданные, что приводит к нарушению целостности зеркала. В большинстве ситуаций это правильное поведение и оно указывает на то, что во время скачивания произошло что-то плохое и скачивание необходимо повторить. Но некоторые вышестоящие зеркала бывают и в самом деле неисправны. Указание –ignore-small-errors заставит debmirror игнорировать пропущенные или повреждённые deb-файлы и архивы исходных текстов, но по-прежнему будет педантично проверять файлы метаданных.
–pdiff=use\|mirror\|none	Если файл Release содержит записи о файлах pdiff, debmirror попытается обновить файлы Packages и Sources с их помощью, но не включит их в копию. Это поведение применяется по умолчанию и называется ’use’, оно позволяет избежать наличия файлов pdiff для быстрого локального зеркала. Указание –pdiff=mirror включит скачанные файлы в копию. Указание –pdiff=none заставит полностью проигнорировать эти файлы.
–help	Отобразить краткую справку по использованию программы.

http://manpages.ylsoftware.com/ru/debmirror.1.html