touch.1 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

touch(1) touch(1)

NAME

touch - update access, modiﬁcation, and/or change times of ﬁle

SYNOPSIS

touch [-amc][-r

ref_ﬁle | -t time] ﬁle_name ...

Obsolescent

touch time_str ﬁle_name ...

DESCRIPTION

touch updates the access, modiﬁcation, and last-change times of each argument. The ﬁle name is

created if it does not exist. If no time is speciﬁed (see date (1)) the current time is used.

The

-r and -t options are mutually exclusive.

Options

The following options are available:

-a Change the access time of ﬁle_name to time , or to the current time if time is not

speciﬁed. Do not change the modiﬁcation time unless

-m is also speciﬁed.

-m Change the modiﬁcation time of ﬁle_name to time, or to the current time if time is

not speciﬁed. Do not change the access time unless

-a is also speciﬁed.

-c Silently prevent touch from creating the ﬁle if it did not previously exist. Do not

write any diagnostic messages concerning this condition.

-r ref_file Use the corresponding time of ref_ﬁle instead of the current time.

-t time Use the speciﬁed time instead of the current time. The option argument is a

decimal number of the form:

[[CC]YY]MMDDhhmm[

.SS]

where each two digits represents the following:

CC The ﬁrst two digits of the year.

YY The second two digits of the year.

MM The month of the year (01-12).

DD The day of the month (01-31).

hh The hour of the day (00-23).

mm The minute of the hour (00-59).

SS The second of the minute (00-61).

If neither CC nor YY is given, the current year is assumed. If YY is speciﬁed, but

CC is not, CC is derived as follows: (taken into account the local time factor)

If YY is: CC becomes:

69-99 19

00-68 20

If the resulting time value precedes the Epoch (00:00:00 January 1, 1970 Greenwich

Mean Time),

touch exits immediately with an error status.

The range for SS is 00 through 61 rather than 00 through 59 to accommodate leap

seconds. If SS is 60 or 61, and the resulting time, as affected by the

TZ environ-

ment variable, does not refer to a leap second, the resulting time is one second after

a time where SS is 59. If SS is not given a value, it is assumed to be 0.

The syntax shown by the second SYNOPSIS line is recognized when neither the

-r option, the -t

option, nor the -- option delimiter is speciﬁed, and the ﬁrst operand consists of all decimal digits. This

operand is interpreted as the time argument instead of as a ﬁle name. However, in this case, time_str is

assumed to be of the form:

MMDDhhmm[YY]

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
touch(1) touch(1) NAME touch - update access, modification, and/or change times of file SYNOPSIS touch [-amc] [-r ref_file | -t time ] file_name ... Obsolescent touch time_str file_name ... DESCRIPTION touch updates the access, modification, and last-change times of each argument. The file name is created if it does not exist. If no time is specified (see date (1)) the current time is used. The -r and -t options are mutually exclusive.
PAGE 2
touch(1) touch(1) This is for backward compatibility. The -t form given above is recommended for future portability. The -- option delimiter can be used before the first file_name if there is a possibility that file_name consists of all digits, in order to ensure that the first syntax is used. touch succeeds only when invoked by the owner of the file if any of the following are true: • A time is specified. • Only the access time of the file is being updated.
PAGE 3
touch(1) touch(1) SEE ALSO date(1), utime(2). STANDARDS CONFORMANCE touch: SVID2, SVID3, XPG2, XPG3, XPG4, POSIX.
PAGE 4
(Notes) A (Notes) tA 4 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010