GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  TPMUNSEALFILE (3)

TPM Management - tpmUnsealFile, tpmUnsealShred, tpmUnsealStrerror

NAME

tpmUnsealFile, tpmUnsealShred, tpmUnsealStrerror - unseal routines

CONTENTS

SYNOPSIS

#include <tpm_unseal/tpm_unseal.h>

int tpmUnsealFile(char* file, char** data, int* size);
void tpmUnsealShred(char* data, int size);
char* tpmUnsealStrerror(int rc);

DESCRIPTION

The functions in the tpmUnseal family allow access to a piece of sensitive data that has been sealed to the TPM configuration of a given system if the conditions are right, that is the SRK has not changed and the PCRS (if any) specified at seal time are of the appropriate value.

The tpmUnsealFile function returns the contents of the file unsealed in the data buffer. The memory at *data must be freed by the caller.

The tpmUnsealShred function will zero and free the memory.

The tpmUnsealStrerror function will convert the return code from tpmUnsealFile into a human comprehensible string using and internal errno variable.

Return Value

The tpmUnsealFile function returns 0 on success and a negative number on error. The tpmUnsealStrerror function returns the error string on success and the empty string on an error.

SEE ALSO

tpm_sealdata(1)

REPORTING BUGS

Report bugs to <trousers-users@lists.sourceforge.net>
Search for    or go to Top of page |  Section 3 |  Main Index


TPM Management TPM_SEALDATA (3) 2005-08-10

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.