Content-type: text/html Man page of sched_getparam

sched_getparam

Section: C Library Functions (3)
Index Return to Main Contents
 

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 parameters are returned. If pid is zero, the scheduling parameters of the calling process are returned.
*param
A pointer to a sched_param structure, which contains the scheduling parameters of the calling process. The value of the priority 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


 

Index

NAME
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:50 GMT, October 02, 2010