HL.PRF

assembly

[
  "hl.prf{.l1,.l2,.l3} [SrcL, SrcR<{.sw,.uw,.neg}><<<shamt>]"
]

block

[]

catalog_indices

[
  228
]

catalog_records

[
  {
    "agu": {
      "action": "Prefetch",
      "address_kind": "Register",
      "offset_scale": 0,
      "prefetch_returns_address": false,
      "signed_load": false,
      "size_bytes": 1,
      "update_mode": "None"
    },
    "asm": "hl.prf{.l1,.l2,.l3} [SrcL, SrcR<{.sw,.uw,.neg}><<<shamt>]",
    "constraints": [
      {
        "field": "model",
        "operator": "one-of",
        "values": [
          0,
          1,
          2
        ]
      }
    ],
    "encoding": [
      {
        "index": 0,
        "mask": "0x00007fff07ff",
        "match": "0x00007009000e",
        "width_bits": 48
      }
    ],
    "encoding_kind": "HL48",
    "fields": [
      {
        "name": "SrcL",
        "pieces": [
          {
            "instruction_lsb": 31,
            "value_lsb": 0,
            "width": 5
          }
        ],
        "signedness": "encoding-defined",
        "width": 5
      },
      {
        "name": "SrcR",
        "pieces": [
          {
            "instruction_lsb": 36,
            "value_lsb": 0,
            "width": 5
          }
        ],
        "signedness": "encoding-defined",
        "width": 5
      },
      {
        "name": "SrcRType",
        "pieces": [
          {
            "instruction_lsb": 41,
            "value_lsb": 0,
            "width": 2
          }
        ],
        "signedness": "encoding-defined",
        "width": 2
      },
      {
        "name": "model",
        "pieces": [
          {
            "instruction_lsb": 11,
            "value_lsb": 0,
            "width": 5
          }
        ],
        "signedness": "encoding-defined",
        "width": 5
      },
      {
        "name": "shamt",
        "pieces": [
          {
            "instruction_lsb": 43,
            "value_lsb": 0,
            "width": 5
          }
        ],
        "signedness": "encoding-defined",
        "width": 5
      }
    ],
    "form_id": "hl_prf_48_39641863bb21",
    "length_bits": 48,
    "mnemonic": "HL.PRF",
    "semantic_family": "AGU",
    "semantic_group": "LDA",
    "semantic_handler": "ScalarPrefetch",
    "semantic_summary": "HL.PRF snapshots its scalar sources, forms its encoded address, and issues a non-binding 1-byte-granularity prefetch hint with no destination effect.",
    "status": "accepted"
  }
]

classification

[
  "agu"
]

contract

