system/freebsd-src
system/freebsd-src
1
0
Fork 0
mirror of https://github.com/freebsd/freebsd-src synced 2024-09-06 17:18:32 +00:00
Code Issues Packages Projects Releases Wiki Activity

Note that most errors are possible for all syscalls from utimes(2)

Browse source 
family.  Minor wording corrections.

Based on the suggestions by bde.

Sponsored by:	The FreeBSD Foundation
MFC after:	1 week
This commit is contained in:
Konstantin Belousov 2014-07-03 11:19:16 +00:00
parent 2499a5ccef
commit c22de76166
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=268212
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