1tpm_sealdata(3)            Library Functions Manual            tpm_sealdata(3)
2
3
4
5      TPM Management - tpmUnsealFile, tpmUnsealShred, tpmUnsealStrerror
6

NAME

8       tpmUnsealFile, tpmUnsealShred, tpmUnsealStrerror - unseal routines
9

SYNOPSIS

11       #include <tpm_unseal/tpm_unseal.h>
12
13       int tpmUnsealFile(char* file, char** data, int* size);
14       void tpmUnsealShred(char* data, int size);
15       char* tpmUnsealStrerror(int rc);
16
17

DESCRIPTION

19       The functions in the tpmUnseal family allow access to a piece of
20       sensitive data that has been sealed to the TPM configuration of a given
21       system if the conditions are right, that is the SRK has not changed and
22       the PCRS (if any) specified at seal time are of the appropriate value.
23
24       The tpmUnsealFile function returns the contents of the file unsealed in
25       the data buffer.  The memory at *data must be freed by the caller.
26
27       The tpmUnsealShred function will zero and free the memory.
28
29       The tpmUnsealStrerror function will convert the return code from
30       tpmUnsealFile into a human comprehensible string using and internal
31       errno variable.
32
33

Return Value

35       The tpmUnsealFile function returns 0 on success and a negative number
36       on error.  The tpmUnsealStrerror function returns the error string on
37       success and the empty string on an error.
38
39

SEE ALSO

41       tpm_sealdata(1)
42
43

REPORTING BUGS

45       Report bugs to <trousers-users@lists.sourceforge.net>
46
47
48
49TPM Management                    2005-08-10                   tpm_sealdata(3)