Files
Sylpheed/tools/ppc-manual/memory/lbz.md
MechaCat02 10dc260f0c chore(tools): adopt the PPC manual and a canary launcher that works anywhere
CONSOLIDATION.md Phase 6. Both lived untracked in the project root -- on one
disk, backed up by nothing.

  tools/ppc-manual/   393 files, 3.7 MB. 455 instructions, 350 family pages,
                      598 mnemonics resolvable through index.json, plus the
                      generator that produced them.
  tools/run-canary.sh the oracle launcher.

🔴 THE LAUNCHER WAS BROKEN IN TWO WAYS AND IS REWRITTEN, not copied:

  * it pointed at `xenia-rs/sylpheed.iso`, a SYMLINK. Wine cannot resolve one
    and says "path invalid", which reads as a corrupt image rather than a path
    problem -- it has cost a session before. It now points at the real file and
    warns if handed a symlink.
  * it hardcoded one machine's absolute paths, and named `xenia-rs`, which this
    consolidation retires. Now derived from the script's own location, with
    SYLPH_CANARY_BIN / SYLPH_ISO overrides and a check that each exists.

The standing constraints are in its header where someone will read them: one
emulator at a time, Canary runs MUTED, and never judge a crash or a hang from
a Bash-launched run -- a SIGKILL that looked like the binary was the editor's
process supervisor.

⚠️ The manual's GENERATOR reads the xenia-rs source tree, which is going away.
Its decoder now lives here as crates/sylpheed-ppc, so the generator must be
repointed before it is run again. Recorded in the README rather than left for
someone to discover; the manual's content is checked in and regenerates from
nothing implicitly.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-13 21:18:00 +02:00

10 KiB
Raw Blame History

lbz — Load Byte and Zero

Category: Memory · Form: D · Opcode: 0x88000000

Assembler Mnemonics

Mnemonic XML entry Flags Description
lbz lbz — Load Byte and Zero
lbzu lbzu — Load Byte and Zero with Update
lbzux lbzux — Load Byte and Zero with Update Indexed
lbzx lbzx — Load Byte and Zero Indexed

Syntax

lbz [RD], [d]([RA0])
lbzu [RD], [d]([RA])
lbzux [RD], [RA], [RB]
lbzx [RD], [RA0], [RB]

Encoding

lbz — form D

  • Opcode word: 0x88000000
  • Primary opcode (bits 0–5): 34
  • Extended opcode: —
  • Synchronising: no
Bits Field Meaning
0–5 OPCD primary opcode
6–10 RT destination GPR (or RS when storing)
11–15 RA source GPR (0 ⇒ literal 0 for RA0 forms)
16–31 D/SI/UI 16-bit signed or unsigned immediate

lbzu — form D

  • Opcode word: 0x8c000000
  • Primary opcode (bits 0–5): 35
  • Extended opcode: —
  • Synchronising: no
Bits Field Meaning
0–5 OPCD primary opcode
6–10 RT destination GPR (or RS when storing)
11–15 RA source GPR (0 ⇒ literal 0 for RA0 forms)
16–31 D/SI/UI 16-bit signed or unsigned immediate

lbzux — form X

  • Opcode word: 0x7c0000ee
  • Primary opcode (bits 0–5): 31
  • Extended opcode: 119
  • Synchronising: no
Bits Field Meaning
0–5 OPCD primary opcode
6–10 RT/FRT/VRT destination
11–15 RA/FRA/VRA source A
16–20 RB/FRB/VRB source B
21–30 XO extended opcode (10 bits)
31 Rc record-form flag

lbzx — form X

  • Opcode word: 0x7c0000ae
  • Primary opcode (bits 0–5): 31
  • Extended opcode: 87
  • Synchronising: no
Bits Field Meaning
0–5 OPCD primary opcode
6–10 RT/FRT/VRT destination
11–15 RA/FRA/VRA source A
16–20 RB/FRB/VRB source B
21–30 XO extended opcode (10 bits)
31 Rc record-form flag

Operands

Field Role Description
RA0 lbz: read; lbzx: read Source GPR; when the encoded register number is 0 the operand is the literal 64-bit zero, not r0.
d lbz: read; lbzu: read 16-bit signed displacement (d) added to the base address register.
RD lbz: write; lbzu: write; lbzux: write; lbzx: write Destination GPR.
RA lbzu: read; lbzu: write; lbzux: read; lbzux: write Source GPR (r0–r31).
RB lbzux: read; lbzx: read Source GPR.

Register Effects

lbz

  • Reads (always): RA0, d
  • Reads (conditional): none
  • Writes (always): RD
  • Writes (conditional): none

