.\" Copyright Andries Brouwer, Ragnar Hojland Espinosa and A. Wik, 1998.
.\"
.\" Japanese Version Copyright (c) 1999 Kazuyuki Tanisako
.\"         all rights reserved.
.\" Translated Tue May 9 02:04 JST 1999
.\"         by Kazuyuki Tanisako
.\"
.\" 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.
.\" 
.\"WORD: timestamps		時刻(アクセス時刻と修正時刻)
.\"WORD: access time		アクセス時刻
.\"WORD: modification time	修正時刻
.\"WORD: timezones		タイムゾーン
.\"
.TH TOUCH 1 "17 November 1998" "GNU fileutils 4.0"
.SH "名前"
touch \- ファイルのアクセス時刻と修正時刻を変更する
.SH "書式"
.B touch
.BI "[\-acm][\-r " ref_file "|\-t " time "] " file...
.sp
今後使われなくなる書式:
.br
.B touch
.BI "[\-acm][" ugly_time "] " file...
.sp
GNU 版:
.br
.B touch
.BI "[\-acfm] [\-r " file "] [\-t " time "]"
.BI "[\-d " time "] [\-\-time={atime,access,use,mtime,modify}] "
.BI "[\-\-date=" time "] [\-\-reference=" file "]"
.BI "[\-\-no-create] [\-\-help] [\-\-version] [\-\-] " file...
.SH "説明"
.B touch
コマンドは指定したそれぞれの
.IR file
のアクセス時刻、修正時刻またはいずれかを変更する。

特に指定がない場合は現在時刻に変更する。\-r オプションを使った場合、
.IR ref_file
の時刻を使い変更し、\-t オプションを使った場合には
.IR time
で指定した時刻に変更する。

\-a と \-m オプションのいずれも指定しないか、同時に指定すると両方の時刻(訳注：アクセス時刻と
修正時刻)を変更する。\-a と \-m オプションのいずれか1つを指定すると、アクセス時刻もしくは
修正時刻のいずれかのみを変更する。 
.SH "POSIX オプション"
.TP
.B \-a
.IR file
のアクセス時刻のみを変更する。
.TP
.B \-c
.IR file
を作成しない。
.TP
.B \-m
.IR file
の修正時刻を変更する。
.TP
.BI "\-r " ref_file
.I ref_file
で指定したファイルの時刻を使い変更する。
.TP
.BI "\-t " time
time で指定した時刻を使い変更する。
引数は次のような明確な意味を持つ10進数の形式で指定する。
.br
.nf
    [[CC]YY]MMDDhhmm[.SS]
.br
.fi
CCを指定しない場合、年CCYYは 1969-2068の範囲となる(訳注：YY=69-99の場合CC＝19、
YY=00-68の場合CC=20と見做される)。YYを指定しない場合には、現在の年が使われる。
SSを指定しない場合、0として見做される。うるう秒を参照できるように0-61の範囲で指定できる。
結果の時刻は環境変数TZにより指定されたタイムゾーンでの時刻となる。結果の時刻が1970年1月1日
以前になった場合エラーとなる。
.SH "POSIX 詳細"
2つ目の形式では
.I ugly_time
が時刻なのかファイルを指定する引数なのかはっきりしないという不利な面がある。\-r もしくは \-t
オプションを指定せず、少なくても2つの引数を指定し、最初の引数が8桁もしくは10桁の10進数
である場合には時刻として見做す。
.I ugly_time
の書式は MMDDhhmm[yy] で、yyは69-99の範囲で指定し1969年から1999年を表す。
yyが指定されない場合は現在の年をあらわす。
この書式は今後使われない。
.SH "GNU 詳細"
最初の
.I file
が
.B "\-t"
に対する有効な引数で、
.BR "\-d" ,
.BR "\-r" ,
もしくは
.B "\-t"
オプションで時刻を指定せず、また `--' を指定しない場合、その引数はファイル名としてではなく
その他のファイルの時刻として解釈される。
.PP
.B touch
コマンドでファイルのアクセス時間や修正時間を現在時刻に変更する場合、
実行するユーザーはファイルの所有者でなくても、そのファイルに対する書き込みアクセス権があれば良い。
そうでない場合には、そのファイルの所有者である必要がある。
.SH "GNU オプション"
.TP
.B "\-a, \-\-time=atime, \-\-time=access, \-\-time=use"
アクセス時刻のみ変更する。
.TP
.B "\-c, \-\-no\-create"
指定したファイルが存在しない場合、作成しない。
.TP
.BI "\-d, \-\-date=" time
現在時刻の代わりに、
.I time
で指定した時刻を使う。月の名前や、タイムゾーン、`am' や `pm'、等を含めることができる。
.TP
.B "\-f"
無視される; BSD 版の
.BR touch (1)
との互換性のために用意されている。
.TP
.B "\-m, \-\-time=mtime, \-\-time=modify"
修正時刻のみを変更する。
.TP
.BI "\-r " file ", \-\-reference=" file
現在時刻の代わりに、参照用に指定した
.I file
の時刻を使う。
.SH "GNU 標準オプション"
.TP
.B "\-\-help"
標準出力に使用方法のメッセージを出力して正常終了する。
.TP
.B "\-\-version"
標準出力にバージョン情報を出力して正常終了する。
.TP
.B "\-\-"
オプションリストを終了する。
.SH "環境変数"
変数 TZ が明示的に与えられた時刻を解釈するのに使われる。
変数 LANG, LC_ALL, LC_CTYPE, LC_MESSAGES が通常の意味を持つ。
.SH "準拠"
POSIX 1003.2 では \-t オプションの引数の書式が GNU での実装で使われているものとは違っている。
.SH "注意"
このページでは fileutils-4.0 パッケージでの
.B touch
コマンドについて説明している;
その他のバージョンでは少し違いがあるかもしれない。修正や
追加は aeb@cwi.nl と aw@mail1.bet1.puv.fi そして ragnar@lightside.ddns.org
宛てメイルしてください。プログラムのバグについては bug-fileutils@gnu.org
へ報告してください。