SecurityPkg/Library/Tpm2CommandLib/Tpm2Session.c File Reference


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, Intel Corporation. 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.


Function Documentation

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.

References EFI_STATUS(), Tpm2SubmitCommand(), and UINTN().


Generated on Thu Sep 24 23:44:24 2015 for SecurityPkg[ALL] by  doxygen 1.5.7.1