pthread_setschedparam

PTHREAD_SETSCHEDPARAM(3)                              PTHREAD_SETSCHEDPARAM(3)



NAME
       pthread_setschedparam,  pthread_getschedparam - control thread schedul-
       ing parameters


SYNOPSIS
       #include <pthread.h>

       int pthread_setschedparam(pthread_t target_thread,  int  policy,  const
       struct sched_param *param);

       int  pthread_getschedparam(pthread_t target_thread, int *policy, struct
       sched_param *param);


DESCRIPTION
       pthread_setschedparam sets the scheduling  parameters  for  the  thread
       target_thread  as  indicated by policy and param.  policy can be either
       SCHED_OTHER (regular,  non-realtime  scheduling),  SCHED_RR  (realtime,
       round-robin) or SCHED_FIFO (realtime, first-in first-out).  param spec-
       ifies the scheduling priority  for  the  two  realtime  policies.   See
       sched_setpolicy(2) for more information on scheduling policies.

       The  realtime scheduling policies SCHED_RR and SCHED_FIFO are available
       only to processes with superuser privileges.

       pthread_getschedparam retrieves the scheduling  policy  and  scheduling
       parameters for the thread target_thread and store them in the locations
       pointed to by policy and param, respectively.


RETURN VALUE
       pthread_setschedparam and pthread_getschedparam return 0 on success and
       a non-zero error code on error.


ERRORS
       On error, pthread_setschedparam returns the following error codes:

              EINVAL policy is not one of SCHED_OTHER, SCHED_RR, SCHED_FIFO


              EINVAL the  priority  value  specified by param is not valid for
                     the specified policy


              EPERM  the calling process does not have superuser permissions


              ESRCH  the target_thread is invalid or has already terminated


              EFAULT param points outside the process memory space

       On error, pthread_getschedparam returns the following error codes:

              ESRCH  the target_thread is invalid or has already terminated


              EFAULT policy or param point outside the process memory space


AUTHOR
       Xavier Leroy <Xavier.Leroy@inria.fr>


SEE ALSO
       sched_setscheduler(2),    sched_getscheduler(2),     sched_getparam(2),
       pthread_attr_setschedpolicy(3), pthread_attr_setschedparam(3).



                                 LinuxThreads         PTHREAD_SETSCHEDPARAM(3)