Files
Sylpheed/tools/ppc-manual/memory/lbz.md
MechaCat02 6bdbf89ebc
All checks were successful
CI / Native — linux (pull_request) Successful in 37m56s
CI / WASM — Web (pull_request) Successful in 28m5s
CI / Formatting (pull_request) Successful in 59s
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 05): 34
  • Extended opcode:
  • Synchronising: no
Bits Field Meaning
05 OPCD primary opcode
610 RT destination GPR (or RS when storing)
1115 RA source GPR (0 ⇒ literal 0 for RA0 forms)
1631 D/SI/UI 16-bit signed or unsigned immediate

lbzu — form D

  • Opcode word: 0x8c000000
  • Primary opcode (bits 05): 35
  • Extended opcode:
  • Synchronising: no
Bits Field Meaning
05 OPCD primary opcode
610 RT destination GPR (or RS when storing)
1115 RA source GPR (0 ⇒ literal 0 for RA0 forms)
1631 D/SI/UI 16-bit signed or unsigned immediate

lbzux — form X

  • Opcode word: 0x7c0000ee
  • Primary opcode (bits 05): 31
  • Extended opcode: 119
  • Synchronising: no
Bits Field Meaning
05 OPCD primary opcode
610 RT/FRT/VRT destination
1115 RA/FRA/VRA source A
1620 RB/FRB/VRB source B
2130 XO extended opcode (10 bits)
31 Rc record-form flag

lbzx — form X

  • Opcode word: 0x7c0000ae
  • Primary opcode (bits 05): 31
  • Extended opcode: 87
  • Synchronising: no
Bits Field Meaning
05 OPCD primary opcode
610 RT/FRT/VRT destination
1115 RA/FRA/VRA source A
1620 RB/FRB/VRB source B
2130 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 (r0r31).
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