summaryrefslogtreecommitdiffstats
path: root/lib/libc/sys/utimes.2
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2002-12-18 09:22:32 +0000
committerru <ru@FreeBSD.org>2002-12-18 09:22:32 +0000
commita4b155d7a2170a500eb79b46959eef4018441062 (patch)
treecb18f664ed0ee63bee30f6af9b148510b6e9663b /lib/libc/sys/utimes.2
parente7e659d1cc574138f455ed70d58a07294211ff5a (diff)
downloadFreeBSD-src-a4b155d7a2170a500eb79b46959eef4018441062.zip
FreeBSD-src-a4b155d7a2170a500eb79b46959eef4018441062.tar.gz
mdoc(7) police: Tidy up the syscall language.
Stop calling system calls "function calls". Use "The .Fn system call" a-la "The .Nm utility". When referring to a non-BSD implementation in the HISTORY section, call syscall a function, to be safe.
Diffstat (limited to 'lib/libc/sys/utimes.2')
-rw-r--r--lib/libc/sys/utimes.214
1 files changed, 10 insertions, 4 deletions
diff --git a/lib/libc/sys/utimes.2 b/lib/libc/sys/utimes.2
index 6ca9e38..dd03e90 100644
--- a/lib/libc/sys/utimes.2
+++ b/lib/libc/sys/utimes.2
@@ -71,7 +71,7 @@ write the file, or be the super-user.
If
.Fa times
is
-.Pf non- Dv NULL ,
+.No non- Ns Dv NULL ,
it is assumed to point to an array of two timeval structures.
The access time is set to the value of the first element, and the
modification time is set to the value of the second element.
@@ -89,7 +89,9 @@ The caller must be the owner of the file or be the super-user.
In either case, the inode-change-time of the file is set to the current
time.
.Pp
+The
.Fn lutimes
+system call
is like
.Fn utimes
except in the case where the named file is a symbolic link,
@@ -102,9 +104,11 @@ changes the times of the file the link references.
.Sh RETURN VALUES
.Rv -std
.Sh ERRORS
+The
.Fn utimes
and
.Fn lutimes
+system calls
will fail if:
.Bl -tag -width Er
.It Bq Er EACCES
@@ -146,7 +150,9 @@ does not match the owner of the file and is not the super-user.
The file system containing the file is mounted read-only.
.El
.Pp
+The
.Fn futimes
+system call
will fail if:
.Bl -tag -width Er
.It Bq Er EBADF
@@ -154,7 +160,7 @@ will fail if:
does not refer to a valid descriptor.
.El
.Pp
-All of the functions will fail if:
+All of the system calls will fail if:
.Bl -tag -width Er
.It Bq Er EACCES
The
@@ -185,11 +191,11 @@ The file system containing the file is mounted read-only.
.Sh HISTORY
The
.Fn utimes
-function call appeared in
+system call appeared in
.Bx 4.2 .
The
.Fn futimes
and
.Fn lutimes
-function calls first appeared in
+system calls first appeared in
.Fx 3.0 .
OpenPOWER on IntegriCloud