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) |
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.
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.
[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. |
EFI_SUCCESS | Operation completed successfully. | |
EFI_DEVICE_ERROR | The command was unsuccessful. |
References EFI_STATUS(), Tpm2SubmitCommand(), and UINTN().