Skip to content

Commit 60a656e

Browse files
author
Colin Robertson
committed
Update to address 1742462
1 parent 7296f94 commit 60a656e

1 file changed

Lines changed: 21 additions & 11 deletions

File tree

docs/build/reference/cetcompat.md

Lines changed: 21 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,36 +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.
3746

47+
1. In the **Additional Options** edit control, add *`/CETCOMPAT`* to enable EH continuation metadata, or *`/CETCOMPAT:NO`* to explicitly disable it.
3848

3949
### To set this linker option programmatically
4050

41-
This option does not have a programmatic equivalent.
51+
This option doesn't have a programmatic equivalent.
4252

4353
## See also
4454

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

0 commit comments

Comments
 (0)