Özet
touch [-A [-][[hh]mm]SS] [-achm] [-r file] [-t [[CC]YY]MMDDhhmm[.SS]]
[-d YYYY-MM-DDThh:mm:SS[.frac][tz]] file ...
Açıklama
touch aracı, dosyaların değiştirilme ve erişim zamanlarını ayarlar. Dosya mevcut değilse, varsayılan izinlerle oluşturulur.
Varsayılan olarak touch, hem değiştirilme hem de erişim zamanlarını değiştirir. -a ve -m bayrakları sırasıyla yalnızca erişim zamanını veya yalnızca değiştirilme zamanını seçmek için kullanılabilir. Her ikisinin de seçilmesi varsayılan davranışla eş değerdir. Varsayılan olarak, zaman damgaları geçerli zamana ayarlanır. -d ve -t bayrakları açıkça farklı bir zaman belirtir ve -r bayrağı zamanları belirtilen dosyanın zamanlarına ayarlamayı belirtir. -A bayrağı değerleri belirtilen miktarda ayarlar.
Aşağıdaki seçenekler mevcuttur:
-A: Dosya için erişim ve değiştirilme zaman damgalarını belirtilen değer kadar ayarlar. Bu bayrak, zaman damgaları yanlış ayarlanmış dosyaları düzeltmek amacıyla kullanılmak üzere tasarlanmıştır.
Argüman “[-][[hh]mm]SS” biçimindedir ve buradaki her bir harf çifti aşağıdakileri temsil eder:
Ayarlamayı negatif yapar: Yeni zaman damgası eskisinden daha önce olacak şekilde ayarlanır.
hh Saat sayısı, 00 ile 99 arasında. mm Dakika sayısı, 00 ile 59 arasında. SS Saniye sayısı, 00 ile 59 arasında.
-A bayrağı, -c bayrağını da beraberinde getirir: Belirtilen herhangi bir dosya mevcut değilse, sessizce yoksayılacaktır.
-a: Dosyanın erişim zamanını değiştirir. -m bayrağı da belirtilmedikçe dosyanın değiştirilme zamanı değiştirilmez.-c: Dosya mevcut değilse dosyayı oluşturmaz. touch aracı bunu bir hata olarak ele almaz. Herhangi bir hata mesajı görüntülenmez ve çıkış değeri etkilenmez.-d: Erişim ve değiştirilme zamanlarını günün geçerli saati yerine belirtilen tarih ve saate değiştirir. Argüman “YYYY-MM-DDThh:mm:SS[.frac][tz]” biçimindedir ve buradaki harfler aşağıdakileri temsil eder: YYYY Yılı temsil eden en az dört ondalık basamak. MM, DD, hh, mm, SS -t seçeneğindeki zamanla aynıdır. T T harfi veya bir boşluk zaman belirleyicisidir.
.frac Bir nokta veya virgül ve ardından gelen bir veya daha fazla basamaktan oluşan isteğe bağlı bir kesir. Anlamlı basamakların sayısı çekirdek (kernel) yapılandırmasına ve dosya sistemine bağlıdır ve sıfır olabilir. tz Zamanın UTC biçiminde olduğunu belirten isteğe bağlı bir Z harfi. Aksi takdirde, zamanın yerel saat diliminde olduğu varsayılır. Yerel saat, TZ çevre değişkeninin değerinden etkilenir.
-h: Dosya bir sembolik bağ ise, bağın işaret ettiği dosya yerine sembolik bağın kendisinin zamanlarını değiştirir. -h seçeneğinin -c seçeneğini beraberinde getirdiğini ve bu nedenle yeni dosyalar oluşturmayacağını unutmayın.-m: Dosyanın değiştirilme zamanını değiştirir. -a bayrağı da belirtilmedikçe dosyanın erişim zamanı değiştirilmez.-r: Günün geçerli saati yerine belirtilen dosyanın erişim ve değiştirilme zamanlarını kullanır.-t: Erişim ve değiştirilme zamanlarını günün geçerli saati yerine belirtilen zamana değiştirir. Argüman “[[CC]YY]MMDDhhmm[.SS]” biçimindedir ve buradaki her bir harf çifti aşağıdakileri temsil eder:
CC Yılın ilk iki basamağı (yüzyıl). YY Yılın ikinci iki basamağı. “YY” belirtilir ancak “CC” belirtilmezse, 69 ile 99 arasındaki bir “YY” değeri 19 olan bir “CC” değeriyle sonuçlanır. Aksi takdirde, 20 olan bir “CC” değeri kullanılır. MM Yılın ayı, 01 ile 12 arasında. DD Ayın günü, 01 ile 31 arasında. hh Günün saati, 00 ile 23 arasında. mm Saatin dakikası, 00 ile 59 arasında. SS Dakikanın saniyesi, 00 ile 60 arasında.
“CC” ve “YY” harf çiftleri belirtilmezse, değerler varsayılan olarak geçerli yıla ayarlanır. “SS” harf çifti belirtilmezse, değer varsayılan olarak 0 olur.
Çıkış Durumu
touch aracı başarı durumunda 0, bir hata oluştuğunda ise >0 değeriyle çıkar.
Uyumluluk
İlk argüman olarak bir zaman biçiminin belirtildiği, touch komutunun eskiyen (obsolescent) biçimi desteklenmektedir. Herhangi bir -r veya -t seçeneği belirtilmediğinde, en az iki argüman varsa ve ilk argüman sekiz veya on karakter uzunluğunda bir rakam dizesiyse, ilk argüman “MMDDhhmm[YY]” biçiminde bir zaman belirtimi olarak yorumlanır.
“MM”, “DD”, “hh” ve “mm” harf çiftleri, -t seçeneğinde belirtilen karşılıkları gibi ele alınır. “YY” harf çifti 39 ile 99 aralığındaysa, yıl 1939 ile 1999 arasına ayarlanır, aksi takdirde yıl 21. yüzyıla ayarlanır.
Ayrıca Bkz.
utimensat(2)
Standartlar
touch aracının IEEE Std 1003.2 (“POSIX.2”) spesifikasyonunun bir üst kümesi olması beklenmektedir.
Tarihçe
Bir touch aracı ilk olarak Version 7 AT&T UNIX sürümünde yer almıştır.
macOS 26.4 1 Haziran 2018 macOS 26.4