Пакетный rar

RAR 3.40
~~~~~~~~
32-разрядная консольная версия
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ
~~~~~~~~~~~~~~~~~~~~~~~~

Введение
~~~~~~~~

RAR - это мощное средство управления архивами.
Консольная версия RAR поддерживает только архивы формата RAR,
обычно имеющие расширение ".rar". Архивы ZIP и прочих форматов
не поддерживаются. Пользователи Windows могут установить
GUI-версию RAR - WinRAR, способную также обрабатывать архивы других
типов.

Некоторые отличительные особенности RAR:

* Оригинальный высокоэффективный алгоритм сжатия данных
* Специальные алгоритмы сжатия, оптимизированные для текстовых,
аудио- и графических данных, а также для 32- и 64-битовых
исполняемых файлов архитектуры Intel
* Лучшая, чем у аналогичных продуктов, степень сжатия при
использовании режима "непрерывного" (solid) архивирования
* Электронная подпись (только в зарегистрированной версии)
* Самораспаковывающиеся (SFX) архивы и тома
* Восстановление физически поврежденных архивов
* Блокировка, шифрование, задание порядка архивирования файлов,
сохранение прав доступа к файлам, меток тома и др.

Файл конфигурации
~~~~~~~~~~~~~~~~~

RAR для UNIX читает информацию о конфигурации из файла .rarrc,
находящегося в домашнем каталоге пользователя (определяется по
переменной окружения HOME) или в каталоге /etc.

RAR для Windows читает информацию о конфигурации из файла rar.ini,
находящегося в том же каталоге, что и файл Rar.exe.

В этом файле может содержаться следующая строка:

switches=<любые ключи RAR, разделенные пробелами>

Переменная окружения
~~~~~~~~~~~~~~~~~~~~

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

Например, в UNIX к вашему профилю можно добавить следующие строки:

RAR='-s -md1024'
export RAR

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

RAR обрабатывает параметры в следующем порядке:

ключи в командной строке высший приоритет
ключи в переменной RAR средний приоритет
ключи в файле конфигурации низший приоритет

Файл протокола
~~~~~~~~~~~~~~

Если в командной строке или файле конфигурации указан ключ -ilog, то при
возникновении ошибок RAR будет записывать сообщения о них в файл
протокола. В UNIX этот файл называется .rarlog и размещается
в домашнем каталоге пользователя. В Windows этот файл называется
rar.log и размещается в том же каталоге, что и файл Rar.exe.
Принимаемое по умолчанию имя файла-протокола можно изменить с помощью
ключа -ilog.

RarFiles.lst - Порядок добавления файлов в непрерывный архив
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

В файле RarFiles.lst находится список файлов, указывающий RAR порядок
добавления файлов в непрерывный архив. В этом файле могут содержаться
имена файлов, шаблоны и специальный элемент - $default, определяющий
место в списке для тех файлов, которые не соответствуют никакому другому
критерию, определенному в RarFiles.lst. Строки, начинающиеся с символа
";", считаются комментариями.

В Windows этот файл должен находиться в том же каталоге, что и RAR,
в UNIX - в домашнем каталоге пользователя или в /etc.

Советы по повышению степени сжатия и скорости выполнения операций:

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

Обычно маски следует располагать ближе к началу списка, чтобы они имели
более высокий приоритет, однако из этого правила есть исключение. Если
rarfiles.lst содержит такие две маски, для которых выполняется условие,
что все файлы, подходящие под первую маску, также подходят и под другую,
то маска, указывающая на меньшее подмножество, будет иметь более
высокий приоритет вне зависимости от её расположения. Например,
при указании масок *.cpp и f*.cpp более высокий приоритет будет у маски
f*.cpp, поэтому расположение в архиве файла 'filename.cpp' будет
выбрано в соответствии с 'f*.cpp', а не с '*.cpp'.

Синтаксис командной строки RAR
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Формат вызова:

RAR <команда> [ -<ключи>... ] <архив> [<@файлы-списки...>] [<файлы...>]
[ <путь_для_извлечения\> ]

Описание

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

Файлы-списки - это обычные текстовые файлы, содержащие имена файлов
для обработки. Каждое имя файла должно быть указано на отдельной строке
и начинаться с первой позиции строки. В файл-список допускается
помещать комментарии, признак начала комментария - символы //.
Например, для архивирования файлов *.txt из каталога c:\work\doc, файлов
*.bmp из каталога c:\work\image и всех файлов из каталога c:\work\misc
можно создать backup.lst, содержащий следующие строки:

c:\work\doc\*.txt //резервная копия текстов
c:\work\image\*.bmp //резервная копия рисунков
c:\work\misc

После этого для архивирования достаточно будет выполнить команду:

rar a backup @backup.lst

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

