Skip to content

Commit 3038bcc

Browse files
authored
Merge pull request #2967 from corob-msft/docs/corob/1742462
Update to address 1742462
2 parents 459d005 + c71da7e commit 3038bcc

1 file changed

Lines changed: 22 additions & 11 deletions

File tree

‎docs/build/reference/cetcompat.md‎

Lines changed: 22 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "/CETCOMPAT (CET Shadow Stack compatible)"
3-
ms.date: "02/19/2019"
3+
ms.date: "06/30/2020"
44
f1_keywords: ["/CETCOMPAT"]
55
helpviewer_keywords: ["/CETCOMPAT linker option", "/CETCOMPAT"]
66
---
@@ -10,35 +10,46 @@ Specifies whether to mark an executable image as compatible with Control-flow En
1010

1111
## Syntax
1212

13-
> **/CETCOMPAT**\[**:NO**]
13+
> **`/CETCOMPAT`**\
14+
> **`/CETCOMPAT:NO`**
1415
1516
## Arguments
1617

17-
**NO**<br/>
18-
Specifies that the executable should not be marked compatible with CET Shadow Stack.
18+
**`NO`**<br/>
19+
Specifies that the executable shouldn't be marked compatible with CET Shadow Stack.
1920

2021
## Remarks
2122

22-
Control-flow Enforcement Technology (CET) Shadow Stack is a computer processor feature that provides capabilities to defend against return oriented programming (ROP) based malware attacks. For more information, see [Intel Control-flow Enforcement Technology Preview](https://software.intel.com/sites/default/files/managed/4d/2a/control-flow-enforcement-technology-preview.pdf).
23+
Control-flow Enforcement Technology (CET) Shadow Stack is a computer processor feature that provides capabilities to defend against return-oriented programming (ROP) based malware attacks. For more information, see [Intel Control-flow Enforcement Technology Preview](https://software.intel.com/sites/default/files/managed/4d/2a/control-flow-enforcement-technology-preview.pdf).
2324

24-
The **/CETCOMPAT** linker option tells the linker to mark the binary as CET Shadow Stack-compatible. **/CETCOMPAT:NO** marks the binary as not compatible with CET Shadow Stack. If both options are specified on the command line, the last one specified is used. This switch is currently only applicable to x86 and x64 architectures.
25+
The **`/CETCOMPAT`** linker option tells the linker to mark the binary as CET Shadow Stack-compatible. **`/CETCOMPAT:NO`** marks the binary as not compatible with CET Shadow Stack. If both options are specified on the command line, the last one specified is used. This switch is currently only applicable to x86 and x64 architectures.
2526

26-
The **/CETCOMPAT** option is available beginning in the Visual Studio 2019 Preview 3 toolset.
27+
The **`/CETCOMPAT`** option is available beginning in Visual Studio 2019.
2728

28-
### To set the /CETCOMPAT linker option in Visual Studio
29+
### To set the `/CETCOMPAT` linker option in Visual Studio
30+
31+
Starting in Visual Studio 2019 version 16.7:
2932

3033
1. Open the **Property Pages** dialog box for the project. For more information, see [Working with Project Properties](../working-with-project-properties.md).
3134

3235
1. Select the **Configuration Properties** > **Linker** > **Advanced** property page.
3336

3437
1. Select the **CET Shadow Stack Compatible** property.
3538

36-
1. In the dropdown control, choose **Yes (/CETCOMPAT)** to enable EH continuation metadata, or **No (/CETCOMPAT:NO)** to disable it.
39+
1. In the dropdown control, choose **`Yes (/CETCOMPAT)`** to enable EH continuation metadata, or **`No (/CETCOMPAT:NO)`** to disable it.
40+
41+
In previous versions of Visual Studio 2019:
42+
43+
1. Open the **Property Pages** dialog box for the project. For more information, see [Working with Project Properties](../working-with-project-properties.md).
44+
45+
1. Select the **Configuration Properties** > **Linker** > **Command Line** property page.
46+
47+
1. In the **Additional Options** edit control, add *`/CETCOMPAT`* to enable EH continuation metadata, or *`/CETCOMPAT:NO`* to explicitly disable it.
3748

3849
### To set this linker option programmatically
3950

40-
This option does not have a programmatic equivalent.
51+
This option doesn't have a programmatic equivalent.
4152

4253
## See also
4354

44-
[Linker Options](linker-options.md)
55+
[Linker options](linker-options.md)

0 commit comments

Comments
 (0)