Content-type: text/html Manpage of startTCBLocalFD

startTCBLocalFD

Section: Timely Computing Base (1)
Updated: 30 September 2002
Index Return to Main Contents

 

NAME

startTCBLocalFD - calls the distributed failure detection service of the TCB.

 

SYNOPSIS

#include "tcb/tcb.h"

int startTCBLocalFD(int descriptor,TCBtimestamp start_ev, TCBtimeinterval spec, TCBtimeinterval deadline, Func_Id func);  

DESCRIPTION

This function provides the interface to the distributed failure detection service of the TCB. descriptor references the connection to the TCB. start_ev is the timestamp that signals the reference instant of the observed interval (nanoseconds resolution). spec is a time interval (nanoseconds resolution), counted from start_ev, which specifies the instant of the failure, that is, there is timing a failure at instant start_ev+spec. deadline is a time interval (nanoseconds resolution) that specifies the deadline for the execution of the function which handles the timing failure when it occurs. func identifies the user function (in kernel space) that will be executed if a timing failure occurs.

typedef struct {

        char module[50];

        char funcname[50];

        char wcetname[50];

} Func_Id;

module is the kernel module in which function is defined. funcname is the name of the function. wcetname is the name of the function which specifies the execution time for the function.

startTCBLocalFD.  

RETURN VALUE

a descriptor that identifies the service instantiation  

ERRORS

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

FUNC_NOT_FOUND if the function provided by the user is invalid, that is, it was not founded in kernel space.

WCET_FUNC_NOT_FOUND if the function that specifies the execution time of the function is invalid, that is, it was not founded in kernel space.

NO_AVAIL_LOCAL_FD if the TCB doesn't have available resources to perform the operation.

ALREADY_FAILED if the request was proceeded by the TCB in an instant after the timing failure point.

 

SEE ALSO

endTCBLocalFD (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