Консольная Win32-версия RAR в файлах-списках использует OEM (DOS)
кодировку.

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

В среде UNIX символы шаблона (* и ?) нужно заключать в одинарные кавычки,
чтобы они не попадали под обработку RAR. Например, следующая команда
извлечет все ASM-файлы из всех архивов RAR в текущий каталог:

rar e '*.rar' '*.asm'

Команды RAR
-----------

a Добавить файлы в архив

Пример:

rar a myarch

В данном примере создается или обновляется существующий архив
myarch - в него добавляются все файлы из текущего каталога.

c Добавить комментарий к архиву

Комментарии отображаются во время обработки архива. Длина
комментария не должна превышать 62000 байт.

Примеры:

rar c distrib.rar

Комментарии также можно добавлять из файла:

rar c -zinfo.txt dummy

cf Добавить комментарии к файлам в архиве

Эти комментарии отображаются при использовании команды 'v'.
Длина файлового комментария не должна превышать 32767 байт.

Пример:

rar cf bigarch *.txt

cw Записать комментарий архива в указанный файл

Пример:

rar cw oldarch comment.txt

d Удалить файлы из архива

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

e Извлечь файлы в текущий каталог

f Освежить файлы в архиве

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

i[i|c|h|t]=<строка>
Поиск строки в архивах.

Поддерживаются следующие необязательные параметры:

i - не различать прописные и строчные буквы (по умолчанию);

c - различать прописные и строчные буквы;

h - поиск в шестнадцатеричном режиме;

t - использовать таблицы символов ANSI, Unicode и OEM
(только для Win32);

Если ни один параметр не указан, вместо синтаксиса i=<строка>
можно использовать более простую команду i<строка>.

Модификатор 't' допускается применять вместе с другими
параметрами, например, ict=строка выполнит чувствительный к
регистру букв поиск с использованием всех вышеупомянутых таблиц
символов.

Примеры:

1) rar "ic=first level" -r c:\*.rar *.txt

Выполнить регистрозависимый поиск строки "first level" в файлах
*.txt, находящихся в архивах *.rar на диске c:.

2) rar ih=f0e0aeaeab2d83e3a9 -r e:\texts

Найти шестнадцатеричную строку f0 e0 ae ae ab 2d 83 e3 a9 в
архивах RAR, расположенных в каталоге e:\texts.

k Заблокировать архив

Заблокированный архив уже нельзя изменить средствами RAR.

Пример:

rar k final.rar

l[t,b] Просмотреть содержимое архива [с технической информацией]

Отображает список файлов как при использовании команды 'v',
но без путей, т.е. выводятся только имена файлов. Если в
команде присутствует модификатор 't', то будет также
отображена дополнительная техническая информация (базовая ОС,
флаги непрерывного архивирования и старой версии файла).
Модификатор 'b' служит для того, чтобы RAR выводил только
имена файлов без всякой дополнительной информации.

m[f] Переместить в архив [только файлы]

После успешного завершения операции архивирования добавленные в
архив файлы и каталоги удаляются с диска. Если используется
модификатор 'f' и/или ключ '-ed', то будут удалены только
файлы, а каталоги (пустые) останутся на диске.

p Извлечь (распечатать) файл на стандартное устройство
вывода (stdout)

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

r Восстановить архив

Восстановление архива выполняется в два этапа. Сначала
поврежденный архив сканируется на наличие информации для
восстановления (см. команду 'rr'). Если в архиве есть
информация для восстановления, а поврежденная часть данных
непрерывна и имеет размер меньше, чем N*512 байт (где N -
количество имеющихся в архиве секторов с информацией для
восстановления), то шансы на успешное восстановление очень
высоки.

По завершении этого этапа создается новый архив с именем
fixed.arcname.rar, где 'arcname' - имя исходного (повреждённого)
архива.

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

По завершения этого этапа создается реконструированный архив
с именем rebuilt.arcname.rar, где 'arcname' - имя исходного
архива.

Версия RAR/DOS32 вместо вышеупомянутых имён использует имена
_recover.rar и _reconst.rar.

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

Подозрительный элемент

Имя: <возможное имя файла>
Размер: <размер> Размер в архиве: <упакованный размер>

Добавить в архив? Да/Нет/Все

Ответьте 'Да' (Y), чтобы добавить этот элемент в fixed.arcname.rar.

Пример:

rar r buggy.rar

rc Воссоздать отсутствующие или повреждённые тома многотомного
архива с помощью томов для восстановления (файлов .rev)

В качестве имени архива нужно указать имя любого имеющегося
тома, например:

rar rc backup.part03.rar

Информацию о томах для восстановления см. в описании команды 'rv'.

rn Переименовать файлы в архиве

Синтаксис команды:

