OSDN Git Service

Convert release and draft pages to UTF-8.
[linuxjm/jm.git] / manual / GNU_fileutils / release / man1 / touch.1
index 0e3a6c2..8346794 100644 (file)
 .\" 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             ¥¿¥¤¥à¥¾¡¼¥ó
+.\"WORD: timestamps            時刻(アクセス時刻と修正時刻)
+.\"WORD: access time           アクセス時刻
+.\"WORD: modification time     修正時刻
+.\"WORD: timezones             タイムゾーン
 .\"
 .TH TOUCH 1 "17 November 1998" "GNU fileutils 4.0"
-.SH "̾Á°"
-touch \- ¥Õ¥¡¥¤¥ë¤Î¥¢¥¯¥»¥¹»þ¹ï¤È½¤Àµ»þ¹ï¤òÊѹ¹¤¹¤ë
-.SH "½ñ¼°"
+.SH "名前"
+touch \- ファイルのアクセス時刻と修正時刻を変更する
+.SH "書式"
 .B touch
 .BI "[\-acm][\-r " ref_file "|\-t " time "] " file...
 .sp
-º£¸å»È¤ï¤ì¤Ê¤¯¤Ê¤ë½ñ¼°:
+今後使われなくなる書式:
 .br
 .B touch
 .BI "[\-acm][" ugly_time "] " file...
 .sp
-GNU ÈÇ:
+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 "ÀâÌÀ"
+.SH "説明"
 .B touch
-¥³¥Þ¥ó¥É¤Ï»ØÄꤷ¤¿¤½¤ì¤¾¤ì¤Î
+コマンドは指定したそれぞれの
 .IR file
-¤Î¥¢¥¯¥»¥¹»þ¹ï¡¢½¤Àµ»þ¹ï¤Þ¤¿¤Ï¤¤¤º¤ì¤«¤òÊѹ¹¤¹¤ë¡£
+のアクセス時刻、修正時刻またはいずれかを変更する。
 
-Æä˻ØÄ꤬¤Ê¤¤¾ì¹ç¤Ï¸½ºß»þ¹ï¤ËÊѹ¹¤¹¤ë¡£\-r ¥ª¥×¥·¥ç¥ó¤ò»È¤Ã¤¿¾ì¹ç¡¢
+特に指定がない場合は現在時刻に変更する。\-r オプションを使った場合、
 .IR ref_file
-¤Î»þ¹ï¤ò»È¤¤Êѹ¹¤·¡¢\-t ¥ª¥×¥·¥ç¥ó¤ò»È¤Ã¤¿¾ì¹ç¤Ë¤Ï
+の時刻を使い変更し、\-t オプションを使った場合には
 .IR time
-¤Ç»ØÄꤷ¤¿»þ¹ï¤ËÊѹ¹¤¹¤ë¡£
+で指定した時刻に変更する。
 
-\-a ¤È \-m ¥ª¥×¥·¥ç¥ó¤Î¤¤¤º¤ì¤â»ØÄꤷ¤Ê¤¤¤«¡¢Æ±»þ¤Ë»ØÄꤹ¤ë¤ÈξÊý¤Î»þ¹ï(ÌõÃí¡§¥¢¥¯¥»¥¹»þ¹ï¤È
-½¤Àµ»þ¹ï)¤òÊѹ¹¤¹¤ë¡£\-a ¤È \-m ¥ª¥×¥·¥ç¥ó¤Î¤¤¤º¤ì¤«1¤Ä¤ò»ØÄꤹ¤ë¤È¡¢¥¢¥¯¥»¥¹»þ¹ï¤â¤·¤¯¤Ï
-½¤Àµ»þ¹ï¤Î¤¤¤º¤ì¤«¤Î¤ß¤òÊѹ¹¤¹¤ë¡£ 
-.SH "POSIX ¥ª¥×¥·¥ç¥ó"
+\-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¿Ê¿ô¤Î·Á¼°¤Ç»ØÄꤹ¤ë¡£
+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¤ÄÌܤηÁ¼°¤Ç¤Ï
+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¿Ê¿ô
-¤Ç¤¢¤ë¾ì¹ç¤Ë¤Ï»þ¹ï¤È¤·¤Æ¸«Ðö¤¹¡£
+が時刻なのかファイルを指定する引数なのかはっきりしないという不利な面がある。\-r もしくは \-t
+オプションを指定せず、少なくても2つの引数を指定し、最初の引数が8桁もしくは10桁の10進数
+である場合には時刻として見做す。
 .I ugly_time
-¤Î½ñ¼°¤Ï MMDDhhmm[yy] ¤Ç¡¢yy¤Ï69-99¤ÎÈϰϤǻØÄꤷ1969ǯ¤«¤é1999ǯ¤òɽ¤¹¡£
-yy¤¬»ØÄꤵ¤ì¤Ê¤¤¾ì¹ç¤Ï¸½ºß¤Îǯ¤ò¤¢¤é¤ï¤¹¡£
-¤³¤Î½ñ¼°¤Ïº£¸å»È¤ï¤ì¤Ê¤¤¡£
-.SH "GNU ¾ÜºÙ"
-ºÇ½é¤Î
+の書式は 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 ¥ª¥×¥·¥ç¥ó"
+コマンドでファイルのアクセス時間や修正時間を現在時刻に変更する場合、
+実行するユーザーはファイルの所有者でなくても、そのファイルに対する書き込みアクセス権があれば良い。
+そうでない場合には、そのファイルの所有者である必要がある。
+.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'¡¢Åù¤ò´Þ¤á¤ë¤³¤È¤¬¤Ç¤­¤ë¡£
+で指定した時刻を使う。月の名前や、タイムゾーン、`am' や `pm'、等を含めることができる。
 .TP
 .B "\-f"
-̵»ë¤µ¤ì¤ë; BSD ÈǤÎ
+無視される; BSD 版の
 .BR touch (1)
-¤È¤Î¸ß´¹À­¤Î¤¿¤á¤ËÍÑ°Õ¤µ¤ì¤Æ¤¤¤ë¡£
+との互換性のために用意されている。
 .TP
 .B "\-m, \-\-time=mtime, \-\-time=modify"
-½¤Àµ»þ¹ï¤Î¤ß¤òÊѹ¹¤¹¤ë¡£
+修正時刻のみを変更する。
 .TP
 .BI "\-r " file ", \-\-reference=" file
-¸½ºß»þ¹ï¤ÎÂå¤ï¤ê¤Ë¡¢»²¾ÈÍѤ˻ØÄꤷ¤¿
+現在時刻の代わりに、参照用に指定した
 .I file
-¤Î»þ¹ï¤ò»È¤¦¡£
-.SH "GNU É¸½à¥ª¥×¥·¥ç¥ó"
+の時刻を使う。
+.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 ¥Ñ¥Ã¥±¡¼¥¸¤Ç¤Î
+オプションリストを終了する。
+.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
-¤ØÊó¹ð¤·¤Æ¤¯¤À¤µ¤¤¡£
+コマンドについて説明している;
+その他のバージョンでは少し違いがあるかもしれない。修正や
+追加は aeb@cwi.nl と aw@mail1.bet1.puv.fi そして ragnar@lightside.ddns.org
+宛てメイルしてください。プログラムのバグについては bug-fileutils@gnu.org
+へ報告してください。