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>
10 KiB
10 KiB
lbz — Load Byte and Zero
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-canary XML:
tools/ppc-instructions.xml— search formnem="lbz" - xenia-canary emit:
src/xenia/cpu/ppc/ppc_emit_memory.cc:72 - xenia-rs opcode:
crates/xenia-cpu/src/opcode.rs:34 - xenia-rs decoder:
crates/xenia-cpu/src/decoder.rs:357 - xenia-rs interpreter:
crates/xenia-cpu/src/interpreter.rs:1024-1029
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-canary XML:
tools/ppc-instructions.xml— search formnem="lbzu" - xenia-canary emit:
src/xenia/cpu/ppc/ppc_emit_memory.cc:92 - xenia-rs opcode:
crates/xenia-cpu/src/opcode.rs:34 - xenia-rs decoder:
crates/xenia-cpu/src/decoder.rs:358 - xenia-rs interpreter:
crates/xenia-cpu/src/interpreter.rs:1030-1035
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-canary XML:
tools/ppc-instructions.xml— search formnem="lbzux" - xenia-canary emit:
src/xenia/cpu/ppc/ppc_emit_memory.cc:104 - xenia-rs opcode:
crates/xenia-cpu/src/opcode.rs:34 - xenia-rs decoder:
crates/xenia-cpu/src/decoder.rs:776 - xenia-rs interpreter:
crates/xenia-cpu/src/interpreter.rs:1042-1047
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-canary XML:
tools/ppc-instructions.xml— search formnem="lbzx" - xenia-canary emit:
src/xenia/cpu/ppc/ppc_emit_memory.cc:115 - xenia-rs opcode:
crates/xenia-cpu/src/opcode.rs:34 - xenia-rs decoder:
crates/xenia-cpu/src/decoder.rs:774 - xenia-rs interpreter:
crates/xenia-cpu/src/interpreter.rs:1036-1041
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 addressEA, regardless of host or target byte order. - Zero-extension to 64 bits. The high 56 bits of
RTbecome zero. Uselha/lhaxfamily for sign-extending byte-equivalent semantics; there is no PowerPC "load byte sign-extended" — you mustlbzthenextsb(or uselhaon a half). RA0(non-update forms). WhenRA = 0inlbz/lbzx, the base is the literal zero, solbz RT, 0x4000(0)reads from absolute address0x4000. Update formslbzu/lbzuxinvokeRA = 0(andRA = RT) as invalid forms; xenia's interpreter does not check, so well-formed compiler output is assumed.- Update-form post-write.
lbzu/lbzuxwrite the computedEAback toRAafter the load; the snapshot first reads, then assignsRA ← 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
lbzto materialise small immediate constants stored in.rodata.
Related Instructions
lhz,lwz,ld— wider zero-extending loads in the same family.lha,lwa— sign-extending siblings (nolbaexists; uselbz+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.