pthread_suspend_np.3

rtlinux-3.1源代码

.\" 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_suspend_np" "3" 
.SH "NAME" 
pthread_suspend_np \(em suspend execution of a realtime thread. 
.SH "SYNOPSIS" 
.PP 
.nf 
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n 
#include <rtl_sched.h> 
 
int \fBpthread_suspend_np\fP(pthread_t \fBthread\fR); 
.fi 
.SH "DESCRIPTION" 
.PP 
This function is a non-portable Realtime Linux extension.  \fBpthread_suspend_np\fP suspends the execution of the thread \fBthread\fR until a call to \fBpthread_wakeup_np\fP.  Note:  If the target thread is running on a different processer, it is not guaranteed to be suspended immediately. Calls to \fBpthread_suspend_np(pthread_self())\fP do work immediately. 
.SH "RETURN VALUE" 
.PP 
Always returns 0. 
.SH "NOTES" 
.PP 
\fBpthread_suspend_np\fP 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 \fBpthread_suspend_np\fP, then  
the scheduler will save thread "A" and run another thread. If you call 
\fBpthread_suspend_np\fP 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. 
.SH "ERRORS" 
.PP 
None. 
.SH "AUTHOR" 
.PP 
Michael Barabanov (\[e-mail] (link to URL mailto:[e-mail]) \fR) 
.SH "SEE ALSO" 
\fIpthread_wakeup_np(3) (link to URL pthread_wakeup_np.3.html) \fR, \fIpthread_make_periodic_np(3) (link to URL pthread_make_periodic_np.3.html) \fR, \fIpthread_make_periodic_np(3) (link to URL pthread_kill.3.html) \fR 
.PP 
\(co2001 FSMLabs Inc. 
.PP 
All rights reserved. 
...\" created by instant / docbook-to-man, Thu 26 Jul 2001, 11:19