rar rn <архив> <исх_имя1> <рез_имя1> ... <исх_имяN> <рез_имяN>

Например, следующая команда:

rar rn data.rar readme.txt readme.bak info.txt info.bak

служит для переименования файла readme.txt в readme.bak и файла
info.txt в info.bak в архиве data.rar.

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

rar rn data.rar *.txt *.bak

переименует все *.txt файлы в файлы *.bak.

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

rr[N] Добавить информацию для восстановления

В архивы можно добавлять необязательную избыточную информацию
для восстановления (защитную запись). Она немного увеличивает
размер архива, однако может помочь при восстановлении архива,
поврежденного в результате сбоя дискеты или другой потери
данных. Информация для восстановления может содержать до 524288
секторов. Количество секторов можно задавать явно командой 'rr'
(N = 1, 2 .. 524288). Если этот параметр не указан, то размер
выбирается автоматически и составляет около 1% от общего объема
архива, что обычно позволяет восстановить последовательно
поврежденные данные длиной до 0,6% от общего объема архива.

Кроме того, можно указывать размер информации для восстановления
в процентах от объема архива. Для этого просто добавьте знак
процента к параметру команды, например:

rar rr3% arcname

Обратите внимание, что если эту команду требуется вызвать из
пакетного файла (.bat или .cmd), то нужно указывать не rr3%, а
rr3%%, так как командный процессор воспринимает одиночный символ
'%' как начало параметра пакетного файла. Вместо символа '%'
допускается использовать латинскую букву 'p'. Например, команда
'rr3p' также будет правильной.

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

Примерный размер информации для восстановления можно определить
по формуле:
<размер архива>/256 + <число секторов восстановления>*512 байт

rv[N] Создать тома для восстановления (файлы .rev)

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

rar rv3 data.part01.rar

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

Каждый том для восстановления способен воссоздать один
отсутствующий или повреждённый том RAR. Например, если архив
состоит из 30 томов и для него создано 3 тома для
восстановления, то вы сможете воссоздать любые 3 отсутствующие
тома. Если файлов .rev меньше, чем отсутствующих томов, то
реконструкция архива невозможна. Общее количество обычных томов
и томов для восстановления не может превышать 255.

Необязательный параметр <N> указывает, сколько должно быть
создано томов для восстановления, и он должен быть меньше, чем
общее количество обычных RAR-томов. Если следом за этим
числовым параметром указать символ процента (%), то количество
создаваемых томов для восстановления будет вычисляться как
указанный процент от общего числа томов RAR-архива. Например:

rar rv15% data.part01.rar

RAR воссоздает отсутствующие тома либо по команде 'rc', либо
автоматически при распаковке, если он не находит следующий том,
но обнаруживает необходимое количество rev-файлов.

Перед реконструкцией повреждённые тома переименовываются
в *.bad. Например, volname.part03.rar будет переименован в
volname.part03.rar.bad.

s[имя] Преобразовать архив в самораспаковывающийся (SFX)

Эта команда добавляет в начало файла архива SFX-модуль (если
имя модуля не указано, то будет добавлен модуль из файла
Default.sfx, иначе добавляется модуль, указанный как аргумент
этой команды). В версии RAR для Windows файл Default.sfx должен
находиться в том же каталоге, что и Rar.exe, в версии для UNIX
- в домашнем каталоге пользователя, в /usr/lib или в
/usr/local/lib.

s- Удалить SFX-модуль из уже существующего самораспаковывающегося
архива

В результате выполнения этой команды создается новый
архив без SFX-модуля. Исходный SFX-архив не удаляется.

t Протестировать файлы в архиве

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

Примеры:

Протестировать архивы в текущем каталоге:

rar t *
или для UNIX:
rar t '*'

Можно протестировать архивы во всех подкаталогах, начиная
с текущего:

rar t -r *
или для UNIX:
rar t -r '*'

u Обновить файлы в архиве

Добавляет файлы, которых еще нет в архиве, и обновляет только
те файлы в архиве, версии которых на диске новее, чем в архиве.

v[t,b] Вывести подробный список содержимого архива [с технической
информацией]

Отображаются следующие сведения о файлах: полное имя,
комментарий файла, размер (несжатый и в архиве), степень сжатия,
дата и время последнего изменения, атрибуты, CRC, метод сжатия
и минимальная версия RAR, необходимая для извлечения. Если
указан модификатор 't', то также будет отображена дополнительная
техническая информация (наличие информации для восстановления,
ОС, в которой был создан архив, флагов непрерывного архивирования
и старой версии файла).
Модификатор 'b' служит для того, чтобы RAR выводил только
имена файлов без всякой дополнительной информации.

Чтобы просмотреть содержимое всех томов архива, укажите вместо
расширения архива звездочку ('*') или используйте ключ '-v'.

