ryg

tmutil -утилита Time Machine в Terminal

Синтаксис:

tmutil verb [options]

Описание:

Процедура позволяет управлять и взаимодействовать с Time Machine, проверять и управлять ее резервными копиями. Совместные возможности позволяют восстанавливать данные из архивов, редактировать исключения и сравнивать резервные копии.

Однако некоторые параметры требуют прав супер-пользователя.

Структура архива:

Для понимания работы утилиты, необходимо определить термины используемые в Time Machine, это крайне необходимо для понимания данного материала и правильного использования tmutil

backup source - том, который будет архивироваться;

backup disk - том с файловой системой HFS+ (Mac OS Extended) который содержит резервные копии сделанные Time Machine

backup destination - В случае непосредственного подключения диска для архива к Mac  синоним backup disk, в случае сетевого подключения разделяемый раздел AFP на котором образы архивов.

backup disk image (or backup image) -Узел (sparsebundle), когда диск смонтирован это диск для архивов

backup store    - Папка "Backups.backupdb" в корне backup disk

machine directory - Папка внутри backup store которая содержит все архивы конкретного компьютера. Для локальных подсоединений  backup store может содержать несколько  machine directory  все для разных компьютеров. 

snapshot  - Папка внутри machine directory содержащая внутри себя либо первую резервную копию либо копию одного периодического сеанса архивирования с одного компьютера. Слово snapshot (моментальный снимок) в большинстве случаев является общим термином и его нельзя смешивать с "local Time Machine snapshot" - который означает snapshot, но сохраненный локально на компьютере.

snapshot volume - папка внутри snapshot и содержит начальный или последующий архив одного из backup source.

Параметры

help [параметр] Показать расширенное описание параметра. Если параметр не указан, то напечатать список всех параметров их общее описание.
enable Включить автоматическое архивирование. Требует прав супер-пользователя.
disable Выключить автоматическое архивирование. Требует прав супер-пользователя.
enablelocal

Включить local Time Machine snapshot. Требует прав супер-пользователя. По умолчанию включен. Делает локальные копии в скрытом разделе на внутреннем диске, даже в то время, когда диск с резервными копиями недоступен, но при этом резервирует место. Посмотреть объем занимаемого места можно ->Об этом Mac->Подробнее->Хранилище

memory used snapshot local time machine

disablelocal Выключить local Time Machine snapshot. Требует прав супер-пользователя.
snapshot Создать новый Time Machine snapshot

startbackup [-b | --block]
                 [-r | --rotation]
         [-d | --destination dest_id]

Выполнить стандартное резервное копирование, аналогично команде "Создать резервную копию сейчас" через иконку Тайм Машины

Дополнительные параметры

--block     ждать (блокировать) до момента завершения архивации перед завершением утилиты
--rotation позволить автоматическое изменение размещения во время резервного копирования
--destination выполнить архивирование в место соответствующее определенному ID

stopbackup Прервать выполнение резервного копирования
delete snapshot_path ... Удалить один или более snapshots в machine directory. Этот параметр может удалять указанные snapshots из резервной копии текущей машины, которые не востребованы. Требует прав супер-пользователя.
restore [-v] src ... dst

Восстановить объект src который находится внутри snapshot в папку dst . Параметр dst описывает путь назначения аналогично как в команде cp (скопировать файл). Можно указать несколько исходных файлов последовательно, но последний параметр должен быть путем куда восстанавливать.

При восстановлении данных Time Machine ведет себя аналогично копированию в Finder. Специальные метаданные TM (расширенные параметры безопасности и другое) не переносятся, а все стандартные метаданные будут восстановлены.

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

 compare [-@esmugtdEX]
              [-D depth] 
              [-I name]
     [snapshot_path | path1 path2]

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

Параметр compare требует дополнительных опций перед snapshot (описывающих какие свойства файлов сравнивать), если они не указаны, то по умолчанию будет использован пакет -smugt.  Указание любой  буквенной опции отменяет данный пакет.

-a Сравнивать все поддерживаемые метаданные
-@ Сравнивать расширенные атрибуты
-e Сравнивать ACL
-s Сравнивать размеры
-m Сравнивать режимы файла (modes)
-u Сравнивать UID's (владельца файла)
-g Сравнивать GID's (группу владельцев файла)
-t Сравнивать время последнего изменения
-d Сравнить данные файла 
-D Ограничить число итераций 
-E Игнорировать ограничения во время сравнения внутри томов
-I Игнорировать указанные пути 
-X Вывести результат сравнения в формате XML
setdestination [-ap] arg

Установить локальный диск в формате HFS+ (Mac OS Extended журнальный) или расшаренный AFP том в качестве диска для хранения резервных копий. Требует прав супер-пользователя.

При указании опции -a arg будет добавлен в список путей назначений. Time Machine автоматически выбирает backup destination. Если опция -a не указана, то Time Machine заменить список дисков arg.

Если вы хотите установить том формата HFS+ в качестве диска для хранения резервных копий, arg - должен быть точкой монтирования диска. В случае указания в качестве тома для хранения сетевого диска (AFP) arg должен быть следующим:

afp://user[:pass]@host/share

В данном случае пароль не является обязательным, можно установить опцию -p для ввода его в интерактивном режиме. Данная возможность необходима по соображениям безопасности так как все параметры команды можно увидеть через команду ps 

