GENWiki

Premier IT Outsourcing and Support Services within the UK

User Tools

Site Tools


man:pthread_setschedprio

PTHREAD_SETSCHEDPRIO(3) Linux Programmer's Manual PTHREAD_SETSCHEDPRIO(3)

NAME

     pthread_setschedprio - set scheduling priority of a thread

SYNOPSIS

     #include <pthread.h>
     int pthread_setschedprio(pthread_t thread, int prio);
     Compile and link with -pthread.

DESCRIPTION

     The pthread_setschedprio() function sets the scheduling priority of the
     thread  thread  to  the  value  specified  in   prio.    (By   contrast
     pthread_setschedparam(3)  changes both the scheduling policy and prior-
     ity of a thread.)

RETURN VALUE

     On success, this function returns 0; on error,  it  returns  a  nonzero
     error number.  If pthread_setschedprio() fails, the scheduling priority
     of thread is not changed.

ERRORS

     EINVAL prio is not valid for the scheduling  policy  of  the  specified
            thread.
     EPERM  The caller does not have appropriate privileges to set the spec-
            ified priority.
     ESRCH  No thread with the ID thread could be found.
     POSIX.1 also documents an ENOTSUP ("attempt was made to set the  prior-
     ity to an unsupported value") error for pthread_setschedparam(3).

VERSIONS

     This function is available in glibc since version 2.3.4.

ATTRIBUTES

     For   an   explanation   of   the  terms  used  in  this  section,  see
     attributes(7).
     +-----------------------+---------------+---------+
     |Interface              | Attribute     | Value   |
     +-----------------------+---------------+---------+
     |pthread_setschedprio() | Thread safety | MT-Safe |
     +-----------------------+---------------+---------+

CONFORMING TO

     POSIX.1-2001, POSIX.1-2008.

NOTES

     For  a  description  of the permissions required to, and the effect of,
     changing a thread's scheduling priority, and details of  the  permitted
     ranges for priorities in each scheduling policy, see sched(7).

SEE ALSO

     getrlimit(2), sched_get_priority_min(2), pthread_attr_init(3),
     pthread_attr_setinheritsched(3), pthread_attr_setschedparam(3),
     pthread_attr_setschedpolicy(3), pthread_create(3), pthread_self(3),
     pthread_setschedparam(3), pthreads(7), sched(7)

COLOPHON

     This page is part of release 4.16 of the Linux man-pages project.  A
     description of the project, information about reporting bugs, and the
     latest version of this page, can be found at
     https://www.kernel.org/doc/man-pages/.

Linux 2015-08-08 PTHREAD_SETSCHEDPRIO(3)

/data/webs/external/dokuwiki/data/pages/man/pthread_setschedprio.txt · Last modified: 2019/05/17 09:47 by 127.0.0.1

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki