sched_rr_get_interval(2)

1RR_GET_INTERVAL(2)         Linux Programmer's Manual        RR_GET_INTERVAL(2)
2
3
4

NAME

6       sched_rr_get_interval   -  get  the  SCHED_RR  interval  for  the named
7       process
8

SYNOPSIS

10       #include <sched.h>
11
12       int sched_rr_get_interval(pid_t pid, struct timespec *tp);
13
14       struct timespec {
15           time_t  tv_sec;     /* seconds */
16           long    tv_nsec;    /* nanoseconds */
17       };
18

DESCRIPTION

20       sched_rr_get_interval() writes into the timespec structure  pointed  to
21       by  tp  the round robin time quantum for the process identified by pid.
22       If pid is zero, the time quantum for the  calling  process  is  written
23       into  *tp.  The identified process should be running under the SCHED_RR
24       scheduling policy.
25
26       The round robin time quantum value is not alterable under Linux 1.3.81.
27
28       POSIX systems on  which  sched_rr_get_interval()  is  available  define
29       _POSIX_PRIORITY_SCHEDULING in <unistd.h>.
30
31

RETURN VALUE

33       On  success,  sched_rr_get_interval()  returns  0.   On  error,  -1  is
34       returned, and errno is set appropriately.
35

ERRORS

37       EFAULT Problem with copying information to userspace.
38
39       EINVAL Invalid pid.
40
41       ENOSYS The system call is not yet implemented.
42
43       ESRCH  The process whose ID is pid could not be found.
44

CONFORMING TO

46       POSIX.1-2001.
47

BUGS

49       As of Linux 1.3.81 sched_rr_get_interval() returns with  error  ENOSYS,
50       because  SCHED_RR  has  not yet been fully implemented and tested prop‐
51       erly.
52