Content-type: text/html Manpage of startTCBExec

startTCBExec

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

 

NAME

startTCBExec - executes a function within a well defined time interval.

 

SYNOPSIS

#include "tcb/tcb.h"

TCBtimestamp startTCBExec(int descriptor,TCBtimestamp start_ev, TCBtimeinterval delay, TCBtimeinterval max_exec, Func_Id func, char* TraceName);  

DESCRIPTION

executes an user provided function with offset and deadline time constraints. This function blocks until execution finishing. descriptor references the connection to the TCB. start_ev is the timestamp that signals the reference instant for the execution (nanoseconds resolution). delay is a time interval (nanoseconds resolution), counted from start_ev, which specifies the offset for the execution, that is, the instant (start_ev+delay) in which TCB sets the function as ready to execute. max_exec is a time interval (nanoseconds resolution), counted from start_ev, which specifies the deadline for the execution, that is, the maximum termination instant (start_ev+max_exec) allowed for the execution. func identifies the user function (in kernel space) that is to be executed. TraceName not defined in this version. Set it with an empty string "".

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.

startTCBExec.  

RETURN VALUE

OK if no errors occurred  

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_EXEC if the TCB doesn't have available resources to perform the operation.

CANT_RUN_TIMELY if the TCB can't run the function in a timely manner, that is, within the time interval specified by the user.

 

SEE ALSO


 

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