Özet

      tmutil verb [options]

Açıklama

tmutil; Time Machine'i kontrol etmek ve onunla etkileşime girmek için yöntemler sunmanın yanı sıra Time Machine yedeklemelerini incelemeyi ve yönetmeyi sağlar. Yaygın yetenekleri arasında yedeklemelerden veri geri yükleme, hariç tutulanları düzenleme ve yedeklemeleri karşılaştırma yer alır.

Tüm fiiller (verb) olmasa da birkaçı root ve Tam Disk Erişimi (Full Disk Access) ayrıcalıkları gerektirir. Tam Disk Erişimi ayrıcalıkları, Güvenlik ve Gizlilik tercih panelindeki Gizlilik sekmesinden tmutil'i çalıştırmak için kullanılan Terminal uygulamasına verilebilir.

Yedekleme Yapısı

Bu kılavuz boyunca, Time Machine yedeklemeleriyle ilişkili belirli "alanları" (realms) açıklamak için özel bir dil kullanılmıştır. tmutil'i ve kılavuzunu etkili bir şekilde kullanmak için bu terminolojiyi anlamak önemlidir.

backup source (yedekleme kaynağı) Şu anda Time Machine tarafından yedeklenmekte olan bir birim (volume).

backup disk (yedekleme diski) Time Machine yedeklemelerini içeren HFS+ veya APFS birimi.

backup destination (yedekleme hedefi) Yerel bir hedef olması durumunda, yedekleme diskiyle eşanlamlıdır. Ağ hedefleri için bu, yedekleme diski görüntüsünün bulunduğu AFP veya SMB paylaşımıdır.

backup disk image (yedekleme disk görüntüsü veya yedekleme görüntüsü) Bağlandığında, yedekleme diski olan bir birim için arka plan deposu (backing store) olan bir sparsebundle dosyası.

backup store (yedekleme deposu) HFS+ yedekleme diskinin kökündeki en üst düzey "Backups.backupdb" dizinidir. Örn.

/Volumes/Chronoton/Backups.backupdb

Not: APFS yedekleme disklerinin yedekleme depoları yoktur.

machine directory (makine dizini) HFS+ üzerinde, yedekleme deposunun içinde belirli bir bilgisayara ait tüm yedeklemeleri içeren bir dizindir. APFS üzerinde, yedekleme diskinin kökü bir makine dizinidir. Yerel HFS+ hedefleri için bir yedekleme deposu, hepsi ayrı bilgisayarlar için olan birden fazla makine dizini içerebilir. Örn.

/Volumes/Chronoton/Backups.backupdb/thermopylae

backup (yedek) Bir makine dizininin veya bir bilgisayarın tek bir ilk veya artımlı yedeğini temsil eden APFS yedekleme birimi anlık görüntüsünün içindeki bir dizin. Örn.

/Volumes/Chronoton/Backups.backupdb/thermopylae/2011-07-03-123456

com.apple.TimeMachine.2011-07-03-123456.backup

local snapshot (yerel anlık görüntü veya anlık görüntü) Yedeğe dahil edilen bir APFS kaynak biriminin APFS anlık görüntüsü. Örn.

com.apple.TimeMachine.2011-07-03-123456.local

volume store (birim deposu) Bir yedeklemenin içinde, tek bir yedekleme kaynağının tek bir ilk veya artımlı yedeğini temsil eden bir dizin. Örn.

/Volumes/Chronoton/Backups.backupdb/thermopylae/2011-07-03-123456/Mac HD

