sched_getscheduler(2)

NAME
     sched_getscheduler - get the scheduling policy of a process

C SYNOPSIS
     #include <sched.h>
     int sched_getscheduler (pid_t pid);

DESCRIPTION
     The sched_getscheduler system call is used to get the scheduling policy
     of the process specified by pid.  If pid is set to zero, then the
     scheduling policy of the caller is returned.

     A process may obtain the scheduling policy of itself and any process
     sharing the same real user ID [see getuid(2)].  To obtain the scheduling
     policy of an unrelated process, the calling process must have the
     CAP_SCHED_MGT capability [see capability].

     If pid refers to a POSIX thread process [see pthreads(3P)] then this call
     retrieves the scheduling policy that is shared by process scope and bound
     scope threads.

     sched_getscheduler will fail if one or more of the following are true:

     [EINVAL]       The process specified by pid is not executing with a
                    scheduling policy.

     [EPERM]        The calling process attempted to obtain the scheduling
                    policy of an unrelated process and the caller does not
                    have the CAP_SCHED_MGT capability.

     [ESRCH]        The process specified by pid does not exist.

SEE ALSO
     capability(4), sched_setparam(2), sched_getparam(2),
     sched_setscheduler(2), sched_yield(2), sched_get_priority_max(2),
     sched_get_priority_min(2), sched_rr_get_interval(2), sproc(2), fork(2),
     getuid(2), pthreads(5)

DIAGNOSTICS
     Upon successful completion, one of the following scheduling policies is
     returned: SCHED_FIFO, SCHED_RR, SCHED_TS.  These scheduling policies are
     described in sched_setscheduler(2).

     Otherwise, a value of -1 is returned and errno is set to indicate the
     error.