Tpm2Session.c File Reference

#include <IndustryStandard/UefiTcgPlatform.h>
#include <Library/Tpm2CommandLib.h>
#include <Library/Tpm2DeviceLib.h>
#include <Library/BaseMemoryLib.h>
#include <Library/BaseLib.h>
#include <Library/DebugLib.h>

Go to the source code of this file.

Data Structures
struct	TPM2_START_AUTH_SESSION_COMMAND
struct	TPM2_START_AUTH_SESSION_RESPONSE

Functions
EFI_STATUS EFIAPI	Tpm2StartAuthSession (IN TPMI_DH_OBJECT TpmKey, IN TPMI_DH_ENTITY Bind, IN TPM2B_NONCE *NonceCaller, IN TPM2B_ENCRYPTED_SECRET *Salt, IN TPM_SE SessionType, IN TPMT_SYM_DEF *Symmetric, IN TPMI_ALG_HASH AuthHash, OUT TPMI_SH_AUTH_SESSION *SessionHandle, OUT TPM2B_NONCE *NonceTPM)

Detailed Description

Implement TPM2 Session related command.

Copyright (c) 2014 - 2018, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent

Definition in file Tpm2Session.c.

Function Documentation

Tpm2StartAuthSession()

EFI_STATUS EFIAPI Tpm2StartAuthSession	(	IN TPMI_DH_OBJECT	TpmKey,
		IN TPMI_DH_ENTITY	Bind,
		IN TPM2B_NONCE *	NonceCaller,
		IN TPM2B_ENCRYPTED_SECRET *	Salt,
		IN TPM_SE	SessionType,
		IN TPMT_SYM_DEF *	Symmetric,
		IN TPMI_ALG_HASH	AuthHash,
		OUT TPMI_SH_AUTH_SESSION *	SessionHandle,
		OUT TPM2B_NONCE *	NonceTPM
	)

This command is used to start an authorization session using alternative methods of establishing the session key (sessionKey) that is used for authorization and encrypting value.

Parameters

[in]	TpmKey	Handle of a loaded decrypt key used to encrypt salt.
[in]	Bind	Entity providing the authValue.
[in]	NonceCaller	Initial nonceCaller, sets nonce size for the session.
[in]	Salt	Value encrypted according to the type of tpmKey.
[in]	SessionType	Indicates the type of the session.
[in]	Symmetric	The algorithm and key size for parameter encryption.
[in]	AuthHash	Hash algorithm to use for the session.
[out]	SessionHandle	Handle for the newly created session.
[out]	NonceTPM	The initial nonce from the TPM, used in the computation of the sessionKey.

Return values

EFI_SUCCESS	Operation completed successfully.
EFI_DEVICE_ERROR	The command was unsuccessful.

Definition at line 56 of file Tpm2Session.c.