NAME

fttl_set_fault_interval - Sets the timeline fault interval for the default processor set.

SYNOPSIS

kern_return_t fttl_set_fault_interval(fault_interval)
timespec_t fault_interval;

DESCRIPTION

Under the fault-tolerant timeline scheduling policy, fault-tolerant threads may be created. The scheduling policy guarantees that these threads will have enough time to complete by their deadlines even if some threads are re-executed. The scheduler optimizes the schedule by assuming that only one fault-tolerant thread will re-execute within any fault interval. The fttl_set_fault_interval system call sets the timeline fault interval for the default processor set. A fault-tolerant timeline thread is re-executed immediately upon termination, if the fault flag is set (see fttl_set_fault_flag). Non-fault-tolerant timeline threads are guaranteed enough processor time to meet their deadlines without any allowance for their re-execution. They are unaffected by the fault interval.

PARAMETERS

fault_interval The minimum interval required between thread re-executions. Deadlines are guaranteed as long as at most one thread is re-executed every fault_interval.

RETURN VALUE

KERN_SUCCESS The fault interval is set to fault_interval.
KERN_FAILURE There are one or more threads scheduled on the timeline. The fault interval cannot be changed when the timeline is busy.
KERN_INVALID_VALUE The specified fault_interval is invalid.

RELATED INFORMATION

Functions:

thread_create, rt_thread_deadline_handler, rt_thread_exit, thread_get_attribute, thread_set_attribute, rt_set_scheduling_policy, fttl_thread_create, fttl_thread_attribute_init, fttl_set_fault_flag, fttl_activate_persist_thread.