OcAppleSecureBootLib.h File Reference

#include <Protocol/AppleSecureBoot.h>
#include <Protocol/AppleImg4Verification.h>

Go to the source code of this file.

Functions
EFI_STATUS	OcAppleSecureBootBootstrapValues (IN CONST CHAR8 *Model, IN UINT64 Ecid OPTIONAL)
APPLE_SECURE_BOOT_PROTOCOL *	OcAppleSecureBootInstallProtocol (IN BOOLEAN Reinstall, IN UINT8 SbPolicy, IN UINT8 SbWinPolicy OPTIONAL, IN BOOLEAN SbWinPolicyValid)
APPLE_SECURE_BOOT_PROTOCOL *	OcAppleSecureBootGetProtocol (VOID)
VOID	OcAppleSecureBootSetDmgLoading (IN BOOLEAN LoadingDmg)
BOOLEAN	OcAppleSecureBootGetDmgLoading (OUT UINT8 *RealPolicy OPTIONAL)
EFI_STATUS	OcAppleSecureBootVerify (IN EFI_DEVICE_PATH_PROTOCOL *DevicePath, IN VOID *SourceBuffer, IN UINTN SourceSize)

Detailed Description

Copyright (C) 2019, Download-Fritz. All rights reserved.

This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License which accompanies this distribution. The full text of the license may be found at http://opensource.org/licenses/bsd-license.php

THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

Definition in file OcAppleSecureBootLib.h.

Function Documentation

OcAppleSecureBootBootstrapValues()

EFI_STATUS OcAppleSecureBootBootstrapValues	(	IN CONST CHAR8 *	Model,
		IN UINT64 Ecid	OPTIONAL )

Bootstrap NVRAM and library values for secure booting.

Parameters

[in]	Model	Secure boot model (without ap suffix in lower-case).
[in]	Ecid	Enclave identifier, optional.

Return values

EFI_SUCCESS

On success.

Definition at line 89 of file OcAppleSecureBootLib.c.

OcAppleSecureBootGetDmgLoading()

BOOLEAN OcAppleSecureBootGetDmgLoading

(

OUT UINT8 *RealPolicy

OPTIONAL

)

Get DMG loading status on Apple Secure Boot protocol.

Parameters

[out]

RealPolicy

Actual secure boot policy, optional.

Return values

TRUE	when loading DMG.

Definition at line 1010 of file OcAppleSecureBootLib.c.

OcAppleSecureBootGetProtocol()

APPLE_SECURE_BOOT_PROTOCOL * OcAppleSecureBootGetProtocol

(

VOID

)

Obtain initialised Apple Secure Boot protocol.

Returns

initialised protocol.

Definition at line 976 of file OcAppleSecureBootLib.c.

OcAppleSecureBootInstallProtocol()

APPLE_SECURE_BOOT_PROTOCOL * OcAppleSecureBootInstallProtocol	(	IN BOOLEAN	Reinstall,
		IN UINT8	SbPolicy,
		IN UINT8 SbWinPolicy	OPTIONAL,
		IN BOOLEAN	SbWinPolicyValid )

Install and initialise the Apple Secure Boot protocol.

Parameters

[in]	Reinstall	Replace any installed protocol.
[in]	SbPolicy	Apple Secure Boot Policy to install.
[in]	SbWinPolicy	Apple Secure Boot Windows Policy to install.
[in]	SbWinPolicyValid	Whether SbWinPolicy should be installed.

Returns

Installed or located protocol.

Return values

NULL	There was an error locating or installing the protocol.

Definition at line 890 of file OcAppleSecureBootLib.c.

OcAppleSecureBootSetDmgLoading()

VOID OcAppleSecureBootSetDmgLoading

(

IN BOOLEAN

LoadingDmg

)

Report DMG loading to Apple Secure Boot protocol.

Parameters

[in]

LoadingDmg

TRUE after loading DMG.

Definition at line 985 of file OcAppleSecureBootLib.c.

OcAppleSecureBootVerify()

EFI_STATUS OcAppleSecureBootVerify	(	IN EFI_DEVICE_PATH_PROTOCOL *	DevicePath,
		IN VOID *	SourceBuffer,
		IN UINTN	SourceSize )

Perform image verification at path.

Parameters

[in]	DevicePath	Path to the image.
[in]	SourceBuffer	Image contents.
[in]	SourceSize	Image size.

Return values

EFI_SUCCESS	on success.
EFI_SECURITY_VIOLATION	when corrupted signature (should abort and die).
EFI_ERROR	when other errors happened (can continue with UEFI loader).

Definition at line 1022 of file OcAppleSecureBootLib.c.