$ touch

Özet

touch [-A [-][[hh]mm]SS] [-achm] [-r referans_dosyası] [-t [[CC]YY]MMDDhhmm[.SS]]
      [-d YYYY-MM-DDThh:mm:SS[.ondalik][tz]] dosya ...

Açıklama

touch yardımcı programı, komut satırında belirtilen dosyaların son değiştirilme (mtime) ve son erişim (atime) zaman damgalarını ayarlar. Eğer belirtilen dosya diskte mevcut değilse, sistemin varsayılan dosya oluşturma izinleriyle sıfır baytlık boş bir dosya otomatik olarak oluşturulur.

Varsayılan olarak touch, hem erişim hem de değiştirilme zaman damgalarını geçerli sistem saatine ayarlar. -a ve -m bayrakları sırasıyla yalnızca erişim zamanını ya da yalnızca değiştirilme zamanını değiştirmek için kullanılabilir.

Seçenekler

Aşağıdaki seçenekler mevcuttur:

• -A [-][[hh]mm]SS: Dosya için mevcut erişim ve değiştirilme zaman damgalarını belirtilen saat (hh), dakika (mm) ve saniye (SS) miktarı kadar ileri veya geri ayarlar (değişiklik miktarını belirtir). Başına - eklenmesi zamanı geriye kaydırır. Bu seçenek otomatik olarak -c seçeneğini de etkinleştirir.
• -a: Yalnızca dosyanın son erişim zamanını (atime) değiştirir. -m bayrağı da belirtilmedikçe son değiştirilme zamanı (mtime) değiştirilmez.
• -c: Dosya diskte mevcut değilse yeni dosya oluşturulmasını engeller. Bu durum bir hata olarak kabul edilmez, ekrana hata mesajı yazdırılmaz ve çıkış kodu etkilenmez.
• -d YYYY-MM-DDThh:mm:SS[.ondalik][tz]: Erişim ve değiştirilme zamanlarını günün geçerli saati yerine belirtilen ISO 8601 benzeri tarih ve saate ayarlar:
  • YYYY: Yılı temsil eden en az 4 basamaklı sayı.
  • T veya boşluk: Tarih ile saati ayıran karakter.
  • .ondalik: Saniyeden sonraki ondalık kesir (dosya sisteminin hassasiyetine göre çözümlenir).
  • tz: Zamanın UTC olduğunu belirten Z harfi; belirtilmezse zamanın yerel saat diliminde olduğu varsayılır. Yerel saat TZ çevre değişkeninden etkilenir.
• -h: Hedef öğe bir sembolik bağlantı (symlink) ise, bağlantının işaret ettiği dosya yerine sembolik bağlantının kendi zaman damgalarını değiştirir. Bu seçenek otomatik olarak -c seçeneğini de etkinleştirir.
• -m: Yalnızca dosyanın son değiştirilme zamanını (mtime) değiştirir. -a bayrağı da belirtilmedikçe son erişim zamanı (atime) değiştirilmez.
• -r referans_dosyası: Günün geçerli saati yerine, belirtilen referans_dosyasının erişim ve değiştirilme zaman damgalarını birebir kopyalayarak hedef dosyaya uygular.
• -t [[CC]YY]MMDDhhmm[.SS]: Erişim ve değiştirilme zamanlarını günün geçerli saati yerine belirtilen POSIX zaman biçimine göre günceller:
  • CC: Yüzyıl (yılın ilk iki basamağı).
  • YY: Yılın son iki basamağı. YY belirtilir ama CC atlanırsa; YY 69-99 arasındaysa 1900'ler, 00-68 arasındaysa 2000'ler kabul edilir.
  • MM: Yılın ayı (01-12).
  • DD: Ayın günü (01-31).
  • hh: Günün saati (00-23).
  • mm: Saatin dakikası (00-59).
  • SS: Dakikanın saniyesi (00-60). CC ve YY belirtilmezse varsayılan olarak geçerli yıl kabul edilir. SS belirtilmezse varsayılan olarak 0 kabul edilir.

Çıkış Durumu

touch aracı başarı durumunda 0, bir hata oluştuğunda ise 0'dan büyük bir değerle sonlanır.

Örnekler

Aşağıdaki örnekler kabukta (shell) çalıştırılabilecek şekilde gösterilmiştir:

1. yeni_belge.txt adında boş bir dosya oluşturma (veya mevcutsa zaman damgalarını geçerli saate güncelleme):

   touch yeni_belge.txt

2. Dosya mevcut değilse yeni dosya oluşturulmasını engelleme (-c):

   touch -c mevcut_olmayan_dosya.txt

3. Bir dosyanın zaman damgalarını başka bir referans dosyanınkiyle birebir eşitleme (-r):

   touch -r referans.txt hedef.txt

4. Dosyanın zaman damgasını tam olarak 2026-05-25 14:30:00 tarihine ayarlama:

   touch -t 202605251430.00 rapor.pdf

5. ISO 8601 tarih biçimini (-d) kullanarak zamanı 2026-05-25 15:45:00 UTC olarak güncelleme:

   touch -d "2026-05-25T15:45:00Z" rapor.pdf

6. Zaman damgasını tam olarak 1 saat 30 dakika geriye kaydırma (-A):

   touch -A -013000 rapor.pdf

Ayrıca Bakınız

stat(1), utimensat(2)

Standartlar

touch yardımcı programı IEEE Std 1003.2 (“POSIX.2”) standardının tam bir üst kümesidir ve uyumludur.