destinationinfo [-X]

Вывести информацию о носителе хранящем резервные копии файлов из текущих настроек Тайм Машины. Выводится следующая информация:

Name         метка тома (как она показывается в Finder)
Kind         тип подсоединения носителя (локально или по сети)
URL          в случае подсоединения по сети, адрес используемый для диска хранения копий
Mount Point  Если том уже смонтирован, то показывает путь к файловой системе 
ID           Уникальный идентификатор 

Если сконфигурирован более одного диска для архивации, путь назначения где хранится самая последняя копия будет помечен символом  >

В случае указания опции -X вывод результата будет сделан в XML формате

removedestination identifier

Удалить диск из списка дисков для резервного копирования по уникальному идентификатору. Требует прав супер-пользователя.

Для того, чтобы узнать уникальный идентификатор диска используйте параметр destinationinfo

addexclusion [-p] item ...

Настройка исключений. Данный параметр указывает Time Machine какие файлы и папки нет архивировать. 

Существует два вида исключений:

Липкие ("sticky") - данные исключения привязываются к файлу или папке независимо от его расположения. Если вы впоследствии переместите указанный объект, то он все равно останется в исключениях. При копировании такого объекта исключение передастся и на его копию.

Фиксированное. Указывает на файл или папку по конкретному пути. Если впоследствии вы переименуете или переместите данный объект, то исключение с него будет снято и файл начнет архивироваться, так как Time Machine посчитает его другим файлом по новому пути.

Опция -p включает фиксированное исключение. Требует прав супер-пользователя.

В качестве исключения может быть указан том (диск). Параметр -p в таком случае игнорируется. Очистка тома заставит Тайм Машину включить его в резервное копирование. Требует прав супер-пользователя.

removeexclusion [-p] item ... Отменить исключение. Заставляет TM начать копирование указанного объекта при последующих архивациях. Семантика и права аналогичны addexclusion
isexcluded [-X] item ...

Проверить является ли указанный объект (файл, папка, том) исключенным из резервного копирования.

Опция -X определяет вывод результатов в формате XML

Пример команды:

> # example output for an excluded item
user:~ user$ tmutil isexcluded /Users/admin/Desktop/foo.txt

[Excluded]      /Users/admin/Desktop/foo.txt
<# example output for an item that is not excluded
user:~ user$ tmutil isexcluded /Users/admin/Desktop/bar.txt

[Included]      /Users/admin/Desktop/bar.txt				

 inheritbackup {machine_directory | sparsebundle}

Использовать machine directory или узел (sparsebundle) на данном компьютере.

machine directory и sparsebundle могут принадлежать только одному компьютеру в конкретный момент времени. Они отслеживаются по уникальным идентификаторам, а не по имени компьютера, имени хоста, или сетевому адресу. Команда tmutil inheritbackup  переназначает указанные идентификаторыи переконфигурирует настройки Time Machine. Можно указать только sparsebundle, в этом случае machine directory будет переназначена автоматически.

Примеры по восстановлению связи с диском 

 associatedisk [ - ] mount_point  snapshot_volume

Привязать снимки архивов (snapshots)  к определенному локальному диску. Требует прав супер-пользователя.

В Mac OS X при создании тома HFS+ создаются UUID, которые не меняются все время существования тома. Time Machine использует данные инедтификаторы для образования связей между источником данных и диском хранения резервных копий. Очистка исходного тома создаст новую файловую систему на диске и предыдущие UUID будут потеряны и будет потеряна связь между диском хранения резервных копий Тайм Машины и рабочим диском. Если вы хотите восстановить информацию на отформатированный диск, то необходимо создать новую связ данной командой.

Конкретный пример:

После того, как вы очистили и отформатировали свой рабочий диск, ввы решили вручную восстановить часть информации из резервных копий (не в автоматическом режиме с помощью System Restore или Migration Assistant) вы должны установить новую связь с Time Machine

 

user:~ user$ sudo tmutil associatedisk [-a] "/Volumes/MyNewStuffDisk" "/Volumes/Chronoton/Backups.backupdb/thermopylae/Latest/MyStuff"

В результате выполнения данной команды будет построена связь между местом хранения архивов тома MyStuff и новым диском по имени MyNewStuffDisk.Снимки  (snapshots) также будут переименованы в архиве. Опция -a говорит associatedisk о необходимости установить связь со всеми переодическими копиями (snapshots) с именем MyStuff.

latestbackup Распечатать путь к последней архивной копии (snapshots)
listbackups Распечатать список всех имеемых резервных копий (snapshots)
 machinedirectory распечатать путь к текущему каталогу machine directory
 calculatedrift machine_directory Проанализировать копии архивов (snapshots) в папке  machine directory и определить объем изменений в каждой. Будут распечатаны изменения. В зависимости от прав доступа к файлам могут потребоваться права супер-пользователя.
 uniquesize path ... Проанализировать указанный путь и определить его уникальный размер. Результат подсчета включает данные только по указанному пути, связанные данные (псевдонимы и т.п.) в расчет не включаются

Подробнее о настройках Time Machine и решении проблем возникающих при ее эксплуатации.

Консольное копирование файлов и папок cp

Весь список команд терминала OS X