crypto/external/cpl/trousers/dist/man/man3/Tspi_DAA_VerifyInit.3
author yamt <yamt@NetBSD.org>
Tue, 17 Apr 2012 00:01:34 +0000
branchyamt-pagecache
changeset 280360 e98874280705
permissions -rw-r--r--
sync with head

.\" Copyright (C) 2006 International Business Machines Corporation
.\" Written by Anthony Bussani based on the Trusted Computing Group Software Stack Specification Version 1.2
.\"
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "Tspi_DAA_VerifyInit" 3 "2006-09-04" "TSS 1.2"
.ce 1
TCG Software Stack Developer's Reference
.SH NAME
Tspi_DAA_VerifyInit \- creates a challenge for the TCG platform
.SH "SYNOPSIS"
.ad l
.hy 0
.nf
.B #include <tss/tss_typedef.h>
.B #include <tss/tss_structs.h>
.B #include <tss/tspi.h>
.sp
.BI "TSPICALL Tspi_DAA_VerifyInit("
.BI "    TSS_HDAA                    " hDAA ","
.BI "    UINT32*                     " nonceVerifierLength ","
.BI "    BYTE**                      " nonceVerifier ","
.BI "    UINT32*                     " baseNameLength ","
.BI "    BYTE**                      " baseName
.BI ");"
.fi
.sp
.ad
.hy

.SH "DESCRIPTION"
.PP
\Tspi_DAA_VerifyInit\fR
is part of the DAA Verifier component. It's the first function out of 2 in order to verify
a DAA Credential of a TCG platform. It creates a challenge for the TCG platform.
This is an optional function and does not require a TPM or a TCS.

.SH "PARAMETERS"
.PP
.SS hDAA
The \fIhDAA\fR parameter is used to specify the handle of the DAA object.
.SS nonceVerifierLength
The \fInonceVerifierLength\fR parameter is the length of the nonceVerifier.
.SS nonceVerifier
The \fInonceVerifier\fR parameter is the challenge for the platform.
.SS baseNameLength
The \fIbaseNameLength\fR parameter is the length of the baseName.
.SS baseName
The \fIbaseName\fR parameter is the base name that was chosen for the DAA Signature.

.SH "RETURN CODES"
.PP
\fBTspi_DAA_VerifyInit\fR returns TSS_SUCCESS on success, otherwise one of the
following values is returned:
.TP
.SM TSS_E_BAD_PARAMETER
.TP
.SM TSS_E_INTERNAL_ERROR
An internal SW error has been detected.
.SH "CONFORMING TO"
.PP
\fBTspi_DAA_VerifyInit\fR conforms to the Trusted Computing Group
Software Specification version 1.2

.SH "SEE ALSO"

.PP
\fBTspi_DAA_IssuerKeyVerification\fR(3)