File: OWORD_LD.md

package info (click to toggle)
intel-graphics-compiler2 2.16.0-2
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 106,644 kB
  • sloc: cpp: 805,640; lisp: 287,672; ansic: 16,414; python: 3,952; yacc: 2,588; lex: 1,666; pascal: 313; sh: 186; makefile: 35
file content (78 lines) | stat: -rw-r--r-- 1,580 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
<!---======================= begin_copyright_notice ============================

Copyright (C) 2020-2022 Intel Corporation

SPDX-License-Identifier: MIT

============================= end_copyright_notice ==========================-->

## Opcode

  OWORD_LD = 0x35

## Format

| | | | | | |
| --- | --- | --- | --- | --- | --- |
| 0x35(OWORD_LD) | Size | Is_modified | Surface | Offset | Dst |


## Semantics


```

      for (i = 0; i < num_owords; ++i) {
        dst[i] = surface[offset+i]; //16 byte, oword-aligned
      }
```

## Description





```
    Reads contiguous owords (one oword is 16 byte) from <surface> starting at <offset>, and stores the result into <dst>.  The execution mask is set to 'NoMask' (i.e., every element is returned).
```


- **Size(ub):**

  - Bit[2..0]: Number of owords to read

    - 0b000:  1 oword
    - 0b001:  2 owords
    - 0b010:  4 owords
    - 0b011:  8 owords
    - {XEHP+}0b100:  16 owords. may only be used when surface is T0

- **Is_modified(ub):** The field is ignored, the read always return the last write from this thread


- **Surface(ub):** Index of the surface variable. It must be a buffer.

                - T0 (SLM): {ICLLP+} Yes. No for earlier platforms
                - T5 (stateless): yes

- **Offset(scalar):** The offset of the read in units of owords. Must have type UD


- **Dst(raw_operand):** The raw operand of a general variable storing the results of the read


#### Properties
- **Out-of-bound Access:** On read: zeros are returned.




## Text
```



    OWORD_LD (<size>) <surface> <offset> <dst>
```