pthread_make_periodic_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_make_periodic_np" "3" 
.SH "NAME" 
pthread_make_periodic_np \(em mark a realtime thread as periodic 
.SH "SYNOPSIS" 
.PP 
.nf 
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n 
#include <rtl_sched.h> 
 
int \fBpthread_make_periodic_np\fP(pthread_t \fBthread\fR, hrtime_t \fBstart_time\fR, hrtime_t \fBperiod\fR); 
.fi 
.SH "DESCRIPTION" 
.PP 
This function is a non-portable Realtime Linux extension.  \fBpthread_make_periodic_np\fP marks the thread \fBthread\fR as ready for execution.  The thread will start its execution at \fBstart_time\fR (as shown by the clock used for scheduling) and will run at intervals specified by \fBperiod\fR given in nanoseconds. RTLinux 
will attempt to make thread timing as close as possible to what is specified,  
but start time and period depend on the hardware clock resolution. 
.SH "RETURN VALUE" 
.PP 
\fBpthread_make_periodic_np\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 "NOTES" 
.PP 
This function may not be used on threads assigned to a CPU other than the current. 
.PP 
The recommended way to implement periodic threads is to use \fBclock_nanosleep(3)\fP. 
.SH "AUTHOR" 
.PP 
Michael Barabanov (\[e-mail] (link to URL mailto:[e-mail]) \fR) 
.SH "SEE ALSO" 
\fIpthread_wait_np(3) (link to URL pthread_wait_np.3.html) \fR, \fIUNIX spec pthread_create(3) (link to URL ../susv2/xsh/pthread_create.html) \fR, \fIUNIX spec clock_gettime(3) (link to URL ../susv2/xsh/clock_gettime.html) \fR, \fIclock_gethrtime(3) (link to URL clock_gethrtime.3.html) \fR, \fIgethrtime(3) (link to URL gethrtime.3.html) \fR, \fIrtl_getschedclock (link to URL rtl_getschedclock.3.html) \fR 
.PP 
\(co2001 FSMLabs Inc. 
.PP 
All rights reserved. 
...\" created by instant / docbook-to-man, Thu 26 Jul 2001, 11:19