Files
oldlinux-files/Ref-docs/syscalls/syscalls_34.html
2024-02-19 00:21:47 -05:00

43 lines
1.7 KiB
HTML

<html><!-- This HTML file has been created by texi2html 1.29
from syscalls.texi on 4 June 1994 -->
<TITLE>Syscall specifications of Linux - utime</TITLE>
<P>Go to the <A HREF="syscalls_33.html" tppabs="http://www.infran.ru/TechInfo/syscalls/syscalls_33.html">previous</A>, <A HREF="syscalls_35.html" tppabs="http://www.infran.ru/TechInfo/syscalls/syscalls_35.html">next</A> section.<P>
<H2><A NAME="SEC34" HREF="syscalls_toc.html#SEC34" tppabs="http://www.infran.ru/TechInfo/syscalls/syscalls_toc.html#SEC34">utime</A></H2>
<P>
<H3>SYNOPSIS</H3>
<P>
<CODE>int utime(const char *<VAR>filename</VAR>, struct utimbuf *<VAR>buf</VAR>);</CODE>
<P>
<H3>PARAMETERS</H3>
<P>
<VAR>filename</VAR>: [in] points to the path of the file to change.
<P>
<VAR>buf</VAR>: [in] points to the new times.
<P>
<H3>DESCRIPTION</H3>
<P>
Changes the access and modification times of a inode. The <CODE>utimbuf</CODE>
structure has the following layout:
<P>
<PRE>
struct utimbuf {
time_t actime; /* access time */
time_t modtime; /* modification time */
};
</PRE>
<P>
If <VAR>buf</VAR> is <CODE>NULL</CODE> the times are set to the current time.
<P>
<H3>RETURN VALUE</H3>
<P>
On success, returns zero. On error, returns -1 and sets <CODE>errno</CODE> to
one of the following value:
<P>
<UL>
<LI><CODE>EROFS</CODE>, <CODE>ENOTDIR</CODE>, <CODE>ENOENT</CODE>, <CODE>EFAULT</CODE>,
<CODE>ENAMETOOLONG</CODE>, <CODE>ELOOP</CODE>, <CODE>EACCESS</CODE>, <CODE>EPERM</CODE>.
</UL>
<P>
<P>Go to the <A HREF="syscalls_33.html" tppabs="http://www.infran.ru/TechInfo/syscalls/syscalls_33.html">previous</A>, <A HREF="syscalls_35.html" tppabs="http://www.infran.ru/TechInfo/syscalls/syscalls_35.html">next</A> section.<P>