Примеры:

1) Вывести список содержимого архива system.rar (с техническими
подробностями) и перенаправить вывод в файл techlist.lst

rar vt system >techlist.lst

2) Вывести список содержимого архива tutorial.rar (в режиме
показа одних только имен файлов)

rar vb tutorial

x Извлечь файлы с полными путями

Пример:

rar x -av- -c- dime 10cents.txt

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

Ключи RAR (используются вместе с командами)
-------------------------------------------

-? Вывести справочную информацию о командах и ключах

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

-- Прервать дальнейший поиск ключей

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

Пример:

rar a -s -- -StrangeName

В данном примере все файлы из текущего каталога добавляются в
непрерывный архив с именем -StrangeName.

-ac Снять атрибут "Архивный" у файлов после их архивации или
извлечения (только в версии RAR для Windows)

-ad Добавить к пути назначения имя архива

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

Пример:

rar x -ad *.rar data\

Здесь при извлечении RAR будет создавать в каталоге 'data'
подкаталоги для каждого распаковываемого архива.

-ag[формат]
Добавить к имени архива текущие дату и время

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

По умолчанию принимается формат "YYYYMMDDHHMMSS", который можно
переопределить с помощью параметра 'формат' этого ключа.
Допускается использовать следующие символы:

Y год
M месяц
MMM месяц в виде строки (Jan, Feb и т.д.)
W порядковый номер недели (неделя начинается с понедельника)
A номер дня недели (понедельник - 1, воскресенье - 7)
D день месяца
E номер дня в году
H часы
M минуты (обрабатывается как минуты, если стоит после часов)
S секунды
N номер архива (RAR ищет уже существующий архив со
сгенерированным именем, и если таковой обнаруживается,
то увеличивает номер архива, чтобы сгенерировать
уникальное имя)

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

Строка формата может содержать необязательный текст,
заключённый в фигурные скобки '{' и '}'. Этот текст будет
вставлен в имя архива.

Все остальные символы добавляются к имени архива без изменений.

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

Примеры использования форматов:

1) Стандартный формат YYYYMMDDHHMMSS:

rar a -ag backup

2) Формат DD-MMM-YY:

rar a -agDD-MMM-YY backup

3) Формат YYYYMMDDHHMM, причем дата помещается перед 'backup':

rar a -ag+YYYYMMDDHHMM backup

4) Формат YYYY-WW-A с полями описания:

rar a -agYYYY{год}-WW{неделя}-A{день_недели} backup

5) Формат YYYYMMDD и номер архива. Это позволяет генерировать
уникальные имена, даже если маска формата YYYYMMDD
используется более раза в день:

rar a -agYYYYMMDD-NN backup

-ao Добавить файлы с установленным атрибутом "Архивный"
(только в версии RAR для Windows)

Пример:

rar a -r -ac -ao f:backup c:\*.*

В данном примере в архив f:backup добавляются все файлы
с диска C:, имеющие установленный атрибут "Архивный", после
чего этот атрибут у всех добавленных файлов будет снят.

-ap Задать путь внутри архива

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

Например, если вы хотите добавить файл 'readme.txt' в каталог
'DOCS\ENG' архива 'release', то выполните команду:

rar a -apDOCS\ENG release readme.txt

Если же вы хотите извлечь ENG в текущий каталог, то наберите:

rar x -apDOCS release DOCS\ENG\*.*

-as Синхронизировать содержимое архива

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

Например, после команды:

rar a -u -as backup sources\*.cpp

в архиве 'backup.rar' останутся только файлы *.cpp из каталога
'sources', а все остальные будут удалены. Это напоминает
создание нового архива, но за одним важным исключением:
если после прошлой архивации файлы не изменялись, то
операция будет выполнена значительно быстрее, чем
создание нового архива.

-av Добавить электронную подпись (доступно только в зарегистрированной
версии RAR)

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

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

Во время извлечения, тестирования, просмотра содержимого или
обновления архива с ключом '-av' RAR будет выполнять проверку
целостности подписи и выводить сообщение:

Проверка электронной подписи ...

Если проверка прошла успешно, то будет выведено сообщение 'Ok',
имя создателя архива и время последнего обновления. В случае
обнаружения ошибки при проверке электронной подписи будет
выведено сообщение 'ОШИБКА'.

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

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

-av- Отключить проверку или добавление электронной подписи

-cfg- Игнорировать файл конфигурации и переменную окружения

-cl Преобразовывать имена файлов в нижний регистр

-cu Преобразовывать имена файлов в верхний регистр

-c- Не показывать комментарии

-df Удалить файлы после архивирования

Перемещает файлы в архив. При использовании вместе с командой
'a' этот ключ выполняет то же действие, что и команда 'm'.

-dh Открывать совместно используемые файлы