rtprio man page on PC-BSD

Man page or keyword search:  
man Server   9747 pages
apropos Keyword Search (all sections)
Output format
PC-BSD logo
[printable version]

RTPRIO(2)		    BSD System Calls Manual		     RTPRIO(2)

NAME
     rtprio — examine or modify a process realtime or idle priority

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <sys/types.h>
     #include <sys/rtprio.h>

     int
     rtprio(int function, pid_t pid, struct rtprio *rtp);

DESCRIPTION
     The rtprio() system call is used to lookup or change the realtime or idle
     priority of a process.

     The function argument specifies the operation to be performed.
     RTP_LOOKUP to lookup the current priority, and RTP_SET to set the prior‐
     ity.  The pid argument specifies the process to be used, 0 for the cur‐
     rent process.

     The *rtp argument is a pointer to a struct rtprio which is used to spec‐
     ify the priority and priority type.  This structure has the following
     form:

     struct rtprio {
	     u_short type;
	     u_short prio;
     };

     The value of the type field may be RTP_PRIO_REALTIME for realtime priori‐
     ties, RTP_PRIO_NORMAL for normal priorities, and RTP_PRIO_IDLE for idle
     priorities.  The priority specified by the prio field ranges between 0
     and RTP_PRIO_MAX (usually 31).  0 is the highest possible priority.

     Realtime and idle priority is inherited through fork() and exec().

     A realtime process can only be preempted by a process of equal or higher
     priority, or by an interrupt; idle priority processes will run only when
     no other real/normal priority process is runnable.	 Higher real/idle pri‐
     ority processes preempt lower real/idle priority processes.  Processes of
     equal real/idle priority are run round-robin.

RETURN VALUES
     The rtprio() function returns the value 0 if successful; otherwise the
     value -1 is returned and the global variable errno is set to indicate the
     error.

ERRORS
     The rtprio() system call will fail if

     [EINVAL]		The specified prio was out of range.

     [EPERM]		The calling process is not allowed to set the realtime
			priority.  Only root is allowed to change the realtime
			priority of any process, and non-root may only change
			the idle priority of the current process.

     [ESRCH]		The specified process was not found.

SEE ALSO
     nice(1), ps(1), rtprio(1), setpriority(2), nice(3), renice(8)

AUTHORS
     The original author was Henrik Vestergaard Draboel ⟨hvd@terry.ping.dk⟩.
     This implementation in FreeBSD was substantially rewritten by David
     Greenman.

BSD				 July 23, 1994				   BSD
[top]

List of man pages available for PC-BSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net