Import translated manuals from JM CVS Repository.

[linuxjm/jm.git] / manual / gnumaniak / draft / man1 / touch.1

.\" Copyright Andries Brouwer, A. Wik 1998, Ragnar Hojland Espinosa 1998-2002
.\"
.\" Japanese Version Copyright (c) 1999 Kazuyuki Tanisako
.\"         all rights reserved.
.\" Translated Sun Aug 22 12:42 JST 1999
.\"         by Kazuyuki Tanisako
.\" Updated & Modified Sat Jan 17 15:13:21 JST 2004
.\"         by Yuichi SATO <ysato444@yahoo.co.jp>
.\"
.\" 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 "18 June 2002" "GNU fileutils 4.1"
.\"O .SH NAME
.SH "̾Á°"
.\"O touch \- change file timestamps
touch \- ¥Õ¥¡¥¤¥ë¤Î¥¢¥¯¥»¥¹»þ¹ï¤È½¤Àµ»þ¹ï¤òÊѹ¹¤¹¤ë
.\"O .SH SYNOPSIS
.SH "½ñ¼°"
.B touch
.BI "[\-acm][\-r " ref_file "|\-t " time "] " file...
.sp
.\"O Obsolescent version:
º£¸å»È¤ï¤ì¤Ê¤¯¤Ê¤ë½ñ¼°:
.br
.B touch
.BI "[\-acm][" ugly_time "] " file...
.sp
.\"O GNU version:
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...
.\"O .SH DESCRIPTION
.SH "ÀâÌÀ"
.\"O .B touch
.\"O changes the access and/or modification timestamps of each
.\"O specified
.\"O .IR file .
.B touch
¥³¥Þ¥ó¥É¤Ï»ØÄꤷ¤¿¤½¤ì¤¾¤ì¤Î
.I file
¤Î¥¢¥¯¥»¥¹»þ¹ï¡¢½¤Àµ»þ¹ï¤Þ¤¿¤Ï¤¤¤º¤ì¤«¤òÊѹ¹¤¹¤ë¡£

.\"O These timestamps are changed to the current time, unless
.\"O the \-r option is specified, in which case they are changed
.\"O to the corresponding timestamps of the file
.\"O .IR ref_file ,
.\"O or the \-t option is specified, in which case they are changed
.\"O to the specified
.\"O .IR time .
Æä˻ØÄ꤬¤Ê¤¤¾ì¹ç¤Ï¸½ºß»þ¹ï¤ËÊѹ¹¤¹¤ë¡£
\-r ¥ª¥×¥·¥ç¥ó¤ò»È¤Ã¤¿¾ì¹ç¡¢
.I ref_file
¤Î»þ¹ï¤ò»È¤¤Êѹ¹¤·¡¢\-t ¥ª¥×¥·¥ç¥ó¤ò»È¤Ã¤¿¾ì¹ç¤Ë¤Ï
.I time
¤Ç»ØÄꤷ¤¿»þ¹ï¤ËÊѹ¹¤¹¤ë¡£

