tpm_getpubkey.3

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

.\" Copyright 2004 IBM (Jeff Kravitz)
.\"
.\" Written Jan 29 2004, Jeff Kravitz
.\"
.TH "TPM_GetPubKey" 3  2004-02-11 "IBM" "TPM Library"
.SH NAME
TPM_GetPubKey
.SH SYNOPSIS
.nf
.B #include <tpmfunc.h>
.sp
.BR "uint32_t TPM_GetPubKey" "(uint32_t keyhandle,"
                  unsigned char *keyauth,
                  unsigned char *keyblob,
                  unsigned int  *bloblen)
.fi
.SH DESCRIPTION
The \fBTPM_GetPubKey()\fP function returns a blob containing the public portion
of a key that is already loaded into the TPM.
.SH ARGUMENTS
The arguments include...
.TP 10
.B keyhandle
The handle of the key. This is usually obtained from \fBTPM_LoadKey()\fP.
.TP 10
.B keyauth
A pointer to the key authorization data,
(a 20 byte value which is usually calculated as the hash of a password).
.TP 10
.B keyblob
A pointer to an area to receive the public key blob.
.TP 10
.B bloblen
A pointer to an integer to receive the size of the returned blob.
.SH NOTES
.P
The area to receive the blob
should be large enough to receive the largest possible public key, as no
buffer overflow checking is done. A buffer of 4096 bytes is recommended.
.P
The resulting public key blob can be converted to a pubkeydata structure
via the \fBTSS_PubKeyExtract()\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 TPM_LoadKey(3) , TSS_PubKeyExtract(3) , TPM_GetErrMsg(3) .
.SH AUTHOR
Jeff Kravitz, IBM T.J. Watson Research Center