touch(1)                         DG/UX R4.11                        touch(1)


NAME
       touch - update access and modification times of a file

SYNOPSIS
       touch [ -amc ] [-r reffile | -t time] files
       touch [ -amc ] [ mmddhhmm[yy] ] files

DESCRIPTION
       Touch updates the access and modification times of each argument. You
       must be the owner of the file or a user with the appropriate
       privilege to access an existing file.  The filename is created if it
       does not exist.  If no time is specified the current time is used.
       (See date(1) for a description of the second synopsis' time format.)

       Options are:

       -a      Update only the access time.

       -m      Update only the modification time.

               If neither -a nor -m is specified, the effect is the same as
               -am.

       -c      Silently prevent touch from creating the file if it did not
               previously exist.

       -r reffile
               Use the corresponding time of reffile instead of the current
               time.

       -t time Use time instead of the current time. time is a decimal
               number of the form:
                       [[CC]YY]MMDDhhmm[.SS]

               where each two digits represent the following:
                           MM   month of the year (01-12)
                           DD   day of the month (01-31)
                           hh   hour of the day (00-23)
                           mm   minute of the hour (00-59)
                           CC   first two digits of the year (the century)
                           YY   second two digits of the year
                           SS   second of the minute (0-61)

               CC and YY are optional.  If neither is given, the current
               year is assumed.  If YY is specified, but CC is not, CC is
               derived as follows:
                           If YY is:   CC becomes:
                           ------------------------
                             69-99         19
                             00-68         20

               The range for SS is (00-61), 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 shall be one or two seconds after a time where
               SS is 59. If SS is not given it is assumed to be zero.

DIAGNOSTICS
       The following exit values are returned:

        0     The utility executed successfully and all requested changes
              were made.

       >0     An error occurred.

SEE ALSO
       date(1).
       utime(2)

NOTES
       The -t time option should be used in preference to the second
       synopsis usage, since the second synopsis may not be supported in
       future releases.


Licensed material--property of copyright holder(s)