|
Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!
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] [date_time] 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.
A user with write access to a file, but who is not the owner
of the file or a super-user, can change the modification and
access times of that file only to the current time. Attempts
to set a specific time with touch will result in an error.
The settime utility is equivalent to touch -c [date_time]
file.
OPTIONS
The following options are supported in the touch and settime
utilities:
touch
The following options are supported for the touch utility:
-a Changes the access time of file. Does not
change the modification time unless -m is
also specified.
-c Does not create a specified file if it does
not exist. Does not write any diagnostic
messages concerning this condition.
SunOS 5.10 Last change: 22 Jun 2001 1
User Commands touch(1)
-m Changes the modification time of file. Does
not change the access time unless -a is also
specified.
-r ref_file Uses the corresponding times of the file
named by ref_file instead of the current
time.
-t time Uses the specified time instead of the
current time. time will be a decimal number
of the form:
[[CC]YY]MMDDhhmm[.SS]
where each two digits represent the follow-
ing:
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
SunOS 5.10 Last change: 22 Jun 2001 2
User Commands touch(1)
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 resulting 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 Uses the corresponding times of the file
named by ref_file instead of the current
time.
OPERANDS
The following operands are supported for the touch and set-
time utilities:
file A path name of a file whose times are to be
modified.
date_time Uses the specified date_time instead of the
current time. This operand is a decimal
number of the form:
SunOS 5.10 Last change: 22 Jun 2001 3
User Commands touch(1)
MMDDhhmm[YY]
where each two digits represent the follow-
ing:
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 specified, 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
SunOS 5.10 Last change: 22 Jun 2001 4
User Commands touch(1)
Gbyte ( 2**31 bytes).
ENVIRONMENT VARIABLES
See environ(5) for descriptions of the following environment
variables that affect the execution of touch: LANG, LC_ALL,
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
successfully modified.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWcsu |
|_____________________________|_____________________________|
| CSI | enabled |
|_____________________________|_____________________________|
| Interface Stability | Standard |
|_____________________________|_____________________________|
SEE ALSO
time(2), attributes(5), environ(5), largefile(5), stan-
dards(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.10 Last change: 22 Jun 2001 5
Man(1) output converted with
man2html and wrapped by fishsponge
This page was generated on Wed Sep 12 11:25:34 GMT 2007
|
Your favourite pages:
No pages logged yet.
Trying to save cookie... Top 10 most popular pages:
sqlite3 man page (5052 hits)
(openSUSE 10.2)
adv_cap_autoneg man page (4731 hits)
(Solaris 10 11_06)
CPAN man page (4447 hits)
(Suse Linux 10.1)
ssh man page (4240 hits)
(Suse Linux 10.1)
svn man page (4098 hits)
(FreeBSD 6.2)
startproc man page (2154 hits)
(Suse Linux 10.1)
ssh-socks5-proxy-connect man page (2091 hits)
(Solaris 10 11_06)
netcat man page (2081 hits)
(Suse Linux 10.1)
signal man page (1945 hits)
(Suse Linux 10.1)
pprosetup man page (1943 hits)
(Solaris 10 11_06)
|
Man Pages 
