Content-type: text/html Manpage of openTCBConnection

openTCBConnection

Section: (T)TCB (1)
Updated: 30 September 2002
Index Return to Main Contents

 

NAME

openTCBConnection, openTTCBConnection - opens a connection with the TCB/TTCB

 

SYNOPSIS

#include "tcb/tcb.h"

int openTCBConnection(descriptor_t *tcb_desc);

#include "tcb/ttcb.h"

int openTTCBConnection(descriptor_t *tcb_desc);

 

DESCRIPTION

openTCBConnection must be called by applications before starting to interact with the TCB/TTCB. If the invocation of this function succeeds, a connection is established and services may start to be required through this connection. For the TTCB this call executes the Local Authentication Service.

openTTCBConnection is simply an alias to openTCBConnection.

tcb_desc is a pointer to a descriptor which will reference the connection. For the TCB this parameter cannot be setup. For the TTCB, some parameters in tcb_desc can be defined:

TTCB_PublicKey can be initiated with the Local TTCB public key, obtained in some unspecified way. When this parameter is not setup a call is made to the Local TTCB to get the key. This is secure only if the programmer assumes that the host is not compromised when the connection is established.
  secret, challenge, protection can be setup all together or none. secret is the key to be shared between the entity and the TTCB. challenge is the challenge used for the entity-TTCB authentication protocol. protection indicates the kind of protection to be used in the entity-TTCB communication. Currently the types implemented are:

PROTECTION_NONE The communication is not protected.

PROTECTION_HMD5 The authenticity and integrity of the communication is protected using MD5 MACs.

If these three parameters are not defined, random numbers are used for secret and challenge, and protection is PROTECTION_NONE.

Before calling the function, tcb_desc must be set to zero, for instance using:

memset(&descriptor, 0, sizeof(descriptor_t));

 

RETURN VALUE

OK if the connection was established.

 

ERRORS

TCB_ACESS_ERROR if an error occurred on the access to the TCB.

NO_AVAIL_CONN if it isn't an available connection.

NO_ROOM_FOR_ENTITY if there are no resources for a new entity in the TTCB (only for the TTCB).

INVALID_PROTECTION if the protection selected is invalid (only for the TTCB).

FAILED_LOCAL_AUTHENTICATION if Local Authentication failed for some other reason (only for the TTCB).

 

SEE ALSO

closeTCBConnection(1)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 23:05:27 GMT, August 06, 2003