lbzu

  • Reads (always): RA, d
  • Reads (conditional): none
  • Writes (always): RD, RA
  • Writes (conditional): none

lbzux

  • Reads (always): RA, RB
  • Reads (conditional): none
  • Writes (always): RD, RA
  • Writes (conditional): none

lbzx

  • Reads (always): RA0, RB
  • Reads (conditional): none
  • Writes (always): RD
  • Writes (conditional): none

Status-Register Effects

No condition-register or status-register effects.

Operation (pseudocode)

EA <- (RA|0) + EXTS(d)
RT <- 0x00000000_000000_00 || MEM(EA, 1)

C Translation Example

/* C translation: the xenia-rs interpreter arm below in           */
/* Implementation References is the authoritative semantic        */
/* snapshot. Translate it line-by-line:                            */
/*   - ctx.gpr[N]  -> r[N]       (or f[]/v[] for FPRs/VRs)        */
/*   - mem.read_u*/write_u* -> mem_read_u*_be / mem_write_u*_be   */
/*   - ctx.update_cr_signed(fld, v) -> update_cr_signed(fld, v)   */
/*   - ctx.xer_ca / xer_ov / xer_so -> xer.CA / xer.OV / xer.SO   */
/* The Register Effects and Status-Register Effects tables above  */
/* enumerate every side effect a faithful translation must emit.  */

Implementation References

lbz

xenia-rs interpreter body (frozen snapshot)
        PpcOpcode::lbz => {
            let ea = if instr.ra() == 0 { 0u64 } else { ctx.gpr[instr.ra()] };
            let ea = ea.wrapping_add(instr.d() as i64 as u64) as u32;
            ctx.gpr[instr.rd()] = mem.read_u8(ea) as u64;
            ctx.pc += 4;
        }

lbzu

xenia-rs interpreter body (frozen snapshot)
        PpcOpcode::lbzu => {
            let ea = ctx.gpr[instr.ra()].wrapping_add(instr.d() as i64 as u64) as u32;
            ctx.gpr[instr.rd()] = mem.read_u8(ea) as u64;
            ctx.gpr[instr.ra()] = ea as u64;
            ctx.pc += 4;
        }

lbzux

xenia-rs interpreter body (frozen snapshot)
        PpcOpcode::lbzux => {
            let ea = ctx.gpr[instr.ra()].wrapping_add(ctx.gpr[instr.rb()]) as u32;
            ctx.gpr[instr.rd()] = mem.read_u8(ea) as u64;
            ctx.gpr[instr.ra()] = ea as u64;
            ctx.pc += 4;
        }

lbzx

xenia-rs interpreter body (frozen snapshot)
        PpcOpcode::lbzx => {
            let ea = if instr.ra() == 0 { 0u64 } else { ctx.gpr[instr.ra()] };
            let ea = ea.wrapping_add(ctx.gpr[instr.rb()]) as u32;
            ctx.gpr[instr.rd()] = mem.read_u8(ea) as u64;
            ctx.pc += 4;
        }

Special Cases & Edge Conditions

  • Single-byte read. The smallest scalar load. No endian concerns at the byte level — MEM(EA, 1) returns the literal byte at address EA, regardless of host or target byte order.
  • Zero-extension to 64 bits. The high 56 bits of RT become zero. Use lha / lhax family for sign-extending byte-equivalent semantics; there is no PowerPC "load byte sign-extended" — you must lbz then extsb (or use lha on a half).
  • RA0 (non-update forms). When RA = 0 in lbz / lbzx, the base is the literal zero, so lbz RT, 0x4000(0) reads from absolute address 0x4000. Update forms lbzu / lbzux invoke RA = 0 (and RA = RT) as invalid forms; xenia's interpreter does not check, so well-formed compiler output is assumed.
  • Update-form post-write. lbzu / lbzux write the computed EA back to RA after the load; the snapshot first reads, then assigns RA ← EA, matching IBM's "the load and update happen as one operation" wording.
  • No alignment requirement. A byte load is intrinsically aligned. Xenon does not raise alignment exceptions for any byte access.
  • Common in string and table-lookup code. Most uses are character-string scans, jump-table dispatches, and packed-bool reads. Compilers also use lbz to materialise small immediate constants stored in .rodata.
  • lhz, lwz, ld — wider zero-extending loads in the same family.
  • lha, lwa — sign-extending siblings (no lba exists; use lbz + extsb).
  • stb, stbu, stbx, stbux — the corresponding stores.
  • lwbrx, lhbrx — byte-reversed multi-byte loads (no byte-equivalent needed).
  • lmw, lswi, lswx — multi-word / string loads for bulk transfer.

IBM Reference