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

6.6 KiB
Raw Blame History

lvrxl — Load Vector Right Indexed LRU

Category: Memory · Form: X · Opcode: 0x7c00064e

Assembler Mnemonics

Mnemonic XML entry Flags Description
lvrxl lvrxl Load Vector Right Indexed LRU
lvrxl128 lvrxl128 Load Vector Right Indexed LRU 128

Syntax

lvrxl [VD], [RA0], [RB]
lvrxl128 [VD], [RA0], [RB]

Encoding

lvrxl — form X

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

lvrxl128 — form VX128_1

  • Opcode word: 0x10000643
  • Primary opcode (bits 05): 4
  • Extended opcode: 1603
  • Synchronising: no
Bits Field Meaning
05 OPCD primary opcode (4)
610 VD128l destination low 5 bits
1115 RA address register
1620 RB offset register
2127 XO extended opcode
2829 VD128h destination high 2 bits
3031 reserved

Operands

Field Role Description
RA0 lvrxl: read; lvrxl128: read Source GPR; when the encoded register number is 0 the operand is the literal 64-bit zero, not r0.
RB lvrxl: read; lvrxl128: read Source GPR.
VD lvrxl: write; lvrxl128: write Destination vector register.

Register Effects

lvrxl

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

lvrxl128

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

Status-Register Effects

No condition-register or status-register effects.

Operation (pseudocode)

; Pseudocode derives directly from the xenia-rs interpreter
; arm (see Implementation References). Operation semantics:
;   - Read source operands from the fields listed under Operands.
;   - Apply the arithmetic / logical / memory action described
;     in the Description field above.
;   - Write results to the destination register(s); update any
;     status bits enumerated under Status-Register Effects.
; Consult the IBM AIX reference link under IBM Reference for
; canonical PPC-style pseudocode where xenia's expression is
; terse.

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

lvrxl

xenia-rs interpreter body (frozen snapshot)
        PpcOpcode::lvrx | PpcOpcode::lvrxl => {
            let ea = ea_indexed(ctx, instr);
            ctx.vr[instr.rd()] = crate::vmx::load_vector_right(mem, ea);
            ctx.pc += 4;
        }

lvrxl128

xenia-rs interpreter body (frozen snapshot)
        PpcOpcode::lvrx128 | PpcOpcode::lvrxl128 => {
            let ea = ea_indexed(ctx, instr);
            ctx.vr[instr.vd128()] = crate::vmx::load_vector_right(mem, ea);
            ctx.pc += 4;
        }

Special Cases & Edge Conditions

  • Same data effect as lvrx, with LRU cache hint. Reads (EA mod 16) bytes from the previous aligned line into the right half of VD; left half zero-filled. The l suffix tells the cache the line is least-recently-used.
  • Hint ignored under emulation. Xenia's snapshot is shared with lvrx (PpcOpcode::lvrx | PpcOpcode::lvrxl => …).
  • No alignment masking. The exact EA controls how data shifts.
  • RA0 semantics. RA = 0 selects literal zero.
  • Microsoft Xbox 360 specific. Part of the VMX128 / Cell BE extended set.
  • Streaming-read use case. Pair with lvlxl when iterating across a buffer that will not be revisited; the LRU hint frees cache capacity for the next line.
  • VMX128 sibling (lvrxl128). Identical semantics; alternative operand encoding addressing v0..v127.

IBM Reference