Skip to content
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 24 additions & 3 deletions src/memory-model.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,26 @@
r[memory]
# Memory model

Rust does not yet have a defined memory model. Various academics and industry professionals
are working on various proposals, but for now, this is an under-defined place
in the language.
> [!WARNING]
> The memory model of Rust is incomplete and not fully decided.
r[memory.bytes]
## Bytes

r[memory.bytes.intro]
The most basic unit of memory in Rust is a byte. All values are computed from zero or more bytes read from an allocation.

> [!NOTE]
> While bytes are typically lowered to hardware bytes, Rust uses an "abstract" notion of bytes that can make distinctions which are absent in hardware, such as being uninitialized, or storing part of a pointer.
r[memory.bytes.contents]
Each byte may have one of the following values:

r[memory.bytes.init]
* An initialized byte containing a `u8` value and optional [provenance][std::ptr#provenance],

r[memory.bytes.uninit]
* An uninitialized byte.

> [!NOTE]
> The above list is not yet guaranteed to be exhaustive.