RVOPcode
Home/Instructions/CBO-CLEAN
CBO.CLEAN

RISC-V CBO.CLEAN Instruction Details

Instruction ManualI-type

cache-block clean (Zicbom).

Instruction Syntax

cbo.clean 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.
ZicbomCache & Sync
Related Search Terms
cbo.clean instructionRISC-V cbo.cleancbo.clean syntaxcbo.clean encodingcbo.clean cache-block cleancbo.clean CMOcbo.clean cache block

Instruction Behavior

CBO.CLEAN is a Zicbom cache-block management instruction that performs a clean operation on the cache block containing the effective address in rs1: if the copy in the coherent cache set was modified, a write transfer is performed so stores by coherent agents become visible to relevant non-coherent agents. The cache-block size is discovered from the execution environment and is not fixed at 64 bytes; the assembly offset may be omitted, and if present must evaluate to 0. An implementation may perform a flush instead of a clean.

Quick Understanding & Search Notes

CBO.CLEAN 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.INVAL/CLEAN/FLUSH executability is controlled by environment configuration.
RISC-V Unprivileged ISA Manual: CMO cache-block operation extensions

Common Usage Scenarios

Atomic & Sync

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

Cache & Hints

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

Device & IO

Understand this scenario with real code like «cbo.clean 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.CLEAN equivalent to a fence?

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

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

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