CBO.ZERO

RISC-V CBO.ZERO Instruction Details

Instruction ManualI-type

cache-block zero (Zicboz).

Instruction Syntax

cbo.zero offset(base)
Operand Breakdown
Destination rd: general-purpose register receiving the result.
Source rs1: register holding the first operand.
Immediate imm: 12-bit signed value, sign-extended before operation with rs1.
ZicbozCache & Sync

Instruction Behavior

CBO.ZERO is a Zicboz cache-block zero instruction that performs stores of zero to all bytes corresponding to the cache block containing the address in rs1. rs1 need not be aligned to the cache-block size; an implementation may update bytes in any order, granularity, and atomicity, and whole-block atomicity is not guaranteed. The cache-block size is discovered from the execution environment and is not fixed at 64 bytes; the offset may be omitted, and if present must be 0.

Quick Understanding & Search Notes

CBO.ZERO is a CMO cache-block operation; it locates a cache block by effective address but is not an ordinary load/store.

For cbo.*, any explicit offset must be zero and the target is the cache block containing rs1.
CBO.ZERO may write zeros at implementation-chosen granularity and does not guarantee atomic whole-block update.

Common Usage Scenarios

Atomic & Sync

Understand this scenario with real code like «cbo.zero 0(a1)».

Cache & Hints

Understand this scenario with real code like «cbo.zero 0(a1)».

Device & IO

Understand this scenario with real code like «cbo.zero 0(a1)».

Pre-Use Checklist

Syntax Check
  • Confirm the current instruction format is I-type.
  • Confirm the operand order matches the example.
Semantic Check
  • Ensure the destination register usage is compatible with the calling convention.
  • Confirm this is not the lower-level form of a pseudo-instruction expansion.

Pitfalls / Common Confusions

The assembly offset operand may be omitted; if present, it must evaluate to zero.
rs1 need not be aligned to cache-block size; fault reporting uses the rs1 virtual address.
Execution permission is controlled by xenvcfg-related fields and privilege/virtualization state.

FAQ

Is CBO.ZERO equivalent to a fence?

No. CMO/prefetch has cache-block semantics and is not a general memory-ordering substitute.

Must the address for CBO.ZERO be cache-block aligned?

CBO instructions do not require rs1 to be aligned to cache-block size.