NAME

fttl_set_fault_flag - Sets the system fault flag to signal re-execution of timeline thread.

SYNOPSIS

kern_return_t fttl_set_fault_flag(flag_value)
int flag_value;

DESCRIPTION

The fttl_set_fault_flag system call sets the system fault flag to the value specified in flag_value. When a fault- tolerant timeline thread terminates, the system checks the value of fault flag. If this value is not zero, then it resets it to zero and re-executes the thread. fttl_set_fault_flag can be used to recover from transient faults; upon detection of an error, a thread can set the system fault flag to cause its own re-execution. Note: The timeline scheduler assumes that at most one thread will be re-executed every fault_interval (see fttl_set_fault_interval). Misuse of the fault_flag may cor- rupt the timeline and/or cause threads to miss their dead- lines.

PARAMETERS

flag_value Non-zero causes the FTTL scheduler to re-execute the next fault-tolerant thread which terminates

RETURN VALUE

KERN_SUCCESS The return value is always KERN_SUCCESS.

RELATED INFORMATION

Functions:

rt_set_scheduling_policy, fttl_thread_attribute_init, fttl_thread_create, fttl_set_fault_interval, fttl_activate_persist_thread.