tpm_takeownership.3

来自「IBM开发的TPM的驱动, 有少量的例子可以供参考」· 3 代码 · 共 51 行

.\" Copyright 2004 IBM (Jeff Kravitz)
.\"
.\" Written Feb 10 2004, Jeff Kravitz
.\"
.TH "TPM_TakeOwnership" 3  2004-02-11 "IBM" "TPM Library"
.SH NAME
TPM_TakeOwnership
.SH SYNOPSIS
.nf
.B #include <tpmfunc.h>
.sp
.BR "uint32_t TPM_TakeOwnership" "(unsigned char *ownauth,"
                  unsigned char *srkauth,
                  keydata *srk)
.fi
.SH DESCRIPTION
The \fBTPM_TakeOwnership()\fP function performs the function of installing
a new \fIowner authorization data\fP,
\fIstorage root key\fP,
and \fIstorage root key authorization data\fP into a TPM
.SH ARGUMENTS
The arguments include...
.TP 10
.B ownauth
A pointer to the owner authorization data
.TP 10
.B srkauth
A pointer to the SRK (storage root key) authorization data.
.TP 10
.B srk
A pointer to a \fBkeydata\fP structure that will receive the information
on the SRK just created.  The \fBkeydata\fP structure is described in the
man page for the \fBTPM_CreateWrapKey()\fP function.
.SH NOTES
.P
This function cannot be performed unless the TPM is currently without an owner.
The current owner may be removed via the \fBTPM_OwnerClear()\fP function, or
by a manual operation.  Both methods require some kind of physical presence at the
computer itself, i.e. an owner can not be removed remotely.
.P
Both of the authorization data arguments consist of
a 20 byte value which is usually calculated as the hash of a real
password.
.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_CreateWrapKey(3) , TPM_OwnerClear(3) , TPM_GetErrMsg(3) .
.SH AUTHOR
Jeff Kravitz, IBM T.J. Watson Research Center