tpm_unbind.3

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

.\" Copyright 2004 IBM (Jeff Kravitz)
.\"
.\" Written Feb 11 2004, Jeff Kravitz
.\"
.TH "TPM_Unbind" 3  2004-02-11 "IBM" "TPM Library"
.SH NAME
TPM_Unbind
.SH SYNOPSIS
.nf
.B #include <tpmfunc.h>
.sp
.BR "uint32_t TPM_UnBind" "(uint32_t keyhandle,"
             unsigned char *keyauth,
             unsigned char *data, unsigned int datalen,
             unsigned char *blob, unsigned int *bloblen)
.fi
.SH DESCRIPTION
The \fBTPM_Unbind()\fP function performs a private key decryption operation
using a TPM loaded key.
.SH ARGUMENTS
The arguments include...
.TP 10
.B keyhandle
The handle of the key used to decrypt the data. This is usually obtained
from \fBTPM_LoadKey()\fP. This key must be a binding (encryption) key, or a
legacy key.
.TP 10
.B keyauth
A pointer to the authorization data for the key
(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 data
A pointer to the data to be decrypted.
.TP 10
.B datalen
An integer containing the length of the data to be decrypted.
.TP 10
.B blob
A pointer to an area to receive the decrypted data.
.TP 10
.B bloblen
A pointer to an integer which will receive the length of the decrypted data.
.SH NOTES
The \fBTPM_Unbind\fP function
does not perform blocking of data.
Blocking and unblocking
must be performed by the calling program.
.P
The area receiving the decrypted data must be the size of the maximum key modulus,
as no buffer overflow checking is performed.  For current TPM usage, a length
of 256 bytes is the maximum.
.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_Bind(3) , TPM_LoadKey(3) , TPM_GetErrMsg(3) .
.SH AUTHOR
Jeff Kravitz, IBM T.J. Watson Research Center