SunOS man pages : settime (1)
User Commands touch(1)
NAME
touch, settime - change file access and modification times
SYNOPSIS
touch [ -acm ] [ -r ref_file | -t time ] file ...
touch [ -acm ] [ date_time ] file ...
settime [ -f ref_file ] file ...
DESCRIPTION
The touch utility sets the access and modification times of
each file. The file operand is created if it does not
already exist.
The time used can be specified by -t time, by the
corresponding time fields of the file referenced by -r
ref_file, or by the date_time operand. If none of these are
specified, touch uses the current time (the value returned
by the time(2) function).
If neither the -a nor -m options are specified, touch
updates both the modification and access times.
The settime utility is equivalent to touch -c.
OPTIONS
touch
The following options are supported for the touch utility:
-a Change the access time of file. Do not change the
modification time unless -m is also specified.
-c Do not create a specified file if it does not exist.
Do not write any diagnostic messages concerning this
condition.
-m Change the modification time of file. Do not change
the access time unless -a is also specified.
-r ref_file
Use the corresponding times of the file named by
ref_file instead of the current time.
-t time
Use the specified time instead of the current time.
time will be a decimal number of the form:
[[CC]YY]MMDDhhmm [.SS]
SunOS 5.8 Last change: 2 Mar 1998 1
User Commands touch(1)
where each two digits represents the following:
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].
CC The first two digits of the year.
YY The second two digits of the year.
SS The second of the minute [00-61].
Both CC and YY are optional. If neither is given, the
current year will be assumed. If YY is specified, but CC is
not, CC will be derived as follows:
____________________________________________________________
| If YY is: CC becomes: |
| 69-99 19 |
| 00-38 20 |
| 39-68 ERROR |
|___________________________________________________________|
The resulting time will be affected by the value of the TZ
environment variable. If the resulting time value precedes
the Epoch, touch will exit immediately with an error status.
The range of valid times is the Epoch to January 18, 2038.
The range for SS is [00-61] rather than [00-59]
because of leap seconds. If SS is 60 or 61, and the
resulting time, as affected by the TZ environment
variable, does not refer to a leap second, the result-
ing time will be one or two seconds after a time where
SS is 59. If SS is not given, it is assumed to be 0.
settime
The following option is supported for the settime utility:
-f ref_file
Use the corresponding times of the file named by
ref_file instead of the current time.
OPERANDS
The following operand is supported for the touch and settime
utilities:
SunOS 5.8 Last change: 2 Mar 1998 2
User Commands touch(1)
file A path name of a file whose times are to be modified.
touch
The following operand is supported for the touch utility:
date_time
Use the specified date_time instead of the current
time. This operand is a decimal number of the form:
MMDDhhmm[YY]
where each two digits represent the following:
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].
YY The second two digits of the year.
YY is optional. If it is omitted, the current
year will be assumed. If YY is specified, the
year will be derived as follows:
____________________________________________________________
| YY Corresponding Year |
| 69-99 1969-1999 |
| 00-38 2000-2038 |
| 39-68 ERROR |
|___________________________________________________________|
If no -r option is specified, no -t option is speci-
fied, at least two operands are specified, and the
first operand is an eight- or ten-digit decimal
integer, the first operand will be assumed to be a
date_time operand; otherwise, the first operand will
be assumed to be a file operand.
USAGE
See largefile(5) for the description of the behavior of
touch when encountering files greater than or equal to 2
Gbyte ( 2**31 bytes).
ENVIRONMENT VARIABLES
SunOS 5.8 Last change: 2 Mar 1998 3
User Commands touch(1)
See environ(5) for descriptions of the following environment
variables that affect the execution of touch: LANG, LC_ALL,
LC_CTYPE, LC_MESSAGES, and NLSPATH.
TZ Determine the timezone to be used for interpreting the
time option-argument or the date_time operand.
EXIT STATUS
The following exit values are returned:
0 The touch utility executed successfully and all
requested changes were made.
>0 An error occurred. The touch utility returned the
number of files for which the times could not be suc-
cessfully modified.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWcsu |
|_____________________________|_____________________________|
| CSI | enabled |
|_____________________________|_____________________________|
SEE ALSO
time(2), attributes(5), environ(5), largefile(5)
NOTES
Users familiar with the BSD environment will find that for
the touch utility the -f option is accepted but ignored. The
-f option is unnecessary because touch will succeed for all
files owned by the user regardless of the permissions on the
files.
SunOS 5.8 Last change: 2 Mar 1998 4
|
 |
|
|
