File: FENCE.md

package info (click to toggle)
intel-graphics-compiler 1.0.12504.6-1%2Bdeb12u1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 83,912 kB
  • sloc: cpp: 910,147; lisp: 202,655; ansic: 15,197; python: 4,025; yacc: 2,241; lex: 1,570; pascal: 244; sh: 104; makefile: 25
file content (87 lines) | stat: -rw-r--r-- 1,483 bytes parent folder | download
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
79
80
81
82
83
84
85
86
87
<!---======================= begin_copyright_notice ============================

Copyright (C) 2020-2021 Intel Corporation

SPDX-License-Identifier: MIT

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

 

## Opcode

  FENCE = 0x5c

## Format

| |
| --- |
| 0x5c(FENCE) | Mask |


## Semantics




      Memory fence.

## Description



    Performs scattered write into <surface>, using the values from <src>.

- **Mask(ub):**  Controls whether the various caches should be flushed.
 
  - Bit[0]: the "commit enable" bit. If set, the fence is guaranteed to be globally observable.
 
  - Bit[1]: flush instruction cache if set.
 
  - Bit[2]: flush sampler cache if set.
 
  - Bit[3]: flush constant cache if set.
 
  - Bit[4]: flush read-write cache if set.
 
  - {ICLLP+}Bit[5]: 
 
    - 0b0:  fence is applied to global memory (surface-based accesses and SVM) 
    - 0b1:  fence applies to shared local memory only 
  - Bit[6]: flush L1 read-only data cache if set
 
  - Bit[7]: indicates this is a scheduling barrier but will not generate an actual fence instruction.

#### Properties


## Text
```
    

		FENCE_{GLOBAL|LOCAL}.{E?I?S?C?R?L1?}

    FENCE_SW

    //E - commit enable

    //I - Instruction Cache

    //S - Sampler Cache

    //C - Constant Cache

    //R - Read-Write Cache

    //L1 - L1 Cache

    //FENCE_SW means a software only scheduling barrier
```



## Notes



      Cache flush is normally not needed for correctness.