Files
Sylpheed/tools/ppc-manual/memory/lfd.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

lfd — Load Floating-Point Double

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

Assembler Mnemonics

Mnemonic XML entry Flags Description
lfd lfd Load Floating-Point Double
lfdu lfdu Load Floating-Point Double with Update
lfdux lfdux Load Floating-Point Double with Update Indexed
lfdx lfdx Load Floating-Point Double Indexed

Syntax

lfd [FD], [d]([RA0])
lfdu [FD], [d]([RA])
lfdux [FD], [RA], [RB]
lfdx [FD], [RA0], [RB]

Encoding

lfd — form D

  • Opcode word: 0xc8000000
  • Primary opcode (bits 05): 50
  • 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

lfdu — form D

  • Opcode word: 0xcc000000
  • Primary opcode (bits 05): 51
  • 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

lfdux — form X

  • Opcode word: 0x7c0004ee
  • Primary opcode (bits 05): 31
  • Extended opcode: 631
  • 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

lfdx — form X

  • Opcode word: 0x7c0004ae
  • Primary opcode (bits 05): 31
  • Extended opcode: 599
  • 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 lfd: read; lfdx: read Source GPR; when the encoded register number is 0 the operand is the literal 64-bit zero, not r0.
d lfd: read; lfdu: read 16-bit signed displacement (d) added to the base address register.
FD lfd: write; lfdu: write; lfdux: write; lfdx: write Destination floating-point register.
RA lfdu: read; lfdu: write; lfdux: read; lfdux: write Source GPR (r0r31).
RB lfdux: read; lfdx: read Source GPR.

Register Effects

lfd

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

lfdu

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

lfdux

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

lfdx

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

Status-Register Effects

No condition-register or status-register effects.

Operation (pseudocode)

EA <- (RA|0) + EXTS(d)
FRT <- MEM(EA, 8)

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

lfd

xenia-rs interpreter body (frozen snapshot)
        PpcOpcode::lfd => {
            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.fpr[instr.rd()] = mem.read_f64(ea);
            ctx.pc += 4;
        }

lfdu

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

lfdux

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

lfdx

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

Special Cases & Edge Conditions

  • Bit-exact double load. Reads 8 bytes and places them directly into FRT as IEEE-754 binary64. No format conversion is performed (contrast lfs, which expands single→double).
  • No FPSCR side effects. lfd cannot raise IEEE exceptions: it neither rounds nor inspects the value. A signalling NaN read this way stays a signalling NaN until it is consumed by an arithmetic op.
  • RA0 semantics. In the non-update forms (lfd, lfdx), RA = 0 selects literal zero — lfd FT, 0(0) loads from absolute address 0. Update forms lfdu / lfdux invoke RA = 0 and RA = RT (here RA is GPR; RT is FPR, so the latter cannot collide) as invalid forms when RA = 0.
  • Alignment. Xenon tolerates unaligned 8-byte FP loads; PowerISA technically permits implementations to raise alignment exceptions for FP loads, so portable code uses 8-byte aligned addresses.
  • Big-endian read. Bytes are interpreted big-endian: byte at EA is bits 07 of the IEEE pattern (sign + part of exponent), byte at EA+7 is bits 5663 of the mantissa. mem.read_f64 in xenia handles the host-side byte-swap.
  • MSR[FP] required. Like all FP-register accesses, lfd requires the FP unit be enabled (MSR[FP]=1). Otherwise a Floating-Point Unavailable interrupt is raised. Xenia assumes FP is always enabled in user code.
  • Pair with stfd. Store-double is the symmetric counterpart.
  • lfs — single-precision load with format conversion to double.
  • stfd, stfdu, stfdx, stfdux — corresponding stores.
  • stfiwx — store-FP-as-integer-word (the asymmetric oddity in the FP load/store family).
  • ld — integer doubleword load (same width, GPR target).

IBM Reference