sched_rr_get_interval(3) [osf1 man page]

sched_rr_get_interval(3)				     Library Functions Manual					  sched_rr_get_interval(3)

NAME

       sched_rr_get_interval - Returns the current quantum for process execution under the SCHED_RR policy (P1003.1b)

LIBRARY

       Realtime Library (librt.so, librt.a)

SYNOPSIS

       #include <sched.h>

       int sched_rr_get_interval (
       pid_t pid,
       struct timespec *interval);

PARAMETERS

       pid	   Specifies the ID of the process for which the quantum is to be returned.

       *interval   Specifies the location to receive the current quantum for process execution under the SCHED_RR scheduling policy.

DESCRIPTION

       The  sched_rr_get_interval  function  updates the timespec structure referenced by the interval argument to contain the current quantum for
       the process executing under the SCHED_RR policy. If a process running under the round-robin scheduling  policy  runs  without  blocking	or
       yielding for more than this amount of time, it may be preempted by another runnable process (at the same priority).

       If the PID argument is zero, the current execution time limit for the calling process is returned.

       No special privileges are needed to use the sched_rr_get_interval function.

RETURN VALUES

       On  a successful call, a value of 0 (zero) is returned. On an unsuccessful call, a value of -1 is returned and errno is set to indicate the
       error.

ERRORS

       The sched_rr_get_interval fails under the following condition:

       [ESRCH]	      The value of the pid parameter does not indicate an existing process.

RELATED INFORMATION

       Functions: sched_getparam(3), sched_getscheduler(3), sched_setparam(3), sched_setscheduler(3)

       Guide to Realtime Programming delim off

															  sched_rr_get_interval(3)

sched_rr_get_interval(3RT)				    Realtime Library Functions					sched_rr_get_interval(3RT)

NAME

       sched_rr_get_interval - get execution time limits

SYNOPSIS

       cc [ flag... ] file... -lrt [ library... ]
       #include <sched.h>

       int sched_rr_get_interval(pid_t pid, struct timespec *interval);

DESCRIPTION

       The  sched_rr_get_interval()  function  updates the timespec structure referenced by the interval argument to contain the current execution
       time limit (that is, time quantum) for the process specified by pid. If pid is 0, the current execution time limit for the calling  process
       will be returned.

RETURN VALUES

       If successful, the sched_rr_get_interval() function returns 0. Otherwise, it returns -1 and sets errno to indicate the error.

ERRORS

       The  sched_rr_get_interval() function will fail if:

       ENOSYS	       The  sched_get_priority_max(3RT),  sched_get_priority_min(3RT),	and sched_rr_get_interval() functions are not supported by
		       the system.

       ESRCH	       No process can be found corresponding to that specified by pid.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       librt(3LIB),    sched.h(3HEAD),	  sched_getparam(3RT),	  sched_setparam(3RT),	  sched_get_priority_max(3RT),	  sched_getscheduler(3RT),
       sched_setscheduler(3RT), attributes(5)

NOTES

       Solaris	2.6  was  the  first  release to support libposix4/librt. Prior to this release, this function always returned -1 and set errno to
       ENOSYS.

SunOS 5.10							    5 Oct 2001						sched_rr_get_interval(3RT)