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 superuser
     permissions.

     If pid refers to a POSIX thread process [see pthreads(3P)] then this call
     retrieves the scheduling policy that is shared by process 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 superuser permissions.

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

SEE ALSO
     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.