diff options
Diffstat (limited to 'usr/src/man/man2/utimes.2')
| -rw-r--r-- | usr/src/man/man2/utimes.2 | 43 |
1 files changed, 8 insertions, 35 deletions
diff --git a/usr/src/man/man2/utimes.2 b/usr/src/man/man2/utimes.2 index 57a7e977c3..66241e9709 100644 --- a/usr/src/man/man2/utimes.2 +++ b/usr/src/man/man2/utimes.2 @@ -9,13 +9,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. .\" See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH utimes 2 "1 Sep 2009" "SunOS 5.11" "System Calls" +.TH UTIMES 2 "Sep 1, 2009" .SH NAME utimes, futimesat \- set file access and modification times .SH SYNOPSIS .LP .nf -#include <sys/time.h> +#include <sys/time.h> \fBint\fR \fButimes\fR(\fBconst char *\fR\fIpath\fR, \fBconst struct timeval\fR \fItimes\fR[2]); .fi @@ -70,12 +70,10 @@ be affected. The \fButimes()\fR and \fBfutimesat()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt Search permission is denied by a component of the path prefix; or the \fItimes\fR argument is a null pointer and the effective user \fBID\fR of the process does not match the owner of the file and write access is denied. @@ -83,12 +81,10 @@ process does not match the owner of the file and write access is denied. .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIpath\fR or \fItimes\fR argument points to an illegal address. For \fBfutimesat()\fR, \fIpath\fR might have the value \fINULL\fR if the \fIfildes\fR argument refers to a valid open file descriptor. @@ -96,23 +92,19 @@ The \fIpath\fR or \fItimes\fR argument points to an illegal address. For .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 16n -.rt A signal was caught during the execution of the \fButimes()\fR function. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt The number of microseconds specified in one or both of the \fBtimeval\fR structures pointed to by \fItimes\fR was greater than or equal to 1,000,000 or less than 0. @@ -120,70 +112,58 @@ less than 0. .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 16n -.rt An I/O error occurred while reading from or writing to the file system. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in resolving \fIpath\fR. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of the \fIpath\fR argument exceeds {\fIPATH_MAX\fR} or a pathname component is longer than {\fINAME_MAX\fR}. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt A component of \fIpath\fR does not name an existing file or \fIpath\fR is an empty string. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the path prefix is not a directory or the \fIpath\fR argument is relative and the \fIfildes\fR argument is not \fBAT_FDCWD\fR or does not refer to a valid directory. @@ -191,12 +171,10 @@ to a valid directory. .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 16n -.rt The \fItimes\fR argument is not a null pointer and the calling process's effective user \fBID\fR has write access to the file but does not match the owner of the file and the calling process does not have the appropriate @@ -205,12 +183,10 @@ privileges. .sp .ne 2 -.mk .na \fB\fBEROFS\fR\fR .ad .RS 16n -.rt The file system containing the file is read-only. .RE @@ -219,12 +195,10 @@ The file system containing the file is read-only. The \fButimes()\fR and \fBfutimesat()\fR functions may fail if: .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt Path name resolution of a symbolic link produced an intermediate result whose length exceeds {\fIPATH_MAX\fR}. .RE @@ -237,15 +211,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee below. +Standard See below. .TE .sp |