НАЗВАНИЕ

	restore, rrestore — восстановление файлов или файловых систем из бэкапов сделаных
	с помощью утилиты dump

СИНТАКСИС
	restore -i [-dhmNuvy] [-b blocksize] [-f file | -P pipecommand] [-s fileno]
	restore -R [-dNuvy] [-b blocksize] [-f file | -P pipecommand] [-s fileno]
	restore -r [-dNuvy] [-b blocksize] [-f file | -P pipecommand] [-s fileno]
	restore -t [-dhNuvy] [-b blocksize] [-f file | -P pipecommand] [-s fileno] [file ...]
	restore -x [-dhmNuvy] [-b blocksize] [-f file | -P pipecommand] [-s fileno] [file ...]

	rrestore - альтернативное имя для restore
	
	(Синтаксис опций 4.3BSD внесен в программу для обратной совместимости, но
	здесь не документирован)

ОПИСАНИЕ

	Утилита restore производит функции обратные dump'у. Полное резервное копирование 
	файловой системы может быть восстановлено, а отдельные инкрементальные бэкапы 
	развернуты поверх основного бекапа. Одиночные файлы и директории могут быть 
	восстановлены из полных или частичных бекапов. Утилита restore работает по сети;
	для реализации этих возможностей смотрите -f и -P флаги, описанные ниже. Другие
	аргументы команд это файлы и директории, указывающие файлы которые будут 
	восстановлены. 	До тех пор пока флаг -h не будет указан (смотрите ниже), имя
	директории будет появлятся 	с файлами и (рекурсивно) поддиректориями, этой 
	директории.

	Совершенно точно потребуется один из следующих флагов:

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

		add[arg]		Текущая директория или заданный аргумент добавляются к
				списку файлов которые будут извлекатся. Если директория
				указана, тогда директория вместе с содержимым будет 
				добавлена к списку извлечения (если не использовался 
				флаг -h). Файлы находящиеся в списке извлечения содержат
				спереди символ "*", в момент просмотра программой ls.

		cd arg		Изменение текущей рабочей директории

		delete [arg]	Текущая директория или заданый аргумент удаляются из списка
				файлов на извлечение. Если директория указана, тогда она
				вместе с содержимым удаляется из списка файлов на извлечение
				(если не использовался флаг -h). Самый целесообразный способ
				извлечения файлов состоит в том, что бы добавить директорию
				к списку извлечения а затем удалить те файлы которые не
				нужны.

		extract		Все файлы в списке извлечения извлекаются из бекапа. Утилита
				restore спросит какой том пользователь хочет смонтировать.
				Быстрый способ извлечь несколько файлов, состоит в том чтобы
				начать работу с последнего тома, и продолжать до первого.

		help		Список доступных команд

		ls [arg]		Список текущей или заданной директории. Вхождения в
				директорию добавляются символом "/". Вхождения отмеченные
				на извлечение предваряются символом "*". Если флаг
				подробного вывода установлен, номер inode каждой записи
				также указывается.

		pwd		Выводит полный путь текущей директории.

		quit		Завершает работу незамедлительно, даже если список
				извлечения не пуст.

		setmodes		Все директории добавленные в список извлечения имеют
				собственного владельца, права, и время; ничего не
				извлекается из бэкапа. Это полезно для чистки после
				прерывания работы restore.

		verbose		Смысл схож с флагом -v. Когда он установлен, флаг 
				verbose заставляет команду	ls вывести список номеров
				inode для всех записей. Так же он заставляет restore
				вывести информацию о каждом файле который будет извлечен.

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

	-R	Запрашивает часть ленты, многотомного архива, с которой начнется полное
		восстановление (смотрите флаг -f ниже). Полезно, если восстановление было
		прервано.

	-r	Восстановление (создание заново файловой системы). Целевая файловая система
		должна быть сделана ранее с newfs(8), смонтирована, и пользователь должен
		перейти в подготовленную ранее файловую систему прежде чем начнется
		восстановление нулевого уровня из резервной копии. Если уровень 0 восстановлен
		удачно, флаг -r может использоватся для восстановления всех необходимых
		инкрементальных бекапов выше уровня 0. Флаг -r устраняет интерактивное
		извлечение файлов и может являтся вредным для здоровья, если он не будет
		применятся аккуратно. Например:

			newfs /dev/da0s1a
			mount /dev/da0s1a /mnt
			cd /mnt
			restore rf /dev/sa0

		Учтите, что восстановление оставляет файлы restoresymtable в корневой
		директории для пропуска информации между икрементальными проходами
		восстановления. Файл должен быть удален когда последний инкрементальный
		бекап восстановлен. Утилита restore в сочетании с newfs(8) и dump(8),
		может использоватся для модификации параметров файловой системы таких как
		размер или размер блока.

	-t	Имена указанных файлов перечисляются если они присутствуют на бэкапе.
		Если аргументов файла не задано, тогда перечисляется корневая директория,
		которая приводит к перечислению всего содержимого всех директорий бекапа,
		если не был указан флаг -h. Учтите, что флаг -t заменяет функцию старой
		программы dumpdir(8).

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

	Следующие дополнительные опции могут быть определены:

	-b blocksize
		Количество килобайт на запись. Если опция -b не задана, restore попробует
		определить динамически размер блока носителя.

	-d	Посылает подробную отладочную информацию на stderr.

	-f file
		Читает бэкап из файла; файл может являтся специальным файлом устройства как,
		например, /dev/sa0 (ленточный накопитель), /dev/da1c (дисковый накопитель),
		простым файлом, или "-" (стандартный вывод). Если имя файла имеет форму:
		"хост:файл", или "пользователь@хост:файл", restore прочтет названный файл на
		удаленном хосте используя rmt(8)

	-P pipecommand
		Использование popen(3) для запуска строки скрипта sh(1) определенной
		pipecommand как вход для каждого тома. Порожденный stdin pipeline'а (/dev/fd0)
		перенаправляется из входного потока, и переменная окружения RESTORE_VOLUME 
		устанавливается для текущего читаемого номера тома. Скрипт pipecommand 
		запускается каждый раз когда том загружен таким образом, будто он является
		ленточным носителем.

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

	-m	Извлекает только по номерам inode, а не по именам файлов. Это бывает полезно
		только для если нескольких файлов извлекаются, и кто-то не хочет
		восстанавливать полный путь файла.

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

	-s fileno
		Читать с определенного номера файла. Номера файлов начинаются с 1.

	-u	Когда создаете определенные типы файлов, resotore может создавать
		диагностическое предупреждение, если файлы существуют в директории. Для
		предотвращения этого флаг -u (unlink) заставляет restore удалять старые записи
		прежде чем создавать новые.

	-v	Обычно resore выполняет свою работу тихо. Флаг -v (verbose) заставляет
		выводить имя каждого файла

	-y	Не спрашивать пользователя прерывать ил восстановление в случае ошибки. Всегда
		попробуйте пропустить сбойный блок и продолжить.

