.\" This -*- nroff -*- file has been generated from.\" DocBook SGML with docbook-to-man on Debian GNU/Linux....\"...\"	transcript compatibility for postscript use....\"...\"	synopsis:  .P! <file.ps>...\".de P!\\&..fl			\" force out current output buffer\\!%PB\\!/showpage{}def...\" the following is from Ken Flowers -- it prevents dictionary overflows\\!/tempdict 200 dict def tempdict begin.fl			\" prolog.sy cat \\$1\" bring in postscript file...\" the following line matches the tempdict above\\!end % tempdict %\\!PE\\!..sp \\$2u	\" move below the image...de pF.ie     \\*(f1 .ds f1 \\n(.f.el .ie \\*(f2 .ds f2 \\n(.f.el .ie \\*(f3 .ds f3 \\n(.f.el .ie \\*(f4 .ds f4 \\n(.f.el .tm ? font overflow.ft \\$1...de fP.ie     !\\*(f4 \{\.	ft \\*(f4.	ds f4\"'	br \}.el .ie !\\*(f3 \{\.	ft \\*(f3.	ds f3\"'	br \}.el .ie !\\*(f2 \{\.	ft \\*(f2.	ds f2\"'	br \}.el .ie !\\*(f1 \{\.	ft \\*(f1.	ds f1\"'	br \}.el .tm ? font underflow...ds f1\".ds f2\".ds f3\".ds f4\"'\" t .ta 8n 16n 24n 32n 40n 48n 56n 64n 72n  .TH "pthread_kill" "3" .SH "NAME" pthread_kill \(em send a signal to a thread .SH "SYNOPSIS" .PP .nf .ta 8n 16n 24n 32n 40n 48n 56n 64n 72n #include <rtl_signal.h> #include <rtl_sched.h>  int \fBpthread_kill\fP(pthread_t \fBthread\fR,\fBsigno\fR); .fi .SH "DESCRIPTION" .PP This function is a standard POSIX threads function.  \fBpthread_kill\fP sends signal \fBsigno\fR to the realtime thread \fBthread\fR previously created by a call to \fBpthread_create\fP.  \fBpthread_kill\fP is a fast and deterministic function if called on threads running on the same processor as the calling thread or interrupt handler. \fBpthread_kill\fP can be used to send signals to threads running on other than current CPU, but this is a more expensive  operation and there may be delays before the signal will be detected by the target thread. .SH "RETURN VALUE" .PP \fBpthread_kill\fP returns 0 on success and a non-zero error code on error. .SH "ERRORS" .IP "ESRCH" 10 No thread could be found corresponding to that specified by the given thread ID. .SH "AUTHOR" .PP Victor Yodaiken (\fIsupport@fsmlabs.com (link to URL mailto:support@fsmlabs.com) \fR) .SH "NOTES" .PP \fBpthread_kill\fP is safe to call from a signal handler, a thread and from Linux kernel code. \fBpthread_kill\fP is one of the primary means of sending signals to the general purpose operating system (Linux). A call \fBpthread_kill(\fBpthread_linux()\fR,\fBRTL_LINUX_MIN_SIGNA+n\fR)\fP for an integer value \fBn\fR will generate irq \fBn\fR in the Linux thread. .PP \fBpthread_kill(\fBpthread_linux()\fR,\fBRTL_SIG_SUSPEND_LINUX\fR)\fP sends the Linux thread on the  highest numbered  processor  an interrupt that will force Linux to suspend itself and to tell the hardware to ignore all non-RTLinux interrupts (if possible). This allows a processor on an SMP system to be dedicated to RTLinux. To restore suspended Linux threads, in order, use RTL_SIG_RESTART_LINUX. The RESERVE_PROCESSOR config option must be selected when building RTLinux to enable this  feature. .SH "SEE ALSO" \fIpthread_create(3) (link to URL pthread_create.3.html) \fR, \fIpthread_linux(3) (link to URL pthread_linux.3.html) \fR .PP \(co2001 FSMLabs Inc. .PP All rights reserved. ...\" created by instant / docbook-to-man, Thu 26 Jul 2001, 11:19