'\" te
.\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved
.\" Copyright 1989 AT&T
.\" Portions Copyright (c) 2009, 2010, Oracle and/or its affiliates. All rights reserved.
.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at http://www.opengroup.org/bookstore/. 
.\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. This notice shall appear on any product containing this material.
.TH touch 1 "2010 年 11 月 8 日" "SunOS 5.11" "ユーザーコマンド"
.SH 名前
touch, settime \- ファイルのアクセス日時および更新日時の変更
.SH 形式
.LP
.nf
\fBtouch\fR [\fB-acm\fR] [\fB-r\fR \fIref_file\fR | \fB-t\fR \fItime\fR | \fB-d\fR \fIdate_time\fR] \fIfile\fR...
.fi

.LP
.nf
\fBtouch\fR [\fB-acm\fR] [\fItime_spec\fR] \fIfile\fR...
.fi

.LP
.nf
\fBsettime\fR [\fB-f\fR \fIref_file\fR] [\fItime_spec\fR] \fIfile\fR...
.fi

.SH 機能説明
.sp
.LP
\fBtouch\fR ユーティリティーは、各ファイルのアクセス日時または更新日時を設定します。指定した \fIfile\fR が存在しない場合には、file が作成されます。
.sp
.LP
新たに設定する日時は、\fB-t\fR \fItime\fR、\fB-d\fR \fIdate_time\fR、\fB-r\fR \fIref_file\fR に指定したファイルの時間フィールド、または \fItime_spec\fR オペランドによって指定できます。これらのオプションを 1 つも指定しない場合、\fBtouch\fR は現在の日時を使用します。
.sp
.LP
\fB-a\fR オプションと \fB-m\fR オプションの両方が省略された場合、\fBtouch\fR は更新日時とアクセス日時の両方を更新します。
.sp
.LP
ファイルへの書き込み権を持つが、そのファイルの所有者ではなく、スーパーユーザーでもないユーザーは、ファイルの更新日時とアクセス日時を現在の日時にだけ変更できます。\fBtouch\fR で特定の日時に設定しようとするとエラーになります。
.sp
.LP
\fBsettime\fR ユーティリティーは、\fBtouch\fR \fB-c\fR [\fItime_spec\fR] \fIfile\fR と同等です。
.SH オプション
.sp
.LP
\fBtouch\fR および \fBsettime\fR には、次のオプションがサポートされています。
.SS "touch"
.sp
.LP
\fBtouch\fR には、次のオプションがサポートされています。
.sp
.ne 2
.mk
.na
\fB\fB-a\fR\fR
.ad
.sp .6
.RS 4n
\fIfile\fR のアクセス日時だけを変更します。\fB-m\fR オプションも同時に指定された場合を除き、 更新日時は変更しません。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-c\fR\fR
.ad
.sp .6
.RS 4n
\fIfile\fR が示す名前のファイルが存在しない場合、そのファイルを作成しません。また、この状態についての診断メッセージを出力しません。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-d\fR \fIdate_time\fR\fR
.ad
.sp .6
.RS 4n
現在の日時の代わりに date_time を使用します。オプション引数には次の形式の文字列を指定してください。
.sp
.in +2
.nf
\fIYYYY\fR-\fIMM\fR-\fIDDThh\fR:\fImm\fR:\fISS\fR[.\fIfrac\fR][\fItz\fR]
.fi
.in -2
.sp

または
.sp
.in +2
.nf
\fIYYYY\fR-\fIMM\fR-\fIDDThh\fR:\fImm\fR:\fISS\fR[,\fIfrac\fR][\fItz\fR]
.fi
.in -2
.sp