ОКРУЖЕНИЕ

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

ФАЙЛЫ

	/dev/sa0		ленточный накопитель по умолчанию
	/tmp/rstdir*	файл содержащий директории на ленте
	/tmp/rstmode*	владелец, права, и отметка времени для директорий
	./restoresymtable	информация прошедшая между икрементальными восстановлениями

ДИАГНОСТИКА

	Утилита restore пожалуется, если получит ошибку. Если опция -y была указанна,
	или пользователь ответил "y", restore продолжит восстановление.Если резервное
	копирование было сделано с использованием более одной ленты, restore уведомит
	пользователя когда понадобится смонтировать новый раздел. Если флаги -x или -i
	были указаны, restore также спросит какой том пользователь желает смонтировать.
	Быстрый способ извлечь несоколько файлов это начать с последнего тома и двигатся
	к началу.

	Существуют многочисленные проверки целостности, которые могут быть перечислены
	утилитой restore. Большинство проверок очевидно, либо "никогда не было". Самые
	распространенные перечислены ниже.

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

	<имя файла>: не найден на ленте
		Указанное имя файла присутствует в списке директорий но не найдено на
		ленте. Это вызвано ошибками чтения ленты, во время поиска файла или
		снятия копии на активной файловой системе.

	ожидаемый следующий файл <номер inode>, имеет <номер inode>
		обнаружен файл не указанный в директории. Это может случится, если копия
		снималась на активной файловой системе.

	Инкрементальный бекап слишком мал
		Во время инкрементального восстановления, бекап был записан до предыдущего
		инкрементального бекапа, или был загружен слишком низкий инкрементальный
		уровень

	Инкрементальный бекап слишком высокий
		Во время инкрементального восстановления, бекап не начинается с того места,
		где был закончен предыдущий бекап, или слишком высокий инкрементальный
		уровень был загружен.

	Ошибка чтения ленты во время восстановления <имя файла>
	Ошибка чтения ленты во время пропуска inode <номер inode>
	Ошибка чтения ленты во время попытки ресинхронизации
		Возникла ошибка чтения ленты или другого носителя. Если номер inode был
		пропущен или лента пыталась ресинхронизироватся, то извлеченные файлы не
		будут испорчены, хотя файлы могут быть не найдены на ленте.

	resync restore, пропущено <количество> блоков
		После ошибки чтения бекапа, restore может ресинхронизировать себя. Это
		сообщение выведет список блоков которые были пропущены.

СМОТРИ ТАКЖЕ

	dump(8), mount(8), newfs(8), rmt(8)

ИСТОРИЯ

	Утилита restore появилась в 4.2BSD.

ОШИБКИ

	Утилита восстановления может очень удивится, когда происходят инкрементальные
	восстановления из бекапов сделаных на активной файловой системе без использования
	опции -L (смотрите dump(8)).

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

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

	Временные файлы /tmp/rstdir* и /tmp/rstmode* создаются из уникальных имен, основанных
	на дате сохранения и ID процесса (смотрите mktemp(3)), исключая случаи когда
	используются флаги -r или -R. Поэтому -R позволяет вам перезапустить -r операцию
	которая может быть прервана, временные файлы должны быть такими же, В остальных
	случаях файлы уникальны, потому что можно запустить два разных процесса сохранения в
	одно и тоже время и разделить операции которые не должны конфликтовать друг с другом.