carta
suptr(9)

suptr9

Store data to user-space

Part of store(9).

Usage

int

int

int

int

int

int

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.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.