man9: Update guarantees for userspace fetch/store operations

Platforms may either silently handle unaligned accesses or return an
error.  Atomicity is not guaranteed in this case, however.

Reviewed by:	kib
MFC after:	1 week
Sponsored by:	The FreeBSD Foundation
Differential Revision:	https://reviews.freebsd.org/D31282
This commit is contained in:
Mark Johnston 2021-07-22 13:08:42 -04:00
parent ab38c12b4a
commit fd5827b178
2 changed files with 10 additions and 6 deletions

View File

@ -34,7 +34,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd January 23, 2020
.Dd July 22, 2021
.Dt FETCH 9
.Os
.Sh NAME
@ -72,8 +72,10 @@ The
.Nm
functions are designed to copy small amounts of data from user-space
of the current process.
If read is successful, it is performed atomically.
The data read must be naturally aligned.
If the user address is naturally aligned, then the operation will be
performed atomically.
Otherwise it may fail or be performed non-atomically, depending on
the platform.
.Pp
The
.Nm

View File

@ -34,7 +34,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd April 17, 2018
.Dd July 22, 2021
.Dt STORE 9
.Os
.Sh NAME
@ -60,8 +60,10 @@
The
.Nm
functions are designed to copy small amounts of data to user-space.
If write is successful, it is performed atomically.
The data written must be naturally aligned.
If the user address is naturally aligned, then the operation will be
performed atomically.
Otherwise it may fail or be performed non-atomically, depending on
the platform.
.Pp
The
.Nm