Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PTHREAD_SCHEDPARAM(3)	    Library Functions Manual	 PTHREAD_SCHEDPARAM(3)

NAME
       pthread_setschedparam, pthread_getschedparam -- thread scheduling para-
       meter manipulation

LIBRARY
       POSIX Threads Library (libpthread, -lpthread)

SYNOPSIS
       #include	<pthread.h>

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

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

DESCRIPTION
       The  pthread_setschedparam()  and pthread_getschedparam() functions set
       and get the scheduling parameters of individual threads.	 The  schedul-
       ing policy for a	thread can either be SCHED_FIFO	(first in, first out),
       SCHED_RR	 (round-robin),	 or  SCHED_OTHER  (timesharing).  Valid	thread
       priorities (accessed via	 param->sched_priority)	 must  be  within  the
       range	 returned     by     the     sched_get_priority_min(2)	   and
       sched_get_priority_max(2) system	calls.

RETURN VALUES
       If successful, these functions return 0.	 Otherwise, an error number is
       returned	to indicate the	error.

ERRORS
       The pthread_setschedparam() function will fail if:

       [EINVAL]		  Invalid value	for policy.

       [ENOTSUP]	  Invalid value	for scheduling parameters.

       [EPERM]		  The calling thread does not have  sufficient	privi-
			  lege to perform the operation.

       [ESRCH]		  Non-existent thread thread.

       The pthread_getschedparam() function will fail if:

       [ESRCH]		  Non-existent thread thread.

SEE ALSO
       sched_get_priority_max(2), sched_get_priority_min(2)

STANDARDS
       The  pthread_setschedparam() and	pthread_getschedparam()	functions con-
       form to Version 2 of the	Single UNIX Specification ("SUSv2").

FreeBSD	14.3		       October 17, 2022		 PTHREAD_SCHEDPARAM(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pthread_setschedparam&sektion=3&manpath=FreeBSD+14.3-RELEASE+and+Ports>

home | help