From 8b1ffe3ff3cb7a076afbf3893c08be41d25d7fb4 Mon Sep 17 00:00:00 2001 From: dg Date: Thu, 1 Sep 1994 09:52:37 +0000 Subject: Added rtprio system call stub and manual page. Submitted by: Henrik Vestergaard Draboel --- lib/libc/sys/Makefile.inc | 8 ++--- lib/libc/sys/rtprio.2 | 92 +++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 96 insertions(+), 4 deletions(-) create mode 100644 lib/libc/sys/rtprio.2 (limited to 'lib/libc') diff --git a/lib/libc/sys/Makefile.inc b/lib/libc/sys/Makefile.inc index b5a4054..81e803c 100644 --- a/lib/libc/sys/Makefile.inc +++ b/lib/libc/sys/Makefile.inc @@ -26,7 +26,7 @@ ASM= accept.o access.o acct.o adjtime.o bind.o chdir.o chflags.o chmod.o \ ntp_adjtime.o ntp_gettime.o open.o \ pathconf.o profil.o quotactl.o read.o \ readlink.o readv.o recvfrom.o recvmsg.o rename.o revoke.o rmdir.o \ - select.o sendmsg.o sendto.o setegid.o seteuid.o setgid.o \ + rtprio.o select.o sendmsg.o sendto.o setegid.o seteuid.o setgid.o \ setgroups.o setitimer.o setpgid.o setpriority.o setrlimit.o \ setsid.o setsockopt.o settimeofday.o setuid.o shutdown.o \ sigaction.o sigaltstack.o socket.o socketpair.o stat.o statfs.o \ @@ -92,9 +92,9 @@ MAN2+= sys/accept.2 sys/access.2 sys/acct.2 sys/adjtime.2 sys/bind.2 \ sys/mkfifo.2 sys/mknod.2 sys/madvise.2 sys/mincore.2 sys/mlock.2 \ sys/mmap.2 sys/mount.2 sys/mprotect.2 sys/msync.2 sys/munmap.2 \ sys/nfssvc.2 sys/open.2 sys/pathconf.2 sys/pipe.2 sys/profil.2 \ - sys/quotactl.2 \ - sys/read.2 sys/readlink.2 sys/reboot.2 sys/recv.2 sys/rename.2 \ - sys/revoke.2 sys/rmdir.2 sys/select.2 sys/send.2 sys/setgroups.2 \ + sys/quotactl.2 sys/read.2 sys/readlink.2 sys/reboot.2 sys/recv.2 \ + sys/rename.2 sys/revoke.2 sys/rmdir.2 sys/rtprio.2 sys/select.2 \ + sys/send.2 sys/setgroups.2 \ sys/setpgid.2 sys/setsid.2 sys/setuid.2 sys/shutdown.2 \ sys/sigaction.2 sys/sigpending.2 sys/sigprocmask.2 sys/sigreturn.2 \ sys/sigaltstack.2 sys/sigstack.2 sys/sigsuspend.2 sys/socket.2 \ diff --git a/lib/libc/sys/rtprio.2 b/lib/libc/sys/rtprio.2 new file mode 100644 index 0000000..8acac8a --- /dev/null +++ b/lib/libc/sys/rtprio.2 @@ -0,0 +1,92 @@ +.\" Copyright (c) 1994, Henrik Vestergaard Draboel +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by (name). +.\" 4. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" $Id$ +.\" +.Dd July 23, 1994 +.Dt RTPRIO 2 +.Os FreeBSD 1.1.5.1 +.Sh NAME +.Nm rtprio +.Nd examine or modify a process realtime scheduling priority +.Sh SYNOPSIS +.Fd #include +.Ft int +.Fn rtprio "pid_t pid" "int prio" +.Sh DESCRIPTION +Rtprio() is used to change or read the realtime priority of a process. + +.Fa pid +specifies the process to be used. If it is 0, the current process will +be used. + +.Fa prio +specifies the new priority of the process, or +.Dv RTPRIO_RTOFF , +for normal +(non-realtime) priority or +.Dv RTPRIO_NOCHG +for nochange (se RETURN VALUE). + +Legal values of priorities are between +.Dv RTPRIO_RTMIN (0) +and +.Dv RTPRIO_RTMAX (31) . +0 is the highest possible priority. + +Realtime priority is enherited through fork() and exec(). + +A realtime process can only be preempted by a process of equal or +higher priority, or an interrupt. Processes of equal realtime priority +are run in a round-robin schedule. +.Sh RETURN VALUES +If errno is not set, the new (or unchanged) realtime priority of the +process is returned. +.Sh ERRORS +.Fn Rtprio +will fail if +.Bl -tag -width Er +.It Bq Er EINVAL +The specified +.Fa prio +was out of range. +.It Bq Er EPERM +The calling process is not allowed to set the realtime priority. Only +root is allowed to change the realtime priority of any process. +.It Bq Er ESRCH +The specified process was not found. +.Sh AUTHOR +Henrik Vestergaard Draboel - hvd@terry.ping.dk +.Sh SEE ALSO +.Xr rtprio 1 , +.Xr nice 1 , +.Xr ps 1 , +.Xr nice 2 , +.Xr renice 8 + -- cgit v1.1