libstb/tss2/ibmtpm20tss/utils/tssauth.h

/********************************************************************************/
/*										*/
/*			     TSS Authorization 					*/
/*			     Written by Ken Goldman				*/
/*		       IBM Thomas J. Watson Research Center			*/
/*            $Id: tssauth.h 1257 2018-06-27 20:52:08Z kgoldman $		*/
/*										*/
/* (c) Copyright IBM Corporation 2015 - 2019.					*/
/*										*/
/* All rights reserved.								*/
/* 										*/
/* 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.		*/
/* 										*/
/* Neither the names of the IBM Corporation nor the names of its		*/
/* contributors may be used to endorse or promote products derived from		*/
/* this software without specific prior written permission.			*/
/* 										*/
/* 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.		*/
/********************************************************************************/

/* This is not a public header.  It should not be used by applications. */

#ifndef TSS_AUTH_H
#define TSS_AUTH_H

#include <ibmtss/tss.h>
#include "tssccattributes.h"

/* Generic functions to marshal and unmarshal Part 3 ordinal command and response parameters */

typedef TPM_RC (*MarshalInFunction_t)(COMMAND_PARAMETERS *source,
				      uint16_t *written, BYTE **buffer, uint32_t *size);
typedef TPM_RC (*UnmarshalOutFunction_t)(RESPONSE_PARAMETERS *target,
					 TPM_ST tag, BYTE **buffer, uint32_t *size);
typedef TPM_RC (*UnmarshalInFunction_t)(COMMAND_PARAMETERS *target,
					BYTE **buffer, uint32_t *size, TPM_HANDLE handles[]);

/* The context for the entire command processor.  Update TSS_InitAuthContext() when changing
   this structure */

typedef struct TSS_AUTH_CONTEXT {
    uint8_t 		commandBuffer [MAX_COMMAND_SIZE];
    uint8_t 		responseBuffer [MAX_RESPONSE_SIZE];
    const char 		*commandText;
    COMMAND_INDEX    	tpmCommandIndex;	/* index into attributes table */
    TPM_CC 		commandCode;
    TPM_RC 		responseCode;
    size_t		commandHandleCount;
    uint32_t 		responseHandleCount;
    uint16_t		authCount;		/* authorizations in command */
    uint16_t 		commandSize;
    uint32_t 		cpBufferSize;
    uint8_t 		*cpBuffer;
    uint32_t 		responseSize;
    MarshalInFunction_t    marshalInFunction;
    UnmarshalOutFunction_t unmarshalOutFunction;
#ifndef TPM_TSS_NOCMDCHECK	/* disable command parameter checking */
    UnmarshalInFunction_t  unmarshalInFunction;
#endif
#ifdef TPM_TPM12
    uint16_t		sessionNumber;		/* session used for ADIP, zero based */
    int16_t		encAuthOffset0;		/* offset to first TPM_ENCAUTH parameter */
    int16_t		encAuthOffset1;		/* offset to second TPM_ENCAUTH parameter if not NULL */
#endif
} TSS_AUTH_CONTEXT;

TPM_RC TSS_AuthCreate(TSS_AUTH_CONTEXT **tssAuthContext);

void TSS_InitAuthContext(TSS_AUTH_CONTEXT *tssAuthContext);

TPM_RC TSS_AuthDelete(TSS_AUTH_CONTEXT *tssAuthContext);

TPM_CC TSS_GetCommandCode(TSS_AUTH_CONTEXT *tssAuthContext);

TPM_RC TSS_GetCpBuffer(TSS_AUTH_CONTEXT *tssAuthContext,
		       uint32_t *cpBufferSize,
		       uint8_t **cpBuffer);


TPM_RC TSS_GetCommandHandleCount(TSS_AUTH_CONTEXT *tssAuthContext,
				 size_t *commandHandleCount);

TPM_RC TSS_AuthExecute(TSS_CONTEXT *tssContext);

#endif