audk/MdePkg/Library/StackCheckFailureHookLibNull/StackCheckFailureHookLibNul...

## @file
#  Library provides a hook called when a stack cookie check fails.
#
#  Copyright (c) Microsoft Corporation.
#  SPDX-License-Identifier: BSD-2-Clause-Patent
##

[Defines]
  INF_VERSION                    = 1.29
  BASE_NAME                      = StackCheckFailureHookLibNull
  FILE_GUID                      = 9ca2587c-d1f2-451a-989a-d49a9a0a613e
  MODULE_TYPE                    = BASE
  VERSION_STRING                 = 1.0
  LIBRARY_CLASS                  = StackCheckFailureHookLib

[Sources]
  StackCheckFailureHook.c

[Packages]
  MdePkg/MdePkg.dec
MdePkg: Create Stack Check Null Libs Add Null libs for Stack Check and Stack Check Failure Hook Lib that allow a platform to opt out of stack checks and the stack check failure hook lib. StackCheckLib allows implementation (or in this case null implementation) of stack checks on binaries. There is a Host Application specific version of this null lib because MSVC host applications must not be linked against our lib (so the file here is a no-op but that doesn't cause the build system to fail the build for not building a file for MSVC) as it links against the MSVC C runtime lib that provides the stack cookie definitions. GCC host applications do not link against such a C runtime lib and must be linked against our version. StackCheckFailureHookLib lets a platform do custom functionality when a stack check failure occurs (such as log it to a platform defined mechanism). The null lib simply returns. Signed-off-by: Oliver Smith-Denny <osde@linux.microsoft.com> 2024-08-27 23:31:48 +02:00			`## @file`
			`# Library provides a hook called when a stack cookie check fails.`
			`#`
			`# Copyright (c) Microsoft Corporation.`
			`# SPDX-License-Identifier: BSD-2-Clause-Patent`
			`##`

			`[Defines]`
			`INF_VERSION = 1.29`
			`BASE_NAME = StackCheckFailureHookLibNull`
			`FILE_GUID = 9ca2587c-d1f2-451a-989a-d49a9a0a613e`
			`MODULE_TYPE = BASE`
			`VERSION_STRING = 1.0`
			`LIBRARY_CLASS = StackCheckFailureHookLib`

			`[Sources]`
			`StackCheckFailureHook.c`

			`[Packages]`
			`MdePkg/MdePkg.dec`