名前 | 形式 | 機能説明 | オプション | オペランド | 使用法 | 環境 | 終了ステータス | 属性 | 関連項目 | 注意事項
touch ユーティリティは、各ファイルのアクセス日時または更新日時を設定します。 指定した file が存在しない場合には、file が作成されます。
新たに設定する日時は、 -t time、 -r ref_file に指定したファイルの時刻フィールド、 または date_time オペランドによって、指定することができます。 これらのオプションやオペランドを 1 つも指定しない場合には、 touch は、 time(2) 関数によって返される現在の日時を設定します。
-a オプションと -m オプションの両方が省略された場合、touch は更新日時とアクセス日時の両方を更新します。
ファイルへの書き込み権を持つが、そのファイルの所有者ではなく、スーパーユーザーでもないユーザーは、ファイルの更新日時とアクセス日時を現在の日時にだけ変更できます。touch で特定の日時に設定しようとするとエラーになります。
settime ユーティリティは、touch -c [date_time] file と同等です。
touch には、以下のオプションを指定できます。
file のアクセス日時だけを変更します。 -m オプションも同時に指定された場合を除き、 更新日時は変更しません。
file が示す名前のファイルが存在しない場合、そのファイルを作成しません。 また、この状態についての診断メッセージを出力しません。
file の更新日時だけを変更します。-a オプションも同時に指定しなければ、アクセス日時は更新しません。
設定する日時として、現在の日時の代わりに ref_file が示すファイルの日時を使用します。
設定する日時として、現在の日時の代わりに time が示す値を使用します。 time は以下の形式の 10 進数です。
[[CC]YY]MMDDhhmm [.SS]
各 2 桁の値は次のような意味を持ちます。
MM 月 [01-12]
日 [01-31]
時 [00-23]
分 [00-59]
西暦年の上 2 桁
西暦年の下 2 桁
秒 [00-61]
CC と YY はともに省略可能です。両方とも省略すると、現在の年と見なされます。 YY を指定して CC を省略すると、 CC は以下に示す値と見なされます。
YY の値 | CC のデフォルト |
---|---|
69-99 | 19 |
00-38 | 20 |
39-68 | エラー |
結果として得られる日時の値は、環境変数 TZ の値によって影響を受けます。日時の値が 1970 年 1 月 1 日 0 時 0 分 0 秒 (グリニッジ標準時) 以前を示しているとき、touch はエラーとなりただちに実行を終了します。 許される日時の値の範囲は、 1970 年 1 月 1 日 0 時 0 分 0 秒 (グリニッジ標準時) 以後から 2038 年 1 月 18 日までです。
SS の範囲は、 [00-59] ではなく [00-61] です。これはうるう秒を考慮しているためです。 SS が 60 または 61、TZ により加工された後の時刻の値がうるう秒を表していない場合、結果の時刻値は SS を 59 とした時刻の 1 秒後 または 2 秒後となります。 SS を省略すると 0 と見なされます。
touch および settime には、 以下のオペランドを指定できます。
日時を変更するファイルのパス名
現在の日時の代わりに date_time を使用します。date_time は以下の形式の 10 進数です。
MMDDhhmm[YY]
日時を変更するファイルのパス名。
MM 月 [01-12]
日 [01-31]
時 [00-23]
分 [00-59]
西暦年の下 2 桁。
YY は省略可能です。省略すると、現在の年と見なされます。 YY を指定すると、 年は以下に示す値と見なされます。
YY | 対応する年 |
---|---|
69-99 | 1969-1999 |
00-38 | 2000-2038 |
39-68 | エラー |
-r オプションと -t オプションの両方を省略し、最低 2 つのオペランドが指定され、そのうちの先頭のオペランドの値が 8 または 10 桁の 10 進数であるとき、その先頭オペランドは date_time であると見なされます。それ以外の場合には、先頭オペランドは file であると見なされます。
ファイルが 2 ギガバイト (231 バイト) 以上ある場合の touch の動作については、 largefile(5) を参照してください。
touch の実行に影響を与える環境変数 LANG、LC_ALL、LC_CTYPE、LC_MESSAGES、NLSPATH についての詳細は、 environ(5) を参照してください。
time オプション引数 や date_time オペランド に適用するタイムゾーンを指定します。
次の属性については attributes(5) のマニュアルページを参照してください。
属性タイプ | 属性値 |
---|---|
使用条件 | SUNWcsu |
CSI | 対応済み |
BSD 環境に熟知しているユーザーは、 -f オプションが touch に 受け入れられたのに -f オプションは無視されることに気づくでしょう。 ファイル上のアクセス権にかかわりなく、 touch は ユーザーが所有するすべてのファイルに対して成功するので、 -f オプションは不要です。
名前 | 形式 | 機能説明 | オプション | オペランド | 使用法 | 環境 | 終了ステータス | 属性 | 関連項目 | 注意事項