Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PTHREAD_SWITCH_ADD_NP(3) BSD Library Functions Manual PTHREAD_SWITCH_ADD_NP(3)

NAME
     pthread_switch_add_np, pthread_switch_delete_np --	thread context
     switches debugging	primitives

LIBRARY
     POSIX Threads Library (libpthread,	-lpthread)

SYNOPSIS
     #include <pthread_np.h>

     int
     pthread_switch_add_np(pthread_switch_routine_t routine);

     int
     pthread_switch_delete_np(pthread_switch_routine_t routine);

DESCRIPTION
     An	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 respec-
     tively.

RETURN VALUES
     If	successful, these functions return 0.  Otherwise, an error number is
     returned to indicate the error.

ERRORS
     The 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() func-
			tion.

SEE ALSO
     pthread_create(3)

AUTHORS
     This manual page was written by Alexey Zelkin <phantom@FreeBSD.org>.

BSD			       February	13, 2003			   BSD

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pthread_switch_add_np&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help