suword329
Store data to user-space
Part of store(9).
Usage
#include <sys/types.h>
#include <sys/time.h>
#include <sys/systm.h>
int
subyte(volatile void *base, int byte);
int
suptr(volatile void *base, intptr_t ptr);
int
suword(volatile void *base, long word);
int
suword16(volatile void *base, int word);
int
suword32(volatile void *base, int32_t word);
int
suword64(volatile void *base, int64_t word);
Overview
The store functions are designed to copy small amounts of data to user-space. 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.
The store routines provide the following functionality:
subyte()-
Stores a byte of data to the user-space address base.
suptr()-
Stores a pointer to the user-space address base preserving the provenance of that pointer (see memory_model(7) for further information).
suword()-
Stores a word of data to the user-space address base.
suword16()-
Stores 16 bits of data to the user-space address base.
suword32()-
Stores 32 bits of data to the user-space address base.
suword64()-
Stores 64 bits of data to the user-space address base.
Return values
The store functions return 0 on success or -1 on failure.
Releases
38 releases since FreeBSD 8.1-RELEASE; the text changed 26 times.