← Back to branch summary

~ubuntu-branches/ubuntu/hardy/trousers/hardy-proposed

« back to all changes in this revision

Viewing changes to man/man3/Tspi_DAA_VerifySignature.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
http://bugs.debian.org/457400
http://bugs.debian.org/459682
* 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:
man/man3/Tspi_DAA_VerifySignature.3
 
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_VerifySignature" 3 "2006-09-04" "TSS 1.2"
 
23
.ce 1
 
24
TCG Software Stack Developer's Reference
 
25
.SH NAME
 
26
Tspi_DAA_VerifySignature \- 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_VerifySignature("
 
36
.BI "    TSS_HDAA                    " hDAA ","
 
37
.BI "    TSS_DAA_SIGNATURE           " daaSignature ","
 
38
.BI "    TSS_HKEY                    " hPubKeyIssuer ","
 
39
.BI "    TSS_DAA_SIGN_DATA           " signData ","
 
40
.BI "    UINT32                      " attributesLength ","
 
41
.BI "    BYTE**                      " attributes ","
 
42
.BI "    UINT32                      " nonceVerifierLength ","
 
43
.BI "    BYTE*                       " nonceVerifier ","
 
44
.BI "    UINT32                      " baseNameLength ","
 
45
.BI "    BYTE*                       " baseName ","
 
46
.BI "    TSS_BOOL*                   " isCorrect
 
47
.BI ");"
 
48
.fi
 
49
.sp
 
50
.ad
 
51
.hy
 
52
 
 
53
.SH "DESCRIPTION"
 
54
.PP
 
55
\Tspi_DAA_VerifySignature\fR
 
56
is part of the DAA Verifier component. It's the last function out of 2 in order to verify a
 
57
DAA Credential of a TCG platform. It verifies the DAA Credential and detects public rogue TPMs.
 
58
This is an optional function and does not require a TPM or a TCS.
 
59
 
 
60
.SH "PARAMETERS"
 
61
.PP
 
62
.SS hDAA
 
63
The \fIhDAA\fR parameter is used to specify the handle of the DAA object.
 
64
.SS daaSignature
 
65
The \fIdaaSignature\fR parameter is the DAA signature contains proof of
 
66
ownership of the DAA Credential, as well as a signature on either an AIK or a message.
 
67
.SS hPubKeyIssuer
 
68
The \fIhPubKeyIssuer\fR parameter is the handle of the DAA public key of the DAA Issuer
 
69
of the credential.
 
70
.SS signData
 
71
The \fIsignData\fR parameter defines what data is signed (AIK or message).
 
72
.SS attributesLength
 
73
The \fIattributesLength\fR parameter is the Length of attributes array that is determined by
 
74
the DAA Issuer public key (lh+li). The length of a single attribute is lf/8.
 
75
.SS attributes
 
76
The \fIattributes\fR parameter is the array of attributes which the DAA Credential owner reveals.
 
77
.SS nonceVerifierLength
 
78
The \fInonceVerifierLength\fR parameter is the length of nonceVerifier (20 bytes).
 
79
.SS nonceVerifier
 
80
The \fInonceVerifier\fR parameter is the nonce that was computed in the previous function (Tspi_VerifyInit).
 
81
.SS baseNameLength
 
82
The \fIbaseNameLength\fR parameter the length of the baseName.
 
83
.SS baseName
 
84
The \fIbaseName\fR parameter is the base name that was chosen for the DAA Signature.
 
85
.SS isCorrect
 
86
The \fIisCorrect\fR parameter denotes if the verification of the DAA Signature was successful.
 
87
 
 
88
.SH "RETURN CODES"
 
89
.PP
 
90
\fBTspi_DAA_VerifySignature\fR returns TSS_SUCCESS on success, otherwise one of the
 
91
following values is returned:
 
92
.TP
 
93
.SM TSS_E_BAD_PARAMETER
 
94
.TP
 
95
.SM TSS_E_INTERNAL_ERROR
 
96
An internal SW error has been detected.
 
97
.TP
 
98
.SH "CONFORMING TO"
 
99
.PP
 
100
\fBTspi_DAA_VerifySignature\fR conforms to the Trusted Computing Group
 
101
Software Specification version 1.2
 
102
 
 
103
.SH "SEE ALSO"
 
104
 
 
105
.PP
 
106
\fBTspi_DAA_IssuerKeyVerification\fR(3)
 
107