/* Microsoft Reference Implementation for TPM 2.0 | |
* | |
* The copyright in this software is being made available under the BSD License, | |
* included below. This software may be subject to other third party and | |
* contributor rights, including patent rights, and no such rights are granted | |
* under this license. | |
* | |
* Copyright (c) Microsoft Corporation | |
* | |
* All rights reserved. | |
* | |
* BSD License | |
* | |
* Redistribution and use in source and binary forms, with or without modification, | |
* are permitted provided that the following conditions are met: | |
* | |
* Redistributions of source code must retain the above copyright notice, this list | |
* of conditions and the following disclaimer. | |
* | |
* Redistributions in binary form must reproduce the above copyright notice, this | |
* list of conditions and the following disclaimer in the documentation and/or other | |
* materials provided with the distribution. | |
* | |
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ""AS IS"" | |
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE | |
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR | |
* ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | |
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | |
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON | |
* ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | |
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
*/ | |
/*(Auto) | |
Automatically Generated by TpmPrototypes version 2.2 February 10, 2016 | |
Date: Sep 9, 2016 Time: 01:03:57 PM | |
*/ | |
#ifndef _EXECCOMMAND_FP_H_ | |
#define _EXECCOMMAND_FP_H_ | |
//** ExecuteCommand() | |
// | |
// The function performs the following steps. | |
// | |
// a) Parses the command header from input buffer. | |
// b) Calls ParseHandleBuffer() to parse the handle area of the command. | |
// c) Validates that each of the handles references a loaded entity. | |
// d) Calls ParseSessionBuffer () to: | |
// 1) unmarshal and parse the session area; | |
// 2) check the authorizations; and | |
// 3) when necessary, decrypt a parameter. | |
// e) Calls CommandDispatcher() to: | |
// 1) unmarshal the command parameters from the command buffer; | |
// 2) call the routine that performs the command actions; and | |
// 3) marshal the responses into the response buffer. | |
// f) If any error occurs in any of the steps above create the error response | |
// and return. | |
// g) Calls BuildResponseSessions() to: | |
// 1) when necessary, encrypt a parameter | |
// 2) build the response authorization sessions | |
// 3) update the audit sessions and nonces | |
// h) Calls BuildResponseHeader() to complete the construction of the response. | |
// | |
// 'responseSize' is set by the caller to the maximum number of bytes available in | |
// the output buffer. ExecuteCommand will adjust the value and return the number | |
// of bytes placed in the buffer. | |
// | |
// 'response' is also set by the caller to indicate the buffer into which | |
// ExecuteCommand is to place the response. | |
// | |
// 'request' and 'response' may point to the same buffer | |
// | |
// Note: As of February, 2016, the failure processing has been moved to the | |
// platform-specific code. When the TPM code encounters an unrecoverable failure, it | |
// will SET g_inFailureMode and call _plat__Fail(). That function should not return | |
// but may call ExecuteCommand(). | |
// | |
LIB_EXPORT void | |
ExecuteCommand( | |
uint32_t requestSize, // IN: command buffer size | |
unsigned char *request, // IN: command buffer | |
uint32_t *responseSize, // IN/OUT: response buffer size | |
unsigned char **response // IN/OUT: response buffer | |
); | |
#endif // _EXECCOMMAND_FP_H_ |