/Volumes/.timemachine/*/2011-07-03-123456.backup/2011-07-03-123456.backup/Mac HD

Fiiller (Verbs)

Her fiil, açıklaması ve bireysel bağımsız değişkenleriyle birlikte listelenmiştir.

setdestination [-ap] arg Yerel bir HFS+ veya APFS birimini, AFP paylaşımını veya SMB paylaşımını yedekleme hedefi olarak yapılandırır. Root ve Tam Disk Erişimi ayrıcalıkları gerektirir.

-a seçeneği sağlandığında, arg hedef listesine eklenecektir. Time Machine, yedekleme yaparken listeden otomatik olarak bir yedekleme hedefi seçecektir. -a seçeneği sağlanmadığında, mevcut hedef listesinin yerini arg alacaktır.

Yedekleme hedefi olarak bir HFS+ veya APFS birimi ayarlamak istiyorsanız, arg söz konusu birimin bağlama noktası (mount point) olmalıdır. Bir AFP veya SMB hedefi ayarlanırken arg şu biçimi alır:

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

AFP ve SMB durumlarında, URL'nin şifre bileşeni isteğe bağlıdır; bunun yerine şifreyi ekrana yansıtılmayan etkileşimli bir istemde girmek için -p seçeneğini belirtebilirsiniz. Bir programa sağlanan tüm bağımsız değişkenler ps aracı aracılığıyla sistemdeki tüm kullanıcılar tarafından görülebileceğinden, bu durum özellikle güvenlik bilincine sahip olanların ilgisini çekmektedir.

destinationinfo [-X] Şu anda Time Machine ile kullanılmak üzere yapılandırılmış hedefler hakkındaki bilgileri yazdırır. Her yedekleme hedefi için aşağıdaki bilgiler görüntülenebilir:

Name Finder'da gösterilen birim etiketi. Kind Hedefin yerel olarak bağlı bir depolama mı yoksa bir ağ aygıtı mı olduğu. URL Bir ağ hedefi olması durumunda, Time Machine yapılandırması için kullanılan URL. Mount Point Eğer birim şu anda bağlıysa, dosya sisteminde bağlandığı yol. ID Hedef için benzersiz tanımlayıcı.

setquota destination_id quota_in_gb Belirtilen benzersiz tanımlayıcıya sahip hedefin kotasını belirtilen gigabayt miktarına ayarlar. Bir hedefin benzersiz tanımlayıcısını elde etmek için destinationinfo seçeneğine bakın.

Yeni kota, bu hedefe yapılacak bir sonraki yedeklemede yürürlüğe girecektir.

Root ve Tam Disk Erişimi ayrıcalıkları gerektirir.

removedestination identifier Belirtilen benzersiz tanımlayıcıya sahip hedefi Time Machine yapılandırmasından kaldırır. Bir hedefin benzersiz tanımlayıcısını elde etmek için destinationinfo seçeneğine bakın.

Root ve Tam Disk Erişimi ayrıcalıkları gerektirir.

addexclusion [-pv] item ... Time Machine'e gelecekteki yedeklemeler sırasında bir dosyayı, dizini veya birimi yedeklememesini söyleyen bir hariç tutma yapılandırır.

Time Machine'de kullanıcı tarafından yapılandırılabilen üç tür hariç tutma vardır:

addexclusion fiili için varsayılan davranış olan ilk hariç tutma türü, bir dosyayı veya dizini takip eden, konumdan bağımsız ("sticky") bir hariç tutmadır. Dosya veya dizin taşındığında, hariç tutma öğeyle birlikte yeni konuma gider. Ek olarak, öğe kopyalandığında kopya da hariç tutmayı korur.

İkinci hariç tutma türü sabit yollu (fixed-path) bir hariç tutmadır. Bununla Time Machine'e, o yoldaki öğeden bağımsız olarak belirli bir yolun hariç tutulmasını istediğinizi söylersiniz. Belirtilen yolda hiçbir dosya veya dizin yoksa, hariç tutmanın hiçbir etkisi yoktur; yoldaki öğe daha önce taşınmış veya yeniden adlandırılmışsa, öğe hariç tutulmaz çünkü şu anda hariç tutulan yolda bulunmamaktadır. Bu semantiğin bir sonucu olarak, bir dosyayı veya dizini bu yola taşımak öğenin hariç tutulmasına neden olur--sabit yollu hariç tutmalar, öğeler taşındığında veya silindiğinde otomatik olarak temizlenmez ve hariç tutulan bir yolda bir öğe var olduğunda yeniden yürürlüğe girer.

Üçüncü hariç tutma türü birim (volume) hariç tutmadır. Bunlar, birim adı ve bağlama yolu değişiklikleri boyunca kalıcı olan dosya sistemi UUID'sine göre birimleri izler. Birimin silinmesi (erase), Time Machine'in yeni silinen birim için varsayılan davranışı uygulamasına neden olur.

-p seçeneği sabit yollu hariç tutmaları yapılandırır. -v seçeneği birim hariç tutmalarını yapılandırır. Her ikisi de root ve Tam Disk Erişimi ayrıcalıkları gerektirir. -v seçeneği, bir birimi hariç tutmak veya hariç tutulmasını kaldırmak için desteklenen tek yoldur; yapışkan (sticky) veya sabit yollu bir hariç tutma belirtilirse davranış tanımsızdır.

removeexclusion [-pv] item ... Gelecekteki yedeklemeler sırasında bir dosyayı, dizini veya birimi yedeklemek üzere Time Machine'i yapılandırır. Bu fiil, addexclusion ile aynı kullanımı, hariç tutma stilini ve ayrıcalık semantiğini takip eder.

isexcluded [-X] item ... Bir dosyanın, dizinin veya birimin Time Machine yedeklemelerinden hariç tutulup tutulmadığını belirler.

-X seçeneği sağlandığında, çıktı XML özellik listesi (property list) biçiminde yazdırılacaktır.

hariç tutulan bir öğe için örnek çıktı

thermopylae:~ thoth$ tmutil isexcluded /Users/admin/Desktop/foo.txt [Excluded] /Users/admin/Desktop/foo.txt

hariç tutulmayan bir öğe için örnek çıktı

thermopylae:~ thoth$ tmutil isexcluded /Users/admin/Desktop/bar.txt [Included] /Users/admin/Desktop/bar.txt

enable Otomatik yedeklemeleri açar. Root ve Tam Disk Erişimi ayrıcalıkları gerektirir.

disable Otomatik yedeklemeleri kapatır. Root ve Tam Disk Erişimi ayrıcalıkları gerektirir.

startbackup [-a | --auto] [-b | --block] [-r | --rotation] [-d | --destination dest_id] Zaten çalışan bir yedekleme yoksa yeni bir yedekleme başlatır.

Seçenekler: --auto Yedeklemeyi sistem tarafından zamanlanan yedeklemelere benzer bir modda çalıştırır. --block Çıkmadan önce yedekleme bitene kadar bekler (bloklar). --rotation Yedekleme sırasında otomatik hedef rotasyonuna izin verir. --destination Yedeklemeyi belirtilen kimliğe karşılık gelen hedefe gerçekleştirir.

--auto seçeneği, sistem tarafından zamanlanan otomatik yedeklemelere benzer şekilde "otomatik benzeri" yedeklemeleri tetiklemek için desteklenen bir mekanizma sağlar. Bu, gerçek sistem tarafından zamanlanan yedeklemelerle tamamen aynı olmasa da, özel zamanlayıcılara normalde otomatik modda çalışırken sergilenen bazı (ancak tümü değil) davranışları elde etme yeteneği sağlar.

stopbackup Şu anda devam etmekte olan bir yedeklemeyi iptal eder.

compare [-@acdefglmnstuEUX] [-D depth] [-I name] [backup_path | path1 path2] Bir yedekleme karşılaştırması (diff) gerçekleştirir.

Hiçbir bağımsız değişken sağlanmazsa, tmutil bilgisayarı en son yedeklemeyle karşılaştıracaktır. Tek bağımsız değişken olarak bir yedekleme yolu sağlanırsa, tmutil bilgisayarı belirtilen yedeklemeyle karşılaştıracaktır. İki yol bağımsız değişkeni sağlanırsa, tmutil bu iki öğeyi birbiriyle karşılaştıracaktır. tmutil, mantıklı olmayan veya desteklenmeyen bir şey yapmasını istediğinizde sizi bilgilendirmeye çalışacaktır.

compare fiili, hangi özelliklerin karşılaştırılacağını belirtmenize olanak tanır. Herhangi bir özellik seçeneği belirtmezseniz, tmutil varsayılan özellik kümesi olarak -@gmstu olduğunu varsayar. Herhangi bir özellik seçeneğinin belirtilmesi varsayılan kümenin üzerine yazılmasına neden olur.

Seçenekler: -a Desteklenen tüm meta verileri karşılaştırır. -n Meta veri karşılaştırması yapmaz. -@ Genişletilmiş öznitelikleri (extended attributes) karşılaştırır. -c Oluşturulma zamanlarını karşılaştırır. -d Dosya veri çatallarını (data forks) karşılaştırır. -e ACL'leri karşılaştırır. -f Dosya bayraklarını karşılaştırır. -g GID'leri karşılaştırır. -m Dosya modlarını karşılaştırır. -s Boyutları karşılaştırır. -t Değiştirilme zamanlarını karşılaştırır. -u UID'leri karşılaştırır. -D Gezinme derinliğini yineleme başlangıcından itibaren depth seviyeleriyle sınırlar. -E Birimlerin içindeki öğeleri karşılaştırırken hariç tutulanları dikkate almaz. -I Yineleme sırasında yol bileşeni name değerine eşit olan yolları yoksayar. Bu seçenek birden fazla kez belirtilebilir. -U Yerel bir birimi veya birim deposunu bir birim deposuyla doğrudan karşılaştırırken mantıksal birim kimliğini (birim UUID'leri) yoksayar. -X Çıktıyı XML özellik listesi biçiminde yazdırır.

verifychecksums path ... Bir yedeklemede bulunan verilerin sağlama toplamını (checksum) hesaplar ve sonucu, yedekleme sırasında hesaplanan sağlama toplamı bilgileriyle doğrular.

Eşleşen sağlama toplamları için hiçbir çıktı üretilmez. Sorunlar aşağıdaki göstergeler kullanılarak rapor edilir:

! Dosyanın geçerli sağlama toplamı, kaydedilen beklenen sağlama toplamıyla eşleşmiyor. ? Dosyanın kaydedilen sağlama toplamı geçersiz.

OS X 10.11'den başlayarak, Time Machine yedeklemelere kopyalanan dosyaların sağlama toplamlarını kaydeder. Sağlama toplamları, OS X'in daha eski sürümleri tarafından kopyalanan dosyalar için geriye dönük olarak hesaplanmaz.

restore [-v] src ... dst Bir yedeklemenin içinde bulunan src öğesini dst konumuna geri yükler. dst bağımsız değişkeni, cp aracının hedef yol semantiğini taklit eder. Geri yüklemek için birden fazla kaynak yolu sağlayabilirsiniz. Son yol bağımsız değişkeni bir hedef olmalıdır.

restore fiilini kullanırken tmutil büyük ölçüde Finder gibi davranır. Özel Time Machine meta verileri (genişletilmiş güvenlik ve diğerleri) geri yüklenen verilerden kaldırılacak ve diğer meta veriler korunacaktır.

Geri yükleme işlemlerini gerçekleştirmek için root ve Tam Disk Erişimi ayrıcalıkları gerekebilir. tmutil ile root olarak geri yükleme yapıldığında, geri yüklenen öğelerin sahipliği yedeklemedeki öğelerin durumuyla eşleşecektir.

delete [-d backup_mount_point -t timestamp] [-p path] Belirtilen bağlama noktasında bağlı olan yedekleme biriminden belirtilen zaman damgasına sahip yedekleri siler. Bir zaman damgasının takip ettiği -t seçeneği, silinecek birden fazla yedeği belirtmek için birden fazla kez kullanılabilir. HFS yedekleme diskleri için, -p seçeneği kullanılarak silinecek belirli bir yol da belirtilebilir. Bu fiil, geçerli makine tarafından yapılmayan veya sahiplenilmeyen yedeklemelerdeki öğeleri silebilir. Root ve Tam Disk Erişimi ayrıcalıkları gerektirir.

deleteinprogress machine_directory Bir makine dizini için devam eden tüm yedeklemeleri siler. Root ve Tam Disk Erişimi ayrıcalıkları gerektirir. APFS yedekleme hedeflerinde, bu işlem hedef birimi son yedeklemeye geri döndürür.

latestbackup [-d backup_mount_point [-m [-t]]] Bu bilgisayarın tamamlanmış en son yedeklemesini listeler. -d seçeneği, yedeklerin listeleneceği bir hedef birim belirtir. -m sağlandığında, latestbackup yedekleri bağlamaya ve bağlı yollarını listelemeye çalışacaktır. -t seçeneği, tam ad veya yol yerine yalnızca yedekleme zaman damgasını gösterecektir. Root ve Tam Disk Erişimi ayrıcalıkları gerektirir.

listbackups [-d backup_mount_point [-m [-t]]] Bu bilgisayarın tamamlanmış tüm yedeklemelerini listeler. -d seçeneği, yedeklerin listeleneceği bir hedef birim belirtir. -m sağlandığında, listbackups yedekleri bağlamaya ve bağlı yollarını listelemeye çalışacaktır. -t seçeneği, tam ad veya yol yerine yalnızca yedekleme zaman damgasını gösterecektir. Root ve Tam Disk Erişimi ayrıcalıkları gerektirir.

machinedirectory Bu bilgisayar için geçerli makine dizininin yolunu yazdırır.

calculatedrift machine_directory Bir HFS makine dizinindeki yedeklemeleri analiz eder ve her biri arasındaki değişim miktarını belirler. Tüm yedeklemeler analiz edildikten sonra ortalamalar yazdırılır. Bu, makine dizininin içeriğine bağlı olarak root ve Tam Disk Erişimi ayrıcalıkları gerektirebilir.

uniquesize path ... Bir HFS+ yedeklemesindeki belirtilen yolu veya bir APFS yedeklemesinin yolunu analiz eder ve benzersiz boyutunu belirler. uniquesize tarafından rapor edilen rakam, yalnızca belirtilen yolda var olan şeyleri temsil eder; diğer yedeklemelerde mevcut olan şeyler hesaba katılmaz.

inheritbackup {machine_directory | sparsebundle} Geçerli makine tarafından kullanılmak üzere bir makine dizini veya sparsebundle üzerinde hak iddia eder (claim). Root ve Tam Disk Erişimi ayrıcalıkları gerektirir.

Makine dizinleri ve sparsebundles dosyaları aynı anda yalnızca tek bir bilgisayara aittir ve bilgisayar adı, ana bilgisayar adı veya ethernet adresi yerine benzersiz tanımlayıcılarla izlenir. inheritbackup fiili, belirtilen öğenin kimliğini yeniden atayarak, geçerli ana bilgisayarın yedeklemeler sırasında onu tanımasını sağlayacak şekilde yeniden yapılandırır. Bir sparsebundle devralınırken, içindeki makine dizini üzerinde de hak iddia edilecektir.

Devralma (inheriting), genellikle bir makine tarafından kullanılmak üzere bir yedeklemeyi yapılandırma sürecindeki adımlardan yalnızca biridir. Duruma bağlı olarak setdestination, associatedisk veya her ikisini birden kullanmanız da gerekebilir.

Bir makine birden fazla makine dizinine ve sparsebundle dosyasına sahip olabilir, ancak bunların aynı yerde bulunması tavsiye edilmez. Böyle bir durumda, yedekleme sırasında hangisinin seçileceği belirsizdir. Sonuç olarak inheritbackup, değişiklik yapmadan önce olası kimlik çakışmalarını tespit etmeye çalışacaktır.

associatedisk mount_point snapshot_volume Bir birim deposu dizinini belirtilen yerel diske bağlar, böylece yedekleme geçmişini yeniden yapılandırır. Root ve Tam Disk Erişimi ayrıcalıkları gerektirir.

Mac OS X'te, HFS+ ve APFS birimleri, dosya sistemi oluşturulduğunda atanan kalıcı bir UUID'ye sahiptir. Time Machine, kaynak birim ile bir birim deposu arasında ilişki kurmak için bu tanımlayıcıyı kullanır. Kaynak birimin silinmesi disk üzerinde yeni bir dosya sistemi oluşturur ve önceki UUID korunmaz. Yeni UUID, kaynak birim -> birim deposu ilişkisinin bozulmasına neden olur. Bir kişi sadece birimi silip baştan başlıyorsa, bu durumun muhtemelen gerçek bir önemi olmaz ve yeni UUID bir endişe kaynağı teşkil etmez; ancak başka bir birimi kopyalamak (klonlamak) amacıyla bir birim silinirken ilişkinin yeniden kurulması istenebilir.

associatedisk komutunu ne zaman ve nasıl kullanacağınıza dair somut bir örnek:

Bir birimle sorunlar yaşadıktan sonra, onu silmeye ve içeriğini bir Time Machine yedeklemesinden veya başka bir nitelikteki kopyadan manuel olarak geri yüklemeye karar verirsiniz. (Yani, Time Machine Sistem Geri Yükleme veya Göç Yardımcısı aracılığıyla değil.) Bir sonraki artımlı yedeklemenizde veriler, daha önce hiç yedeklenmemiş gibi yeniden kopyalanacaktır. Teknik olarak, yeni UUID göz önüne alındığında, verilerin yedeklenmediği doğrudur. Ancak bu muhtemelen Time Machine'in yapmasını istediğiniz şey değildir. Bu durumda, yedeklemeyi bu birimin daha önce yedeklenmiş gibi görünmesini sağlayacak şekilde yeniden yapılandırmak için associatedisk kullanırsınız:

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

Yukarıdaki komutun sonucu, belirtilen yedeklemedeki MyStuff birim deposunu kaynak birim MyNewStuffDisk ile ilişkilendirecektir. Birim deposu da eşleşecek şekilde yeniden adlandırılacaktır. -a seçeneği, associatedisk fiiline aynı makine dizinindeki MyStuff kimliğiyle eşleşen tüm birim depolarını bulmasını ve ardından hepsinde ilişkilendirmeyi gerçekleştirmesini söyler.

localsnapshot Time Machine yedeklemesine dahil olan tüm APFS birimlerinin yeni yerel Time Machine anlık görüntülerini oluşturur.

listlocalsnapshots mount_point Belirtilen birimin yerel Time Machine anlık görüntülerini listeler.

listlocalsnapshotdates [mount_point] Tüm yerel Time Machine anlık görüntülerinin oluşturulma tarihlerini listeler.

Belirli bir birimdeki anlık görüntü oluşturma tarihlerini listelemek için mount_point belirtin.

Listelenen tarihler YYYY-AA-GG-SASEDK (YYYY-MM-DD-HHMMSS) biçimindedir.

deletelocalsnapshots {mount_point | date} Bir tarih belirtilirse, tüm bağlı disklerde belirtilen tarihe ait (YYYY-AA-GG-SASEDK biçiminde) tüm yerel Time Machine anlık görüntülerini siler. Bir disk belirtilirse, belirtilen diskteki tüm yerel Time Machine anlık görüntülerini siler.

thinlocalsnapshots mount_point [purge_amount] [urgency] Belirtilen birim için yerel Time Machine anlık görüntülerini seyreltir (thin).

purge_amount ve urgency belirtildiğinde, tmutil anlık görüntüleri seyrelterek bayt cinsinden purge_amount miktarını geri kazanmaya çalışacaktır (urgency seviyesi 1-4 ile).

Eğer urgency belirtilmemişse, varsayılan aciliyet düzeyi kullanılacaktır.

Çıkış Durumu

Çoğu durumda, tmutil başarı durumunda 0, aksi takdirde >0 ile çıkar.

Mac OS X 10 June 2015 Mac OS X