sched_getparam Subroutine
Purpose
Gets scheduling parameters.
Library
Standard C Library (libc.a)
Syntax
#include <sched.h>
int sched_getparam (pid, param)
pit_t pid;
struct sched_param *param;Description
The sched_getparam subroutine returns the scheduling parameters of a process specified by the pid parameter in the sched_param structure.
If a process specified by the pid parameter exists, and if the calling process has permission, the scheduling parameters for the process whose process ID is equal to the value of the pid parameter are returned.
If the pid parameter is zero, the scheduling parameters for the calling process are returned.
Parameters
| Item | Description |
|---|---|
| pid | Specifies the process for which the scheduling parameters are retrieved. |
| param | Points to the sched_param structure. |
Return Values
Upon successful completion, the sched_getparam subroutine returns zero. If the sched_getparam subroutine is unsuccessful, -1 is returned and errno is set to indicate the error.
Error Codes
The sched_rr_get_interval subroutine fails if:
| Item | Description |
|---|---|
| EINVAL | The param parameter is null or a bad address. |
| ENOTSUP | This interface does not support processes capable of checkpoint. |
| EPERM | The requesting process does not have permission to obtain the scheduling parameters of the specified process. |
| ESRCH | The pid parameter is negative, or no process can be found that corresponds to the one specified by the pid parameter. |