mirror of
https://github.com/freebsd/freebsd-src
synced 2024-09-06 17:18:32 +00:00
Note that most errors are possible for all syscalls from utimes(2)
family. Minor wording corrections. Based on the suggestions by bde. Sponsored by: The FreeBSD Foundation MFC after: 1 week
This commit is contained in:
parent
2499a5ccef
commit
c22de76166
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=268212
|
@ -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
|
||||
|
|
Loading…
Reference in a new issue