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