tpm_loadkey.3

IBM开发的TPM的驱动, 有少量的例子可以供参考

.\" Copyright 2004 IBM (Jeff Kravitz)
.\"
.\" Written Jan 29 2004, Jeff Kravitz
.\"
.TH "TPM_LoadKey" 3  2004-02-11 "IBM" "TPM Library"
.SH NAME
TPM_LoadKey
.SH SYNOPSIS
.nf
.B #include <tpmfunc.h>
.sp
.BR "uint32_t TPM_LoadKey" "(uint32_t parhandle,"
                  unsigned char *parauth,
                  keydata *key,
                  uint32_t *newhandle)
.fi
.SH DESCRIPTION
The \fBTPM_LoadKey()\fP function loads a specified key into the TPM
and returns a handle to be used when performing cryptographic TPM functions
using the key.
.SH ARGUMENTS
The arguments include...
.TP 10
.B parhandle
the parent key handle.
.TP 10
.B parauth
the parent key authorization data
(a 20 byte value which is usually calculated as the hash of a password).
If NULL, it will be assumed that no password is required.
.TP 10
.B keydata
a pointer to a keydata structure containing the key to be loaded.
.TP 10
.B newhandle
A pointer to a 32 bit integer which will receive the handle of the newly loaded key.
.SH NOTES
.P
The handle returned as the last argument is passed to many other TPM functions
to specify the key to be used by those functions. Handles are volatile and
do not necessary last between TPM resets or computer reboots.  Handles and keys
use resources
in the TPM which are limited, so keys should be kept loaded
in the TPM only while necessary, and the handle and its associated 
key storage should be released
as soon as possible via the \fBTPM_EvictKey()\fP function.
.P
A key read in from external storage is usually in a binary format which
can be converted to a keydata structure via the \fBTSS_KeyExtract()\fP function.
.SH "RETURN VALUE"
0 if the operation is successful. non-zero otherwise.
The non zero value can be converted to an error message via the function \fBTPM_GetErrMsg()\fP.
.SH "SEE ALSO"
.BR TSS_KeyExtract(3) , TPM_GetErrMsg(3) , TPM_EvictKey(3) .
.SH AUTHOR
Jeff Kravitz, IBM T.J. Watson Research Center