Files
sim f3c512f2ab docs(ppc-manual): check every xenia-rs claim against Canary's source
The hand-written parts of the manual still described how the retired
xenia-rs interpreter behaved: its snapshots, Rust casts and helpers. Each of
those 490 statements is now either restated as what Canary's emitters and
x64 backend actually do (at the pinned canary_experimental commit), or
dropped where it only made sense for xenia-rs.

Checking them turned up claims that were wrong, not just outdated:

- VSCR[SAT] is never modelled in Canary (DID_SATURATE is a stub and mfvscr
  cannot see it); the pages said saturating ops set it stickily.
- Canary does not implement lswi/lswx/stswi/stswx, dcbi, mtfsb0/mtfsb1,
  vmsum*, vmhaddshs, vupkhpx/vupklpx, and most SPRs; pages described them
  as working.
- Traps evaluate TO in Canary; stvebx/stvehx/stvewx store one element, not
  16 bytes; mtmsrd writes only EE; fres/frsqrte/vrsqrtefp precision claims
  and the stfs "rounds under RN / sets FPSCR" claim contradicted the spec.
- Reservations are a 64 KiB block bitmap plus a value compare, not
  per-address tracking.

Claims that neither Canary's source nor a public spec settles are marked
unverified (NI at boot, vmaddcfp128 operand order, estimate bit-exactness).

Generated regions are untouched; re-running the generator changes nothing.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-16 21:52:38 +02:00

5.3 KiB
Raw Permalink Blame History

crnor — Condition Register NOR

Category: Control / CR / SPR · Form: XL · Opcode: 0x4c000042

Assembler Mnemonics

Mnemonic XML entry Flags Description
crnor crnor Condition Register NOR

Syntax

crnor [CRBD], [CRBA], [CRBB]

Encoding

crnor — form XL

  • Opcode word: 0x4c000042
  • Primary opcode (bits 05): 19
  • Extended opcode: 33
  • Synchronising: no
Bits Field Meaning
05 OPCD primary opcode (19)
610 BT/BO target / branch options
1115 BA/BI source A / CR bit to test
1620 BB source B
2130 XO extended opcode (10 bits)
31 LK link flag

Operands

Field Role Description
CRBA crnor: read CR source bit A (031).
CRBB crnor: read CR source bit B (031).
CRBD crnor: write CR destination bit (031).

Register Effects

crnor

  • Reads (always): CRBA, CRBB
  • Reads (conditional): none
  • Writes (always): CRBD
  • Writes (conditional): none

Status-Register Effects

No condition-register or status-register effects.

Operation (pseudocode)

; No hand-written pseudocode for this instruction yet.
; The authoritative semantics are the Canary emitter snapshot under
; Implementation References; about half of Canary's emitters open
; with the PPC-style definition as a comment (`RD <- (RA) + (RB)`).
; Every side effect is also enumerated in the Register Effects and
; Status-Register Effects tables above.

C Translation Example

/* No hand-written C yet. Translate the Canary emitter snapshot   */
/* under Implementation References; its HIR maps directly:        */
/*   f.LoadGPR(n) / f.StoreGPR(n, v)  -> r[n] / r[n] = v          */
/*   f.LoadFPR / StoreFPR, f.LoadVR / StoreVR -> f[n], v[n]        */
/*   f.Load(ea, T), f.Store(ea, v) -> raw read / write; emitters   */
/*     wrap them in f.ByteSwap for the big-endian guest value      */
/*   f.UpdateCR(n, v)  -> CR field n from v's LOW 32 BITS vs 0     */
/*   f.LoadCA / f.StoreCA -> xer.CA;  f.StoreSAT -> vscr.SAT       */
/*   i.XO.RA, i.D.DS, ... -> the bit-fields listed under Operands  */
/* The Register Effects and Status-Register Effects tables above  */
/* enumerate every side effect a faithful translation must emit.  */

Implementation References

crnor

Canary emitter (frozen snapshot @ f21ebd49e9)
int InstrEmit_crnor(PPCHIRBuilder& f, const InstrData& i) {
  // CR[bt] <- ¬(CR[ba] | CR[bb])   bt=bo, ba=bi, bb=bb
  Value* ba = f.LoadCRField(i.XL.BI >> 2, i.XL.BI & 3);
  Value* bb = f.LoadCRField(i.XL.BB >> 2, i.XL.BB & 3);
  Value* bt = f.And(f.Not(f.Or(ba, bb)), f.LoadConstantInt8(0x01));
  f.StoreCRField(i.XL.BO >> 2, i.XL.BO & 3, bt);
  return 0;
}

Special Cases & Edge Conditions

  • Operation. CR[CRBD] ← ¬(CR[CRBA] OR CR[CRBB]). Result is 1 only when both source bits are 0; otherwise 0.
  • crnot BT, BA idiom. With BA == BB, crnor BT, BA, BA¬CR[BA] — this is the canonical PowerPC single-bit invert, recognised by assemblers as the simplified mnemonic crnot BT, BA.
  • Bit-level operands. 5-bit absolute CR-bit indices (0..31). The three bits may live in any combination of the eight CR fields.
  • Use case. Branch on "neither A nor B"; or, with crnot, simply complement a CR bit before consuming it in a bcx.
  • No Rc / OE. Pure CR-bit dataflow; CR0/XER untouched.
  • Not synchronising. Reorderable.
  • Canary status. Canary's InstrEmit_crnor emits a host OR followed by NOT.
  • cror, crorc — non-negated OR siblings.
  • crnand — negated AND (the De Morgan dual).
  • crand, crandc — AND family.
  • crxor, creqv — XOR / XNOR.
  • mcrf — bulk CR-field copy.
  • bcx — typical consumer of synthesised CR bits.

Simplified Mnemonics

Simplified Expansion Effect
crnot BT, BA crnor BT, BA, BA CR[BT] ← ¬CR[BA] (invert single bit)

IBM Reference