.\"O Both times are changed when neither or both of the \-a and \-m
.\"O options are given. Only the access or only the modification time
.\"O is changed when one of the options \-a and \-m is given.
\-a ¤È \-m ¥ª¥×¥·¥ç¥ó¤Î¤¤¤º¤ì¤â»ØÄꤷ¤Ê¤¤¤«¡¢
Ʊ»þ¤Ë»ØÄꤹ¤ë¤ÈξÊý¤Î»þ¹ï (ÌõÃí¡§¥¢¥¯¥»¥¹»þ¹ï¤È½¤Àµ»þ¹ï) ¤òÊѹ¹¤¹¤ë¡£
\-a ¤È \-m ¥ª¥×¥·¥ç¥ó¤Î¤¤¤º¤ì¤« 1 ¤Ä¤ò»ØÄꤹ¤ë¤È¡¢
¥¢¥¯¥»¥¹»þ¹ï¤â¤·¤¯¤Ï½¤Àµ»þ¹ï¤Î¤¤¤º¤ì¤«¤Î¤ß¤òÊѹ¹¤¹¤ë¡£
.\"O If the file did not exist yet, it is created (as an empty file
.\"O with mode 0666, modified by the umask), unless the \-c option is given.
¥Õ¥¡¥¤¥ë¤¬¤Þ¤À¸ºß¤·¤Ê¤¤¾ì¹ç¤Ï¡¢\-c ¥ª¥×¥·¥ç¥ó¤¬»ØÄꤵ¤ì¤Æ¤¤¤Ê¤¤¸Â¤ê¡¢
(¥â¡¼¥É 0666 ¤ò umask ¤Ç½¤Àµ¤·¤¿¥¢¥¯¥»¥¹¸¢¤Ë¤·¤Æ¡¢¶õ¤Î¥Õ¥¡¥¤¥ë¤ò) ºîÀ®¤¹¤ë¡£
.SH "POSIX ¥ª¥×¥·¥ç¥ó"
.TP
.B \-a
.\"O Change the access time of
.\"O .IR file .
.I file
¤Î¥¢¥¯¥»¥¹»þ¹ï¤Î¤ß¤òÊѹ¹¤¹¤ë¡£
.TP
.B \-c
.\"O Do not create
.\"O .IR file .
.I file
¤òºîÀ®¤·¤Ê¤¤¡£
.TP
.B \-m
.\"O Change the modification time of
.\"O .IR file .
.I file
¤Î½¤Àµ»þ¹ï¤òÊѹ¹¤¹¤ë¡£
.TP
.BI "\-r " ref_file
.\"O Use the corresponding timestamp of
.\"O .I ref_file
.\"O as the new value for the changed timestamp(s).
.I ref_file
¤Ç»ØÄꤷ¤¿¥Õ¥¡¥¤¥ë¤Î»þ¹ï¤ò»È¤¤Êѹ¹¤¹¤ë¡£
.TP
.BI "\-t " time
.\"O Use the specified time as the new value for the changed timestamp(s).
.\"O The argument is a decimal number of the form
time ¤Ç»ØÄꤷ¤¿»þ¹ï¤ò»È¤¤Êѹ¹¤¹¤ë¡£
°ú¤­¿ô¤Ï¼¡¤Î¤è¤¦¤ÊÌÀ³Î¤Ê°ÕÌ£¤ò»ý¤Ä 10 ¿Ê¿ô¤Î·Á¼°¤Ç»ØÄꤹ¤ë¡£
.br
.nf
    [[CC]YY]MMDDhhmm[.SS]
