UTIMES(OC)

Shore Programmer's Manual - 2 August 96

NAME

utimes \- update registered object time stamps

SYNOPSIS

#include <sys/types.h>
#include <ShoreApp.h>
shrc Shore::utimes(const char *path, struct timeval *tvp)

DESCRIPTION

Utimes updates the time stamps of the registered object named by path. If path specifies a cross reference that, in turn, specifies an anonymous object, then an error will result.

If tvp is 0, the object's atime and mtime are set to the current time. The process must be running under the uid of the owner of the object, or must have write permission on the object to use utimes in this way.

If tvp is not 0, it is assumed to point to an array of two timeval structures. The object's atime is set to the first of these structures; the mtime is set to the second structure. The process must be running under the uid of the owner of the object to use utimes in this way.

In either case, the object's ctime is updated to the current time. In addition, utimes obtains an EX-mode (exclusive-mode) lock on the object.

VERSION

This manual page applies to Version 1.0 of theShore software.

SPONSORSHIP

The Shore project is sponsored by the Advanced Research Project Agency, ARPA order number 018 (formerly 8230), monitored by the U.S. Army Research Laboratory under contract DAAB07-92-C-Q508.