*** UNIX MANUAL PAGE BROWSER ***

sched_getparam(3) Library Functions Manual sched_getparam(3) NAME sched_getparam - Return the scheduling parameters of the specified process (P1003.1b) SYNOPSIS #include <sched.h> int sched_getparam ( pid_t pid, struct sched_param *param); PARAMETERS pid The process identification of the process whose scheduling pa- rameters are returned. If pid is zero, the scheduling parame- ters of the calling process are returned. *param A pointer to a sched_param structure, which contains the sched- uling parameters of the calling process. The value of the pri- ority field is 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 is returned. On an unsuccessful call, a value of -1 is returned and errno is set to indicate that an error occurred and the specified priority is unchanged. 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) delim off sched_getparam(3)