pthread_suspend_np

Name

pthread_suspend_np -- suspend execution of a realtime thread.

Synopsis

       #include <rtl_sched.h>

       int pthread_suspend_np(pthread_t thread);

DESCRIPTION

This function is a non-portable Realtime Linux extension. pthread_suspend_np suspends the execution of the thread thread until a call to pthread_wakeup_np. Note: If the target thread is running on a different processer, it is not guaranteed to be suspended immediately. Calls to pthread_suspend_np(pthread_self()) do work immediately.

RETURN VALUE

Always returns 0.

NOTES

pthread_suspend_np can be called from a signal or interrupt handler, but should be used with some care. RTLinux hard signal handlers (interrupt handlers) execute in the context of whatever thread was running when the interrupt was accepted by the hardware. If thread "A" was running when an interrupt handler started and the handler calls pthread_suspend_np, then the scheduler will save thread "A" and run another thread. If you call pthread_suspend_np from an interrupt handler running in the context of the general purpose operating system thread (Linux), then all general purpose operations and processes will stop until the thread is waked.

ERRORS

None.

AUTHOR

Michael Barabanov (baraban@fsmlabs.com)

SEE ALSO

pthread_wakeup_np(3), pthread_make_periodic_np(3), pthread_make_periodic_np(3)

©2001 FSMLabs Inc.

All rights reserved.