TimeMachineの除外設定(APFS snapshot関連/Mojave)

TimeMachineの除外設定メモ
TimeMachineの除外設定には以下の3つがある

1. OS(デフォルト)の設定
• /System/Library/CoreServices/backupd.bundle/Contents/Resources/StdExclusions.plist 記載
2. ユーザ設定:ボリューム,パス指定
• /Library/Preferences/com.apple.TimeMachine.plist 記載
3. ユーザ設定:ファイル指定
• ファイルの拡張属性として保存

$ tmutil localsnapshot ...つまりsnapshotではこれら全ての設定が反映される訳ではないので注意!

---

1.確認

OS(デフォルト)の設定の確認

$ defaults read /System/Library/CoreServices/backupd.bundle/Contents/Resources/StdExclusions.plist

ユーザ設定:ボリューム,パス指定の確認
全体は..

$ defaults read /Library/Preferences/com.apple.TimeMachine.plist

内ボリュームの除外,対象設定は..

$ defaults read /Library/Preferences/com.apple.TimeMachine.plist ExcludedVolumeUUIDs <--除外設定

$ defaults read /Library/Preferences/com.apple.TimeMachine.plist IncludedVolumeUUIDs <--対象設定

ref.Volume UUID値で返答されるので,diskutil info diskXsX等で調べておくこと
特に利用しなくなったボリュームの設定は残ったままになっているので適時削除しておくこと

パス指定は..

$ defaults read /Library/Preferences/com.apple.TimeMachine.plist SkipPaths

ユーザー設定:ファイル指定の確認

$ mdfind "com_apple_backup_excludeItem = 'com.apple.backupd'"
や
$ sudo find / -xattrname com.apple.metadata:com_apple_backup_excludeItem
などで

2.変更

基本的にはtmutilコマンドで..

$ tmutil addexclusion [-p | -v] /Path/To/Item

と設定($ tmutil isexcluded /Path/To/Itemで確認)

コマンドオプションの

 -p :パス指定で保存
 -v :Volume UUID指定指定で保存
何も付けない :ファイルの拡張属性指定で保存

(拡張属性だと移動/コピーしても引き継がれる)となる

defaultsコマンドは,tmutilで指定出来ない場合だけ利用する

<例えば...もう壊れて使えないHDDを除外設定したい場合など...

例)Volume UUID1 と Volume UUID2 (だけ)を除外する場合

$ sudo defaults write /Library/Preferences/com.apple.TimeMachine.plist ExcludedVolumeUUIDs -array "Volume UUID1" "Volume UUID2"

remark! : 要素を追加するオプション(-array-add hoge)はあるけれど要素削除するオプションは見当たらないので "上書き"する(対象要素をすべて書く) 

補1:
ちなみに拡張属性としては

$ xattr -pl com.apple.metadata:com_apple_backup_excludeItem /Path/To/Item
com.apple.metadata:com_apple_backup_excludeItem:
00000000  62 70 6C 69 73 74 30 30 5F 10 11 63 6F 6D 2E 61  |bplist00_..com.a|
00000010  70 70 6C 65 2E 62 61 63 6B 75 70 64 08 00 00 00  |pple.backupd....|
00000020  00 00 00 01 01 00 00 00 00 00 00 00 01 00 00 00  |................|
00000030  00 00 00 00 00 00 00 00 00 00 00 00 1C           |.............|
0000003d

みたいになっている

補2:
Time Machine環境設定(GUI)のオプションの"バックアップ対象から除外する項目"で設定すると同じファイルを指定しても、パス指定(SkipPaths)になったり、拡張属性保存(com_apple_backup_excludeItem = com.apple.backupd)になったり...ちょっと変^^

補3:
バックアップログは

/Volumes/HDD-Name/Backups.backupdb/Vol-Name/Latest/

下にあり

.VolumeUUID.clonedb
.Backup.log
.com.apple.TMCheckpoint
.exclusions.plist

などがある