return 0 not null string when user has a ctty but no utmp entry
[unix-history] / usr / src / lib / libc / gen / utime.3
.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\" @(#)utime.3 6.1 (Berkeley) %G%
.\"
.TH UTIME 3C ""
.UC 4
.SH NAME
utime \- set file times
.SH SYNOPSIS
.nf
.B #include <sys/types.h>
.PP
.B utime(file, timep)
.B char *file;
.B time_t timep[2];
.fi
.SH DESCRIPTION
.ft B
This interface is obsoleted by utimes(2).
.ft R
.PP
The
.I utime
call
uses the
`accessed' and `updated' times in that order
from the
.I timep
vector
to set the corresponding recorded times for
.IR file .
.PP
The caller must be the owner of the file or the super-user.
The `inode-changed' time of the file is set to the current time.
.SH SEE ALSO
utimes(2), stat(2)