~ubuntu-branches/ubuntu/karmic/trousers/karmic

« back to all changes in this revision

Viewing changes to man/man3/Tspi_DAA_VerifyInit.3

  • Committer: Bazaar Package Importer
  • Author(s): Daniel Baumann
  • Date: 2008-01-23 22:03:00 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20080123220300-fhtqja3c0oq0gp6z
Tags: 0.3.1-4
* Added patch from Aaron M. Ucko <ucko@debian.org> to allow trousers to
  build successfully on amd64, and presumably also other 64-bit
  architectures (Closes: #457400).
* Including udev rule for /dev/tpm from William Lima
  <wlima.amadeus@gmail.com> as suggested by David Smith <dds@google.com>
  (Closes: #459682).
* Added lintian overrides.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\" Copyright (C) 2006 International Business Machines Corporation
 
2
.\" Written by Anthony Bussani based on the Trusted Computing Group Software Stack Specification Version 1.2
 
3
.\"
 
4
.de Sh \" Subsection
 
5
.br
 
6
.if t .Sp
 
7
.ne 5
 
8
.PP
 
9
\fB\\$1\fR
 
10
.PP
 
11
..
 
12
.de Sp \" Vertical space (when we can't use .PP)
 
13
.if t .sp .5v
 
14
.if n .sp
 
15
..
 
16
.de Ip \" List item
 
17
.br
 
18
.ie \\n(.$>=3 .ne \\$3
 
19
.el .ne 3
 
20
.IP "\\$1" \\$2
 
21
..
 
22
.TH "Tspi_DAA_VerifyInit" 3 "2006-09-04" "TSS 1.2"
 
23
.ce 1
 
24
TCG Software Stack Developer's Reference
 
25
.SH NAME
 
26
Tspi_DAA_VerifyInit \- creates a challenge for the TCG platform
 
27
.SH "SYNOPSIS"
 
28
.ad l
 
29
.hy 0
 
30
.nf
 
31
.B #include <tss/tss_typedef.h>
 
32
.B #include <tss/tss_structs.h>
 
33
.B #include <tss/tspi.h>
 
34
.sp
 
35
.BI "TSPICALL Tspi_DAA_VerifyInit("
 
36
.BI "    TSS_HDAA                    " hDAA ","
 
37
.BI "    UINT32*                     " nonceVerifierLength ","
 
38
.BI "    BYTE**                      " nonceVerifier ","
 
39
.BI "    UINT32*                     " baseNameLength ","
 
40
.BI "    BYTE**                      " baseName
 
41
.BI ");"
 
42
.fi
 
43
.sp
 
44
.ad
 
45
.hy
 
46
 
 
47
.SH "DESCRIPTION"
 
48
.PP
 
49
\Tspi_DAA_VerifyInit\fR
 
50
is part of the DAA Verifier component. It's the first function out of 2 in order to verify
 
51
a DAA Credential of a TCG platform. It creates a challenge for the TCG platform.
 
52
This is an optional function and does not require a TPM or a TCS.
 
53
 
 
54
.SH "PARAMETERS"
 
55
.PP
 
56
.SS hDAA
 
57
The \fIhDAA\fR parameter is used to specify the handle of the DAA object.
 
58
.SS nonceVerifierLength
 
59
The \fInonceVerifierLength\fR parameter is the length of the nonceVerifier.
 
60
.SS nonceVerifier
 
61
The \fInonceVerifier\fR parameter is the challenge for the platform.
 
62
.SS baseNameLength
 
63
The \fIbaseNameLength\fR parameter is the length of the baseName.
 
64
.SS baseName
 
65
The \fIbaseName\fR parameter is the base name that was chosen for the DAA Signature.
 
66
 
 
67
.SH "RETURN CODES"
 
68
.PP
 
69
\fBTspi_DAA_VerifyInit\fR returns TSS_SUCCESS on success, otherwise one of the
 
70
following values is returned:
 
71
.TP
 
72
.SM TSS_E_BAD_PARAMETER
 
73
.TP
 
74
.SM TSS_E_INTERNAL_ERROR
 
75
An internal SW error has been detected.
 
76
.TP
 
77
.SH "CONFORMING TO"
 
78
.PP
 
79
\fBTspi_DAA_VerifyInit\fR conforms to the Trusted Computing Group
 
80
Software Specification version 1.2
 
81
 
 
82
.SH "SEE ALSO"
 
83
 
 
84
.PP
 
85
\fBTspi_DAA_IssuerKeyVerification\fR(3)
 
86