|PTHREAD_SWITCH_ADD_NP(3)||FreeBSD Library Functions Manual||PTHREAD_SWITCH_ADD_NP(3)|
NAMEpthread_switch_add_np, pthread_switch_delete_np — thread context switches debugging primitives
LIBRARYPOSIX Threads Library (libpthread, -lpthread)
SYNOPSIS#include < pthread_np.h>
pthread_switch_add_np( pthread_switch_routine_t routine);
pthread_switch_delete_np( pthread_switch_routine_t routine);
DESCRIPTIONAn application is allowed to monitor the thread context switches inside the threading library. An application can install a routine that gets called every time a thread (explicitly created by an application with the pthread_create(3) function) gets the context switched. The routine is passed the thread IDs of the threads that are being switched in and out. Installation and removal of these hooks may be done using the pthread_switch_add_np() and pthread_switch_delete_np() functions respectively.
RETURN VALUESIf successful, these functions return 0. Otherwise, an error number is returned to indicate the error.
ERRORSThe pthread_switch_add_np() may fail if:
- [ EINVAL]
- NULL pointer was passed in the routine argument.
The pthread_switch_delete_np() may fail if:
- [ EINVAL]
- The routine argument is different from the argument previously passed to the pthread_switch_add_np() function.
AUTHORSThis manual page was written by <phantom@FreeBSD.org>.
|February 13, 2003||FreeBSD|