unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

UTIMES(2)                     System Calls Manual                    UTIMES(2)



NAME
       utimes - set file times

SYNOPSIS
       #include <&lt;sys/types.h>&gt;

       int utimes(file, tvp)
       char *file;
       struct timeval *tvp;

DESCRIPTION
       utimes()  sets  the  access and modification times of the file named by
       file.

       If tvp is NULL, the access and modification times are set to  the  cur-
       rent  time.  A process must be the owner of the file or have write per-
       mission for the file to use utimes() in this manner.

       If tvp is not NULL, it is assumed to point to an array of  two  timeval
       structures.   The  access time is set to the value of the first member,
       and the modification time is set to the value  of  the  second  member.
       Only  the  owner of the file or the super-user may use utimes() in this
       manner.

       In either case, the inode-changed time of the file is set to  the  cur-
       rent time.

RETURN VALUES
       utimes() returns:

       0      on success.

       -1     on failure and sets errno to indicate the error.

ERRORS
       EACCES         Search  permission is denied for a component of the path
                      prefix of file.

       EACCES         The effective user ID of the process is  not  super-user
                      and  not  the  owner  of  the  file, write permission is
                      denied for the file, and tvp is NULL.

       EFAULT         file or  tvp  points  outside  the  process's  allocated
                      address space.

       EIO            An  I/O  error occurred while reading from or writing to
                      the file system.

       ELOOP          Too many symbolic links were encountered in  translating
                      file.

       ENOENT         The file referred to by file does not exist.

       ENOTDIR        A  component  of the path prefix of file is not a direc-
                      tory.

       EPERM          The effective user ID of the process is  not  super-user
                      and not the owner of the file, and tvp is not NULL.

       EROFS          The  file  system  containing  the file is mounted read-
                      only.

SEE ALSO
       stat(2V)



                                21 January 1990                      UTIMES(2)