Update README

[linuxjm/LDP_man-pages.git] / original / man2 / utime.2

diff --git a/original/man2/utime.2 b/original/man2/utime.2
index bb267e8..84b9003 100644 (file)
--- a/original/man2/utime.2
+++ b/original/man2/utime.2
@@ -1,7 +1,6 @@
-.\" Hey Emacs! This file is -*- nroff -*- source.
-.\"
 .\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 1992
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -21,6 +20,7 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" Modified by Michael Haardt <michael@moria.de>
 .\" Modified 1993-07-24 by Rik Faith <faith@cs.unc.edu>
@@ -28,7 +28,7 @@
 .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com>
 .\" Modified 2004-10-10 by Andries Brouwer <aeb@cwi.nl>
 .\"
-.TH UTIME 2 2008-08-06 "Linux" "Linux Programmer's Manual"
+.TH UTIME 2 2014-08-19 "Linux" "Linux Programmer's Manual"
 .SH NAME
 utime, utimes \- change file last access and modification times
 .SH SYNOPSIS
@@ -44,6 +44,10 @@ utime, utimes \- change file last access and modification times
 .BI "int utimes(const char *" filename ", const struct timeval " times [2]);
 .fi
 .SH DESCRIPTION
+.B Note:
+modern applications may prefer to use the interfaces described in
+.BR utimensat (2).
+
 The
 .BR utime ()
 system call
@@ -117,7 +121,7 @@ is NULL, then analogously to
 .BR utime (),
 the access and modification times of the file are
 set to the current time.
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 On success, zero is returned.
 On error, \-1 is returned, and
 .I errno
@@ -158,8 +162,8 @@ capability).
 .TP
 .B EROFS
 .I path
-resides on a read-only file system.
-.SH "CONFORMING TO"
+resides on a read-only filesystem.
+.SH CONFORMING TO
 .BR utime ():
 SVr4, POSIX.1-2001.
 POSIX.1-2008 marks
@@ -172,16 +176,25 @@ as obsolete.
 Linux does not allow changing the timestamps on an immutable file,
 or setting the timestamps to something other than the current time
 on an append-only file.
-
-In libc4 and libc5,
-.BR utimes ()
-is just a wrapper for
-.BR utime ()
-and hence does not allow a subsecond resolution.
-.SH "SEE ALSO"
+.\"
+.\" In libc4 and libc5,
+.\" .BR utimes ()
+.\" is just a wrapper for
+.\" .BR utime ()
+.\" and hence does not allow a subsecond resolution.
+.SH SEE ALSO
 .BR chattr (1),
 .BR futimesat (2),
 .BR stat (2),
 .BR utimensat (2),
 .BR futimens (3),
 .BR futimes (3)
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.