.br
.fi
.\"O with the obvious meaning. If CC is not specified, the year CCYY
.\"O is taken to be in the range 1969-2068. If YY is not specified, the current
.\"O year is taken.
CC ¤ò»ØÄꤷ¤Ê¤¤¾ì¹ç¡¢Ç¯ CCYY ¤Ï 1969-2068 ¤ÎÈϰϤȤʤë
(ÌõÃí: YY=69-99 ¤Î¾ì¹ç CC=19¡¢YY=00-68 ¤Î¾ì¹ç CC=20 ¤È¸«Ðö¤µ¤ì¤ë)¡£
YY ¤ò»ØÄꤷ¤Ê¤¤¾ì¹ç¤Ë¤Ï¡¢¸½ºß¤Îǯ¤¬»È¤ï¤ì¤ë¡£
.\"O If SS is not specified, it is taken to be 0. It may be specified
.\"O in the range 0-61 so that it is possible to refer to leap seconds.
.\"O The resulting time is taken as a time for the time zone specified by
.\"O the environment variable TZ. It is an error if the resulting time
.\"O precedes 1 January 1970.
SS ¤ò»ØÄꤷ¤Ê¤¤¾ì¹ç¡¢0 ¤È¤·¤Æ¸«Ðö¤µ¤ì¤ë¡£
¤¦¤ë¤¦Éäò»²¾È¤Ç¤­¤ë¤è¤¦¤Ë 0-61 ¤ÎÈϰϤǻØÄê¤Ç¤­¤ë¡£
·ë²Ì¤Î»þ¹ï¤Ï´Ä¶­ÊÑ¿ô TZ ¤Ë¤è¤ê»ØÄꤵ¤ì¤¿¥¿¥¤¥à¥¾¡¼¥ó¤Ç¤Î»þ¹ï¤È¤Ê¤ë¡£
·ë²Ì¤Î»þ¹ï¤¬ 1970 ǯ 1 ·î 1 Æü°ÊÁ°¤Ë¤Ê¤Ã¤¿¾ì¹ç¡¢¥¨¥é¡¼¤È¤Ê¤ë¡£
.\"O .SH "POSIX DETAILS"
.SH "POSIX ¾ÜºÙ"
.\"O The second form of invocation has the disadvantage that there is
.\"O some ambiguity as to whether
.\"O .I ugly_time
.\"O is a time or a file argument. It is taken to be a time when
.\"O no \-r or \-t option is present, there are at least two arguments,
.\"O and the first argument is an eight- or ten-digit decimal integer.
2 ¤ÄÌܤηÁ¼°¤Ç¤Ï
.I ugly_time
¤¬»þ¹ï¤Ê¤Î¤«¥Õ¥¡¥¤¥ë¤ò»ØÄꤹ¤ë°ú¤­¿ô¤Ê¤Î¤«¤Ï¤Ã¤­¤ê¤·¤Ê¤¤¤È¤¤¤¦ÉÔÍø¤ÊÌ̤¬¤¢¤ë¡£
\-r ¤â¤·¤¯¤Ï \-t ¥ª¥×¥·¥ç¥ó¤ò»ØÄꤻ¤º¡¢¾¯¤Ê¤¯¤Æ¤â 2 ¤Ä¤Î°ú¤­¿ô¤ò»ØÄꤷ¡¢
ºÇ½é¤Î°ú¤­¿ô¤¬ 8 ·å¤â¤·¤¯¤Ï 10 ·å¤Î 10 ¿Ê¿ô¤Ç¤¢¤ë¾ì¹ç¤Ë¤Ï»þ¹ï¤È¤·¤Æ¸«Ðö¤¹¡£
.\"O The format of
.\"O .I ugly_time
.\"O is MMDDhhmm[yy], where an yy in the range 69-99 denotes a year
.\"O in the range 1969-1999, and an unspecified yy denotes the current year.
.I ugly_time
¤Î½ñ¼°¤Ï MMDDhhmm[yy] ¤Ç¡¢
yy ¤Ï 69-99 ¤ÎÈϰϤǻØÄꤷ 1969 ǯ¤«¤é 1999 ǯ ¤òɽ¤¹¡£
yy ¤¬»ØÄꤵ¤ì¤Ê¤¤¾ì¹ç¤Ï¸½ºß¤Îǯ¤òɽ¤¹¡£

