DC.CSW

assembly

[
  "dc.csw SrcL"
]

block

[]

catalog_indices

[
  75
]

catalog_records

[
  {
    "asm": "dc.csw SrcL",
    "constraints": [],
    "encoding": [
      {
        "index": 0,
        "mask": "0xfff07fff",
        "match": "0x0050602b",
        "width_bits": 32
      }
    ],
    "encoding_kind": "L32",
    "fields": [
      {
        "name": "SrcL",
        "pieces": [
          {
            "instruction_lsb": 15,
            "value_lsb": 0,
            "width": 5
          }
        ],
        "signedness": "encoding-defined",
        "width": 5
      }
    ],
    "form_id": "dc_csw_32_2719115a9246",
    "length_bits": 32,
    "mnemonic": "DC.CSW",
    "semantic_family": "SYS",
    "semantic_group": "SYS",
    "semantic_handler": "ExecuteMaintenance",
    "semantic_summary": "DC.CSW completes the data-cache clean-by-set/way scope token maintenance operation synchronously.",
    "status": "accepted"
  }
]

classification

[
  "sys"
]

contract

{
  "block_composition": [
    "DC.CSW executes as one scalar operation in the body of an active SYS block."
  ],
  "canonical_assembly": [
    "dc.csw SrcL"
  ],
  "defaults": [
    "Every displayed operand is encoded explicitly. Encoded zero is an assigned value and never denotes omission."
  ],
  "encoding_class": "standalone-encoded",
  "examples": [
    "dc.csw SrcL"
  ],
  "exceptions": [
    "Invalid block placement raises Illegal Block Exception before encoded-field legality or effects.",
    "A reserved encoding or rejected access raises Illegal Instruction before destination, queue, system-state, or TPC effects."
  ],
  "field_contracts": {},
  "field_zero_meanings": {
    "SrcL": "Encoded zero names the architectural zero GPR."
  },
  "legality": [
    "Every fixed bit and explicit field constraint is checked before operation semantics.",
    "Cache maintenance is a local synchronous hint completion at every ACR."
  ],
  "memory_effects": [
    "No ordinary scalar memory access is performed; success records the operation and operand and advances the selected maintenance epoch."
  ],
  "operands": [
    {
      "field": "SrcL",
      "role": "Reg5 source: R0..R23, T#1..T#4, or U#1..U#4"
    }
  ],
  "ordering": [
    "Check block placement and encoded legality before source reads or architectural effects.",
    "Snapshot every scalar source before the selected system effect, then advance TPC only after success."
  ],
  "standalone_opcode": true,
  "state_effects": [
    "Success records Maintenance_DC_CSW and its exact operand token.",
    "Success advances exactly one data-cache, instruction-cache, bundle-cache, or TLB epoch and then advances TPC."
  ]
}

depends_on

[
  "PTO-SCALAR-MODEL-SYS-SEMANTICS"
]

id

PTO-SCALAR-DC-CSW

mnemonic

DC.CSW

summary

DC.CSW completes the data-cache clean-by-set/way scope token maintenance operation synchronously.

surface

scalar

{
  "classification": [
    "sys"
  ],
  "documentation": "docs/scalar/sys/DC.CSW.md",
  "id": "PTO-SCALAR-DC-CSW",
  "instruction_contract": {
    "artifact": "spec/evidence/instruction-contract-closure.json",
    "mnemonic": "DC.CSW",
    "ndf_clause": "PTO-INST-SCALAR-DC-CSW"
  },
  "mnemonic": "DC.CSW",
  "readiness_subjects": [
    "ADR-0018",
    "ADR-0031",
    "ADR-0059"
  ],
  "semantic_tests": [
    "PTO-AVS-SYS-DC-CSW-EXEC-001",
    "PTO-AVS-SYS-DC-CSW-PLACE-001",
    "PTO-AVS-SYS-DC-CSW-TSRC-001",
    "PTO-AVS-SYS-DC-CSW-USRC-001"
  ],
  "source": "asl/scalar/sys/DC.CSW.asl",
  "surface": "scalar",
  "tests": [
    "PTO-AVS-SCALAR-DC-CSW-DECODE-001",
    "PTO-AVS-SYS-DC-CSW-EXEC-001",
    "PTO-AVS-SYS-DC-CSW-PLACE-001",
    "PTO-AVS-SYS-DC-CSW-TSRC-001",
    "PTO-AVS-SYS-DC-CSW-USRC-001"
  ]
}