pthread_make_periodic_np

Name

pthread_make_periodic_np -- mark a realtime thread as periodic

Synopsis

       #include <rtl_sched.h>

       int pthread_make_periodic_np(pthread_t thread, hrtime_t start_time, hrtime_t period);

DESCRIPTION

This function is a non-portable Realtime Linux extension. pthread_make_periodic_np marks the thread thread as ready for execution. The thread will start its execution at start_time (as shown by the clock used for scheduling) and will run at intervals specified by period given in nanoseconds. RTLinux will attempt to make thread timing as close as possible to what is specified, but start time and period depend on the hardware clock resolution.

RETURN VALUE

pthread_make_periodic_np returns 0 on success and a non-zero error code on error.

ERRORS

ESRCH: No thread could be found corresponding to that specified by the given thread ID.

NOTES

This function may not be used on threads assigned to a CPU other than the current.

The recommended way to implement periodic threads is to use clock_nanosleep(3).

AUTHOR

Michael Barabanov (baraban@fsmlabs.com)