各情報の意味は次のとおりです。
.RS +4
.TP
.ie t \(bu
.el o
\fIYYYY\fR には、西暦年を表す 4 桁の 10 進数を指定する必要があります。
.RE
.RS +4
.TP
.ie t \(bu
.el o
\fIMM\fR、\fIDD\fR、\fIhh\fR、\fImm\fR、および \fISS\fR は、\fB-t\fR \fItime\fR と同様です
.RE
.RS +4
.TP
.ie t \(bu
.el o
\fIT\fR には文字 \fBT\fR または 1 つのスペース文字を指定します。
.RE
.RS +4
.TP
.ie t \(bu
.el o
[\fI\&.frac\fR] および [\fI,frac\fR] には、空あるいはそれぞれピリオド (\fB\&.\fR) またはコンマ (\fB,\fR) のあとに 1 桁以上の 10 進数を続けて、小数点以下の秒を指定します
.RE
.RS +4
.TP
.ie t \(bu
.el o
[\fItz\fR] は、ローカルの日時を示す空にするか、UTC を示す文字 \fBZ\fR にします。[\fItz\fR] を空にすると、結果として得られる日時の値は環境変数 \fBTZ\fR の値の影響を受けます。
.RE
.RE

.sp
.ne 2
.mk
.na
\fB\fB-m\fR\fR
.ad
.sp .6
.RS 4n
\fIfile\fR の更新日時だけを変更します。\fB-a\fR オプションも同時に指定しなければ、アクセス日時は更新しません。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-r\fR \fIref_file\fR\fR
.ad
.sp .6
.RS 4n
現在の日時の代わりに、\fIref_file\fR に指定されたファイルの日時を使用します。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-t\fR \fItime\fR\fR
.ad
.sp .6
.RS 4n
設定する日時として、現在の日時の代わりに \fI time\fR が示す値を使用します。\fItime\fR は、次の形式の 10 進数です。
.sp
.in +2
.nf
[[\fICC\fR]\fIYY\fR]\fIMMDDhhmm\fR[\fI\&.SS\fR]
.fi
.in -2
.sp

各 2 桁の値は次のような意味を持ちます。
.sp
.ne 2
.mk
.na
\fB\fIMM\fR\fR
.ad
.sp .6
.RS 4n
月 [01-12]
.RE

.sp
.ne 2
.mk
.na
\fB\fIDD\fR\fR
.ad
.sp .6
.RS 4n
日 [01-31]
.RE

.sp
.ne 2
.mk
.na
\fB\fIhh\fR\fR
.ad
.sp .6
.RS 4n
時 [00-23]
.RE

.sp
.ne 2
.mk
.na
\fB\fImm\fR\fR
.ad
.sp .6
.RS 4n
分 [00-59]
.RE

.sp
.ne 2
.mk
.na
\fB\fICC\fR\fR
.ad
.sp .6
.RS 4n
西暦年の上 2 桁
.RE

.sp
.ne 2
.mk
.na
\fB\fIYY\fR\fR
.ad
.sp .6
.RS 4n
西暦年の下 2 桁
.RE

.sp
.ne 2
.mk
.na
\fB\fISS\fR \fR
.ad
.sp .6
.RS 4n
秒 [00-61]
.RE

\fICC\fR と \fIYY\fR はともにオプションです。両方とも省略すると、現在の年と見なされます。\fIYY\fR を指定して \fICC\fR を省略すると、\fICC\fR は次に示す値と見なされます。
.sp

.sp
.TS
tab() box;
cw(2.75i) cw(2.75i) 
lw(2.75i) lw(2.75i) 
.
YY の値CC のデフォルト
_
69-9919
00-3820
39-68エラー
.TE

結果として得られる日時の値は、環境変数 \fBTZ\fR の値の影響を受けます。許される日時の値の範囲は、 1970 年 1 月 1 日 0 時 0 分 0 秒 (グリニッジ標準時) 以後から 2038 年 1 月 18 日までです。
.sp
\fISS\fR の範囲は、 [00-59] ではなく [00-61] です。これはうるう秒を考慮しているためです。\fISS\fR が 60 または 61、\fBTZ\fR により加工されたあとの時間の値がうるう秒を表していない場合、結果の時間値は \fISS\fR を 59 とした時間の 1 秒後または 2 秒後となります。\fISS\fR を省略すると 0 と見なされます。
.RE

.SS "settime"
.sp
.LP
\fBsettime\fR ユーティリティーには、次のオプションがサポートされています。
.sp
.ne 2
.mk
.na
\fB\fB-f\fR \fIref_file\fR\fR
.ad
.sp .6
.RS 4n
現在の日時の代わりに、\fIref_file\fR に指定されたファイルの日時を使用します。
.RE

.SH オペランド
.sp
.LP
\fBtouch\fR および \fBsettime\fR には、 次のオペランドがサポートされています。
.sp
.ne 2
.mk
.na
\fB\fIfile\fR\fR
.ad
.sp .6
.RS 4n
日時を変更するファイルのパス名
.RE

.sp
.ne 2
.mk
.na
\fB\fItime_spec\fR\fR
.ad
.sp .6
.RS 4n
設定する日時として、現在の日時の代わりに \fItime_spec\fR が示す値を使用します。このオペランドは、次の形式の 10 進数です。
.sp
.in +2
.nf
\fIMMDDhhmm\fR[\fIYY\fR]
.fi
.in -2
.sp

各 2 桁の値は次のような意味を持ちます。
.sp
.ne 2
.mk
.na
\fB\fIMM\fR\fR
.ad
.sp .6
.RS 4n
月 [01-12]
.RE

.sp
.ne 2
.mk
.na
\fB\fIDD\fR\fR
.ad
.sp .6
.RS 4n
日 [01-31]
.RE

.sp
.ne 2
.mk
.na
\fB\fIhh\fR\fR
.ad
.sp .6
.RS 4n
時 [00-23]
.RE

.sp
.ne 2
.mk
.na
\fB\fImm\fR\fR
.ad
.sp .6
.RS 4n
分 [00-59]
.RE

.sp
.ne 2
.mk
.na
\fB\fIYY\fR\fR
.ad
.sp .6
.RS 4n
西暦年の下 2 桁
.sp
\fIYY\fR はオプションです。これを省略すると、現在の年と見なされます。\fIYY\fR を指定すると、 年は次に示す値と見なされます。
.RE

.sp

.sp
.TS
tab() box;
cw(2.75i) cw(2.75i) 
lw(2.75i) lw(2.75i) 
.
YY対応する年
69-991969-1999
00-382000-2038
39-68エラー
.TE

\fB-d\fR、\fB-r\fR、または \fB-t\fR オプションを省略し、少なくとも 2 つのオペランドを指定し、そのうちの先頭のオペランドの値が 8 または 10 桁の 10 進数である場合、その先頭オペランドは \fItime_spec\fR であると見なされます。それ以外の場合には、先頭オペランドは \fIfile\fR であると見なされます。
.RE

.SH 使用法
.sp
.LP
ファイルが 2G バイト (2^31 バイト) 以上ある場合の \fBtouch\fR の動作については、\fBlargefile\fR(5) を参照してください。
.SH 環境
.sp
.LP
\fBtouch\fR の実行に影響を与える次の環境変数についての詳細は、\fBenviron\fR(5) を参照してください。\fBLANG\fR、\fBLC_ALL\fR、\fBLANG\fR、\fBLC_ALL\fR、\fBLC_CTYPE\fR、\fBLC_MESSAGES\fR、および \fBNLSPATH\fR。
.sp
.ne 2
.mk
.na
\fB\fBTZ\fR\fR
.ad
.sp .6
.RS 4n
\fItime\fR または \fIdate_time\fR オプション引数や \fItime_spec\fR オペランドに適用するタイムゾーンを指定します。
.RE

.SH 終了ステータス
.sp
.LP
次の終了ステータスが返されます。
.sp
.ne 2
.mk
.na
\fB\fB0\fR\fR
.ad
.sp .6
.RS 4n
\fBtouch\fR の実行が正常終了し、要求されたすべての変更が行われた。
.RE

.sp
.ne 2
.mk
.na
\fB>\fB0\fR\fR
.ad
.sp .6
.RS 4n
エラーが発生した。\fBtouch\fR は、日時の変更を実施できなかったファイルの数を返す。
.RE

.SH 属性
.sp
.LP
属性についての詳細は、マニュアルページの \fBattributes\fR(5) を参照してください。
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
属性タイプ属性値
_
使用条件system/core-os
_
CSI有効
_
インタフェースの安定性確実
_
標準T{
\fBstandards\fR(5) を参照してください。
T}
.TE

.SH 関連項目
.sp
.LP
\fBfutimens\fR(2), \fBstat\fR(2), \fBattributes\fR(5), \fBenviron\fR(5), \fBlargefile\fR(5), \fBstandards\fR(5)
.SH 注意事項
.sp
.LP
BSD 環境に精通しているユーザーであれば、\fB-f\fR オプションが \fBtouch\fR に受け入れられたのに f オプションが無視されることに気づきます。ファイル上のアクセス権にかかわりなく、\fBtouch\fR は ユーザーが所有するすべてのファイルに対して成功するので、\fB-f\fR オプションは不要です。