.\" Copyright Andries Brouwer, Ragnar Hojland Espinosa and A. Wik, 1998. .\" .\" This file may be copied under the conditions described .\" in the LDP GENERAL PUBLIC LICENSE, Version 1, September 1998 .\" that should have been distributed together with this file. .\" .TH TOUCH 1 "November 1998" "GNU fileutils 4.0" .SH NÉV touch \- fájl időbélyegének megváltoztatása .SH ÁTTEKINTÉS .B touch .BI "[\-acm][\-r " ref_fájl "|\-t " idő "] [\-\-] " fájl... .sp Elavulófélben levő verzió: .br .B touch .BI "[\-acm][" ronda_idő "] " fájl... .sp GNU verzió: .br .B touch .BI "[\-acfm] [\-r " fájl "] [\-t " decim_idő ] .BI "[\-d " idő "] [\-\-time={atime,access,use,mtime,modify}]" .BI "[\-\-date=" idő "] [\-\-reference=" fájl ] .BI "[\-\-no\-create] [\-\-help] [\-\-version] [\-\-] " fájl... .SH LEÍRÁS A .B touch megváltoztatja minden megadott .I fájl utolsó elérésének és/vagy utolsó módosításának idejét. Ezek az időbélyegek az aktuális időre változnak, hacsak nem adtuk meg az \-r opciót, ez esetben ugyanis a megadott .I ref_fájl időbélyegét kapja meg a fájl, illetve ha a \-t opciót adtuk meg, akkor az időbélyeg a .IR idő ben megadott időre változik. Mindkét idő változik, ha az \-a és a \-m opciókat egyaránt megadtuk, vagy egyiket sem adtuk meg. Csak az utolsó elérés illetve az utolsó módosítás ideje változik, ha az \-a illetve a \-m opciókat egymagukban adjuk meg. Ha a fájl nem létezik, a .B touch létrehozza (üres fájlként, 0666 jogusultságokkal, amelyeket az umask módosíthat), kivéve ha a \-c opciót is megadtuk. .SH "POSIX OPCIÓK" .TP .B \-a A .I fájl utolsó elérésének idejét változtatja. .TP .B \-c Nem hozza létre a .IR fájl t. .TP .B \-m A .I fájl utolsó módosításának idejét változtatja. .TP .BI "\-r " ref_fájl A .I ref_fájl időbélyegeit használja az időbélyegek új értékeinek beállításához. .TP .BI "\-t " idő A megadott időt használja az időbélyegek új értékeinek beállításához. Az argumentum egy decimális szám, a következő formában: .br .nf [[CC]YY]MMDDhhmm[.SS] .br .fi ahol CC a századot, YY az évet, MM a hónapot, DD a napot, hh az órát, mm a percet és SS a másodpercet jelenti. Ha nem adjuk meg a századot, akkor a CCYY évet veszi a program figyelembe, ahol 1969 < CCYY < 2068. Ha nem adjuk meg a YY évet, akkor az aktuális év lesz az idő év része. Ha nem adjuk meg az SS-t, akkor az értéke 0 lesz. Az SS értékét a 0-61 tartományból választhatjuk, így lehetőség van a szökőmásodpercek megadására. A program TZ környezeti változóban megadott időzónában fogja a megadott időt venni. Hibát okoz, ha az idő 1970. január 1. előtti. .TP .B "\-\-" Lezárja az opciók listáját. .SH "POSIX RÉSZLETEK" A hívás második formájának megvan az a hátránya, hogy van némi értelmezési probléma akörül, hogy az .I ronda_idő idő- vagy fájlargumentum. A program akkor tekinteni időnek, ha sem az \-r sem a \-t opciók nincsenek megadva, legalább két argumentum van, és az első argumentum nyolc- vagy tízjegyű decimális szám. Az .I ronda_idő formátuma MMDDhhmm[yy], ahol az yy 69 és 99 közé eshet, és az 1969-1999 éveket jelöli. Ha nem adjuk meg a yy-t, akkor az aktuális évet veszi a program. Ez a formátum elavult. .SH "GNU RÉSZLETEK" Ha az első .I fájl érvényes argumentuma lehet a .B "\-t" opciónak, és nem adtunk meg időbélyeget a .BR "\-d" , az .BR "\-r" illetve a .B "\-t" opciók egyikéhez sem, és a `\-\-' argumentumot sem adtuk meg, akkor ezt az argumentumot időnek fogja értelmezni a program, nem fájlnévnek. .PP Ha valaki az utolsó elérés és az utolsó módosítás idejét egyaránt az aktuális időre szeretné változtatni, a .B touch olyan fájlok időbélyegét is képes megváltoztatni, amelyek nincsenek az adott felhasználó birtokában, de van rá írási joga. Egyébként a felhasználónak kell birtokolnia a fájlokat. .SH "GNU OPCIÓK" .TP .B "\-a, \-\-time=atime, \-\-time=access, \-\-time=use" Csak az utolsó elérés idejét változtatja meg. .TP .B "\-c, \-\-no\-create" Nem hozza létre a fájlokat, ha nem léteznek. .TP .BI "\-d, \-\-date=" idő Az .I idő argumentumot használja az aktuális idő helyett. Ebben lehetnek hónapnevek, időzóna, `am= vagy `pm', stb. .TP .B "\-f" Figyelmen kívül hagyja, csak a .BR touch (1) BSD verziójával való kompatibilitás miatt van implementálva. .TP .B "\-m, \-\-time=mtime, \-\-time=modify" Csak az utolsó módosítás idejét változtatja meg. .TP .BI "\-r " fájl ", \-\-reference=" fájl Az megadott .I fájl időbélyegeit használja az aktuális idő helyett. .TP .BI "\-t " decim_idő Itt a .I decim_idő formátuma MMDDhhmm[[CC]YY][.ss] Az argumentumban megadott időt (hónap, nap, óra, perc, elhagyható század és év, elhagyható másodperc) használja az aktuális idő helyett. Jegyezzük meg, hogy ez a formátum megsérti a POSIX előírásait. .SH "SZABVÁNYOS GNU OPCIÓK" .TP .B "\-\-help" Használati útmutatót ír a szabványos kimenetre, majd sikeres visszatérési értékkel kilép. .TP .B "\-\-version" A program verziójáról ír ki információt a szabványos kimenetre, majd sikeres visszatérési értékkel kilép. .TP .B "\-\-" Lezárja az opciók listáját. .SH KÖRNYEZET A program TZ környezeti változó segítségével értelmezi az expliciten megadott időket. A LANG, az LC_ALL, az LC_CTYPE és az LC_MESSAGES környezeti változókat a szokásos módon veszi figyelembe. .SH MEGFELELÉS A POSIX 1003.2 eltérően írja le a \-t opció argumentumának szintaxisát, mint ahogy a GNU implementációban használatos. .SH "PÉLDA A HASZNÁLATRA" A `\fItouch foo\fP' parancs létrehozza a \fIfoo\fP fájlt, ha az még nem létezett, és az utolsó módosítás idejét az aktuális időre állítja. Ez gyakran használatos a .B make program tevékenységének irányítására. .SH MEGJEGYZÉS Ez a kézikönyvoldal azt az .B touch programot dokumentálja, amelyik a fileutils-4.0 csomagban található. Más verziók működése kissé különbözhet. A javításokat és kiegészítéseket elküldhetjük a aeb@cwi.nl címre (angolul). A programban felfedezett hibákat a fileutils-bugs@gnu.ai.mit.edu címen lehet bejelenteni (angolul). .SH MAGYAR FORDÍTÁS Tímár András