Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

sched_setparam(2) [linux man page]

SCHED_SETPARAM(2)					     Linux Programmer's Manual						 SCHED_SETPARAM(2)

NAME
sched_setparam, sched_getparam - set and get scheduling parameters SYNOPSIS
#include <sched.h> int sched_setparam(pid_t pid, const struct sched_param *param); int sched_getparam(pid_t pid, struct sched_param *param); struct sched_param { ... int sched_priority; ... }; DESCRIPTION
sched_setparam() sets the scheduling parameters associated with the scheduling policy for the process identified by pid. If pid is zero, then the parameters of the calling process are set. The interpretation of the argument param depends on the scheduling policy of the process identified by pid. See sched_setscheduler(2) for a description of the scheduling policies supported under Linux. sched_getparam() retrieves the scheduling parameters for the process identified by pid. If pid is zero, then the parameters of the calling process are retrieved. sched_setparam() checks the validity of param for the scheduling policy of the process. The value param->sched_priority must lie within the range given by sched_get_priority_min(2) and sched_get_priority_max(2). For a discussion of the privileges and resource limits related to scheduling priority and policy, see sched_setscheduler(2). POSIX systems on which sched_setparam() and sched_getparam() are available define _POSIX_PRIORITY_SCHEDULING in <unistd.h>. RETURN VALUE
On success, sched_setparam() and sched_getparam() return 0. On error, -1 is returned, and errno is set appropriately. ERRORS
EINVAL The argument param does not make sense for the current scheduling policy. EPERM The calling process does not have appropriate privileges (Linux: does not have the CAP_SYS_NICE capability). ESRCH The process whose ID is pid could not be found. CONFORMING TO
POSIX.1-2001. SEE ALSO
getpriority(2), nice(2), sched_get_priority_max(2), sched_get_priority_min(2), sched_getaffinity(2), sched_getscheduler(2), sched_setaffin- ity(2), sched_setscheduler(2), setpriority(2), capabilities(7) Programming for the real world - POSIX.4 by Bill O. Gallmeister, O'Reilly & Associates, Inc., ISBN 1-56592-074-0 COLOPHON
This page is part of release 3.27 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/. Linux 2006-03-23 SCHED_SETPARAM(2)

Check Out this Related Man Page

sched_getparam(3)					     Library Functions Manual						 sched_getparam(3)

NAME
sched_getparam - Returns the scheduling parameters of the specified process (P1003.1b) LIBRARY
Realtime Library (librt.so, librt.a) SYNOPSIS
#include <sched.h> int sched_getparam ( pid_t pid, struct sched_param *param); PARAMETERS
pid Specifies the ID of the process for which scheduling parameters are to be returned. If pid is zero, the scheduling parameters of the calling process are returned. *param Specifies a pointer to a sched_param structure to receive the scheduling parameters of the specified process. The priority field receives the current priority of the process specified by the pid. The sched_param structure is defined in <sched.h>. DESCRIPTION
The sched_getparam function returns the scheduling parameters of a process. If the pid is zero, the scheduling parameters are returned for the calling process. Use the sched_setparam function to change the scheduling parameters. Currently, the sched_param structure contains only a priority field. The priority of a process is inherited across fork and exec calls. No special privileges are needed to use the sched_getparam function. RETURN VALUES
On a successful call to the sched_getparam function, a value of 0 (zero) is returned. On an unsuccessful call, a value of -1 is returned and errno is set to indicate that an error occurred and that no scheduling parameters were returned. ERRORS
The sched_getparam function fails under the following conditions: [EINVAL] Invalid value specified for the pid argument, the param pointer is NULL, or one or more of the parameters in it is outside the valid range. [ESRCH] No process can be found corresponding to that specified by pid. RELATED INFORMATION
Functions: getpid(2), sched_getscheduler(3), sched_setparam(3), sched_setscheduler(3) Guide to Realtime Programming delim off sched_getparam(3)
Man Page