d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

MFC r268212:

Browse Source 
Note that most errors are possible for all syscalls from utimes(2)
family.  Minor wording corrections.
This commit is contained in:
kib 2014-07-10 09:09:37 +00:00
parent eb437edaac
commit 8674b3c2aa
1 changed files with 20 additions and 46 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

66
lib/libc/sys/utimes.2
View File

@ -30,7 +30,7 @@
.\" @(#)utimes.2 8.1 (Berkeley) 6/4/93
.\" $FreeBSD$
.\"
.Dd April 10, 2008
.Dd July 3, 2014
.Dt UTIMES 2
.Os
.Sh NAME
@ -119,22 +119,18 @@ is passed the special value
.Dv AT_FDCWD
in the
.Fa fd
parameter, the current working directory is used and the behavior is identical to
a call to
parameter, the current working directory is used and the behavior
is identical to a call to
.Fn utimes .
.Sh RETURN VALUES
.Rv -std
.Sh ERRORS
The
.Fn utimes
and
.Fn lutimes
system calls
will fail if:
All of the system call will fail if:
.Bl -tag -width Er
.It Bq Er EACCES
Search permission is denied for a component of the path prefix;
or the
Search permission is denied for a component of the path prefix.
.It Bq Er EACCES
The
.Fa times
argument is
.Dv NULL
@ -148,6 +144,17 @@ or
.Fa times
argument
points outside the process's allocated address space.
.It Bq Er EFAULT
The
.Fa times
argument
points outside the process's allocated address space.
.It Bq Er EINVAL
The
.Va tv_usec
component of at least one of the values specified by the
.Fa times
argument has a value less than 0 or greater than 999999.
.It Bq Er EIO
An I/O error occurred while reading or writing the affected inode.
.It Bq Er ELOOP
@ -170,7 +177,8 @@ argument is not
and the calling process's effective user ID
does not match the owner of the file and is not the super-user.
.It Bq Er EPERM
The named file has its immutable or append-only flag set, see the
The named file has its immutable or append-only flags set.
See the
.Xr chflags 2
manual page for more information.
.It Bq Er EROFS
@ -189,40 +197,6 @@ argument
does not refer to a valid descriptor.
.El
.Pp
All of the system calls will fail if:
.Bl -tag -width Er
.It Bq Er EACCES
The
.Fa times
argument is
.Dv NULL
and the effective user ID of the process does not
match the owner of the file, and is not the super-user, and write
access is denied.
.It Bq Er EFAULT
The
.Fa times
argument
points outside the process's allocated address space.
.It Bq Er EINVAL
The
.Va tv_usec
component of at least one of the values specified by the
.Fa times
argument has a value less than 0 or greater than 999999.
.It Bq Er EIO
An I/O error occurred while reading or writing the affected inode.
.It Bq Er EPERM
The
.Fa times
argument is not
.Dv NULL
and the calling process's effective user ID
does not match the owner of the file and is not the super-user.
.It Bq Er EROFS
The file system containing the file is mounted read-only.
.El
.Pp
In addition to the errors returned by the
.Fn utimes ,
the