.\"O This form is obsolete, and \fBtouch\fR now recognizes a lone arg of 8 or 10
.\"O digits as a filename instead of a date in 'MMDDhhmm[YY]' format.
¤³¤Î½ñ¼°¤Ïº£¸å»È¤ï¤ì¤Ê¤¤¡£
¸½ºß¤Ç¤Ï \fBtouch\fR ¤Ï¡¢¥ª¥×¥·¥ç¥ó¤Î¤Ê¤¤ 8 ·å¤Þ¤¿¤Ï 10 ·å¤Î¿ô»ú¤Î°ú¤­¿ô¤ò¡¢
\&'MMDDhhmm[YY]' ¤È¤¤¤¦½ñ¼°¤ÎÆüÉդǤϤʤ¯¡¢¥Õ¥¡¥¤¥ë̾¤È¤·¤Æǧ¼±¤¹¤ë¡£
.\"O .SH "GNU DETAILS"
.SH "GNU ¾ÜºÙ"
.\"O If the first
.\"O .I file
.\"O would be a valid argument to the
.\"O .B "\-t"
.\"O option and no timestamp is given with any of the
.\"O .BR "\-d" ,
.\"O .BR "\-r"
.\"O or
.\"O .B "\-t"
.\"O options and the `--' argument is not given, that argument is
.\"O interpreted as the time for the other files instead of as a file name.
ºÇ½é¤Î
.I file
¤¬
.B "\-t"
¤ËÂФ¹¤ëÍ­¸ú¤Ê°ú¤­¿ô¤Ç¡¢¤«¤Ä
.BR "\-d" ,
.B "\-r"
¥ª¥×¥·¥ç¥ó¤Ç»þ¹ï¤ò»ØÄꤷ¤Æ¤¤¤Ê¤¤¾ì¹ç¡¢
¤Þ¤¿¤Ï
.B "\-t"
¥ª¥×¥·¥ç¥ó¤È `--' ¥ª¥×¥·¥ç¥ó¤¬»ØÄꤵ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¡¢
¤½¤Î°ú¤­¿ô¤Ï¥Õ¥¡¥¤¥ë̾¤È¤·¤Æ¤Ç¤Ï¤Ê¤¯¡¢¤½¤Î¾¤Î¥Õ¥¡¥¤¥ë¤Î»þ¹ï¤È¤·¤Æ²ò¼á¤µ¤ì¤ë¡£
.PP
.\"O If changing both the access and modification times to the current
.\"O time,
.\"O .B touch
.\"O can change the timestamps for files that the user running it does
.\"O not own but has write permission for.  Otherwise, the user must
.\"O own the files.
.B touch
¥³¥Þ¥ó¥É¤Ç¥Õ¥¡¥¤¥ë¤Î¥¢¥¯¥»¥¹»þ´Ö¤ä½¤Àµ»þ´Ö¤ò¸½ºß»þ¹ï¤ËÊѹ¹¤¹¤ë¾ì¹ç¡¢
¼Â¹Ô¤¹¤ë¥æ¡¼¥¶¡¼¤Ï¥Õ¥¡¥¤¥ë¤Î½êÍ­¼Ô¤Ç¤Ê¤¯¤Æ¤â¡¢
¤½¤Î¥Õ¥¡¥¤¥ë¤ËÂФ¹¤ë½ñ¤­¹þ¤ß¥¢¥¯¥»¥¹¸¢¤¬¤¢¤ì¤ÐÎɤ¤¡£
¤½¤¦¤Ç¤Ê¤¤¾ì¹ç¤Ë¤Ï¡¢¤½¤Î¥Õ¥¡¥¤¥ë¤Î½êÍ­¼Ô¤Ç¤¢¤ëɬÍפ¬¤¢¤ë¡£
.\"O .SH "GNU OPTIONS"
.SH "GNU ¥ª¥×¥·¥ç¥ó"
.TP
.B "\-a, \-\-time=atime, \-\-time=access, \-\-time=use"
.\"O Change the access time only.
¥¢¥¯¥»¥¹»þ¹ï¤Î¤ßÊѹ¹¤¹¤ë¡£
.TP
.B "\-c, \-\-no\-create"
.\"O Do not create files that do not exist.
»ØÄꤷ¤¿¥Õ¥¡¥¤¥ë¤¬Â¸ºß¤·¤Ê¤¤¾ì¹ç¡¢ºîÀ®¤·¤Ê¤¤¡£
.TP
.BI "\-d, \-\-date=" time
.\"O Use
.\"O .I time
.\"O instead of the current time.  It can contain month names,
.\"O timezones, `am' and `pm', etc.
¸½ºß»þ¹ï¤ÎÂå¤ï¤ê¤Ë¡¢
.I time
¤Ç»ØÄꤷ¤¿»þ¹ï¤ò»È¤¦¡£
·î¤Î̾Á°¤ä¡¢¥¿¥¤¥à¥¾¡¼¥ó¡¢`am' ¤ä `pm'¡¢Åù¤ò´Þ¤á¤ë¤³¤È¤¬¤Ç¤­¤ë¡£
.TP
.B "\-f"
.\"O Ignored; for compatibility with BSD versions of 
.\"O .BR touch (1).
̵»ë¤µ¤ì¤ë; BSD ÈǤÎ
.BR touch (1)
¤È¤Î¸ß´¹À­¤Î¤¿¤á¤ËÍÑ°Õ¤µ¤ì¤Æ¤¤¤ë¡£
.TP
.B "\-m, \-\-time=mtime, \-\-time=modify"
.\"O Change the modification time only.
½¤Àµ»þ¹ï¤Î¤ß¤òÊѹ¹¤¹¤ë¡£
.TP
.BI "\-r " file ", \-\-reference=" file
.\"O Use the times of the reference
.\"O .I file
.\"O instead of the current time.
¸½ºß»þ¹ï¤ÎÂå¤ï¤ê¤Ë¡¢»²¾ÈÍѤ˻ØÄꤷ¤¿
.I file
¤Î»þ¹ï¤ò»È¤¦¡£
.\"O .SH "GNU STANDARD OPTIONS"
.SH "GNU ɸ½à¥ª¥×¥·¥ç¥ó"
.TP
.B "\-\-help"
.\"O Print a usage message on standard output and exit successfully.
ɸ½à½ÐÎϤ˻ÈÍÑÊýË¡¤Î¥á¥Ã¥»¡¼¥¸¤ò½ÐÎϤ·¤ÆÀµ¾ï½ªÎ»¤¹¤ë¡£
.TP
.B "\-\-version"
.\"O Print version information on standard output, then exit successfully.
ɸ½à½ÐÎϤ˥С¼¥¸¥ç¥ó¾ðÊó¤ò½ÐÎϤ·¤ÆÀµ¾ï½ªÎ»¤¹¤ë¡£
.TP
.B "\-\-"
.\"O Terminate option list.
¥ª¥×¥·¥ç¥ó¥ê¥¹¥È¤ò½ªÎ»¤¹¤ë¡£
.\"O .SH ENVIRONMENT
.SH "´Ä¶­ÊÑ¿ô"
.\"O The variable TZ is used to interpret explicitly given times.
.\"O The variables LANG, LC_ALL, LC_CTYPE and LC_MESSAGES have the
.\"O usual meaning.
ÊÑ¿ô TZ ¤¬ÌÀ¼¨Åª¤ËÍ¿¤¨¤é¤ì¤¿»þ¹ï¤ò²ò¼á¤¹¤ë¤Î¤Ë»È¤ï¤ì¤ë¡£
ÊÑ¿ô LANG, LC_ALL, LC_CTYPE, LC_MESSAGES ¤¬Ä̾ï¤Î°ÕÌ£¤ò»ý¤Ä¡£
.\"O .SH "CONFORMING TO"
.SH "½àµò"
.\"O POSIX 1003.2 describes a syntax for the argument of the \-t option
.\"O that differs from that used by the GNU implementation.
POSIX 1003.2 ¤Ç¤Ï \-t ¥ª¥×¥·¥ç¥ó¤Î°ú¤­¿ô¤Î½ñ¼°¤¬
GNU ¤Ç¤Î¼ÂÁõ¤Ç»È¤ï¤ì¤Æ¤¤¤ë¤â¤Î¤È¤Ï°ã¤Ã¤Æ¤¤¤ë¡£
.\"O .SH NOTES
.SH "Ãí°Õ"
.\"O This page describes
.\"O .B touch
.\"O as found in the fileutils-4.1 package;
.\"O other versions may differ slightly. Mail corrections and additions to
.\"O aeb@cwi.nl and aw@mail1.bet1.puv.fi and ragnar@ragnar-hojland.com
.\"O Report bugs in the program to bug-fileutils@gnu.org.
¤³¤Î¥Ú¡¼¥¸¤Ç¤Ï fileutils-4.1 ¥Ñ¥Ã¥±¡¼¥¸¤Ç¤Î
.B touch
¥³¥Þ¥ó¥É¤Ë¤Ä¤¤¤ÆÀâÌÀ¤·¤Æ¤¤¤ë¡£
¤½¤Î¾¤Î¥Ð¡¼¥¸¥ç¥ó¤Ç¤Ï¾¯¤·°ã¤¤¤¬¤¢¤ë¤«¤â¤·¤ì¤Ê¤¤¡£
½¤Àµ¤äÄÉ²Ã¤Ï aeb@cwi.nl, aw@mail1.bet1.puv.fi, ragnar@ragnar-hojland.com
°¸¤Æ¤Ë¥á¡¼¥ë¤ÇÏ¢Íí¤·¤Æ¤Û¤·¤¤¡£
¥×¥í¥°¥é¥à¤Î¥Ð¥°¤Ë¤Ä¤¤¤Æ¤Ï bug-fileutils@gnu.org ¤ØÊó¹ð¤·¤Æ¤Û¤·¤¤¡£