dostouch

Purpose

     Changes the modification date of a DOS file.

Library

     DOS Services Library (libdos.a)

Syntax

     #include <dos.h>

     int dostouch (path, date)
     char *path;
     long date;

Description

     The dostouch subroutine changes the time of the last mod-
     ification of the file specified  by the path parameter to
     the  time  specified by  the  date  parameter.  The  time
     parameter contains a time in  a format like that returned
     by the time system call (see "time").

     If the  path parameter identifies  a file on an  AIX file
     system, the  program /bin/touch is invoked  to change the
     time.

Return Value

     Upon successful completion, a value of 0 is returned.  If
     the dostouch subroutine fails, a  value of -1 is returned
     and doserrno is set to indicate the error.

Related Information

     In  this  book:    "ctime,  localtime,  gmtime,  asctime,
     tzset," "DOS services  library," "dosstat, dosfstat," and
     "time."