manpages.info - online man pages   

Mac OS X / Darwin man pages : utime (3)
utime (3)

Table of Contents

Name

utime - set file times

Library

Standard C Library (libc, -lc)

Synopsis

#include <utime.h>

int
utime(const char *file, const struct utimbuf *timep);

Description

This interface is obsoleted by utimes(2) .

The utime() function sets the access and modification times of the named file from the structures in the argument array timep.

If the times are specified (the timep argument is non-NULL) the caller must be the owner of the file or be the super-user.

If the times are not specified (the timep argument is NULL) the caller must be the owner of the file, have permission to write the file, or be the super-user.

Errors

The utime() function may fail and set errno for any of the errors specified for the library function utimes(2) .

See Also

stat(2) , utimes(2)

History

A utime() function appeared in Version 7 AT&T UNIX.

Standards

The utime() function conforms to IEEE Std 1003.1-1988 (``POSIX.1'').


Table of Contents