{
  "block_composition": [
    "none"
  ],
  "canonical_assembly": [
    "hl.prf{.l1,.l2,.l3} [SrcL, SrcR<{.sw,.uw,.neg}><<<shamt>]"
  ],
  "defaults": [
    "Every displayed operand field is encoded explicitly; encoded zero is a value and never denotes omission.",
    "SrcRType=0 leaves SrcR unchanged, SrcRType=1 sign-extends SrcR[31:0], SrcRType=2 zero-extends SrcR[31:0], and SrcRType=3 negates the full PTO_XLEN value. Encoded shamt zero performs no shift.",
    "model=0 selects L1, model=1 selects L2, and model=2 selects L3; the cache target is a non-binding performance hint."
  ],
  "encoding_class": "standalone-encoded",
  "examples": [
    "hl.prf{.l1,.l2,.l3} [SrcL, SrcR<{.sw,.uw,.neg}><<<shamt>]"
  ],
  "exceptions": [
    "A fixed-bit mismatch, reserved field value, or unavailable selected T/U source raises Fault_IllegalInstruction before instruction effects.",
    "A legal prefetch model cannot raise a data-access fault. A reserved model rejects before source reads and before optional address publication."
  ],
  "field_contracts": {},
  "field_zero_meanings": {
    "SrcL": "Encoded zero reads the architectural zero GPR.",
    "SrcR": "Encoded zero reads the architectural zero GPR.",
    "SrcRType": "Encoded zero leaves the complete PTO_XLEN register-offset value unchanged.",
    "model": "Encoded zero selects the non-binding L1 cache hint.",
    "shamt": "Encoded zero performs no shift."
  },
  "legality": [
    "Every encoded Reg5 source uses the complete domain: codes 0..23 select absolute GPRs, codes 24..27 select T#1..T#4, and codes 28..31 select U#1..U#4 without consumption.",
    "All four SrcRType values and all shamt values 0..31 are assigned; apply the modifier before the shift.",
    "model codes 0, 1, and 2 are assigned; codes 3..31 are reserved and raise Fault_IllegalInstruction before any scalar source read or architectural effect."
  ],
  "memory_effects": [
    "The 1-byte-granularity hint performs no architectural translation, permission or alignment check, memory access, memory event, reservation update, ordering edge, or cache-placement guarantee."
  ],
  "operands": [
    {
      "field": "SrcL",
      "role": "Reg5 address-base source"
    },
    {
      "field": "SrcR",
      "role": "Reg5 register-offset source"
    },
    {
      "field": "SrcRType",
      "role": "register-offset transformation selector"
    },
    {
      "field": "model",
      "role": "cache-level hint selector"
    },
    {
      "field": "shamt",
      "role": "post-transformation logical-left-shift amount"
    }
  ],
  "ordering": [
    "Snapshot all explicit and implicit scalar sources before destination or memory effects; duplicate and source/destination aliases observe pre-instruction values.",
    "For a legal model, form the hint, publish the optional address result, and then advance TPC by 6 bytes."
  ],
  "standalone_opcode": true,
  "state_effects": [
    "Form offset = LSL(Modify(SrcR, SrcRType), the encoded shamt) and add it modulo 2^PTO_XLEN to the SrcL base.",
    "Discard the formed address after issuing the non-binding hint; no encoded field publishes a result.",
    "Successful execution advances TPC by 6 bytes; a rejected or faulting attempt does not retire."
  ]
}

depends_on

[
  "PTO-BLOCK-MODEL-SCHEMA-PROFILE-ENCODING"
]

id

PTO-SCALAR-HL-PRF

mnemonic

HL.PRF

summary

HL.PRF snapshots its scalar sources, forms its encoded address, and issues a non-binding 1-byte-granularity prefetch hint with no destination effect.

surface

scalar

{
  "classification": [
    "agu"
  ],
  "documentation": "docs/scalar/agu/HL.PRF.md",
  "id": "PTO-SCALAR-HL-PRF",
  "instruction_contract": {
    "artifact": "spec/evidence/instruction-contract-closure.json",
    "mnemonic": "HL.PRF",
    "ndf_clause": "PTO-INST-SCALAR-HL-PRF"
  },
  "mnemonic": "HL.PRF",
  "readiness_subjects": [
    "ADR-0029",
    "ADR-0059",
    "ADR-0084"
  ],
  "semantic_tests": [
    "PTO-AVS-AGU-HL-PRF-ALIAS-001",
    "PTO-AVS-AGU-HL-PRF-BOUND-001",
    "PTO-AVS-AGU-HL-PRF-EXEC-001",
    "PTO-AVS-AGU-HL-PRF-FAULT-001"
  ],
  "source": "asl/scalar/agu/HL.PRF.asl",
  "surface": "scalar",
  "tests": [
    "PTO-AVS-AGU-HL-PRF-ALIAS-001",
    "PTO-AVS-AGU-HL-PRF-BOUND-001",
    "PTO-AVS-AGU-HL-PRF-EXEC-001",
    "PTO-AVS-AGU-HL-PRF-FAULT-001",
    "PTO-AVS-SCALAR-HL-PRF-DECODE-001"
  ]
}