1SCHED_GETPARAM(3P)         POSIX Programmer's Manual        SCHED_GETPARAM(3P)
2
3
4

PROLOG

6       This  manual  page is part of the POSIX Programmer's Manual.  The Linux
7       implementation of this interface may differ (consult the  corresponding
8       Linux  manual page for details of Linux behavior), or the interface may
9       not be implemented on Linux.
10

NAME

12       sched_getparam - get scheduling parameters (REALTIME)
13

SYNOPSIS

15       #include <sched.h>
16
17       int sched_getparam(pid_t pid, struct sched_param *param);
18
19

DESCRIPTION

21       The sched_getparam() function shall return the scheduling parameters of
22       a  process  specified by pid in the sched_param structure pointed to by
23       param.
24
25       If a process specified by pid exists, and if the  calling  process  has
26       permission,  the scheduling parameters for the process whose process ID
27       is equal to pid shall be returned.
28
29       If pid is zero, the scheduling parameters for the calling process shall
30       be  returned. The behavior of the sched_getparam() function is unspeci‐
31       fied if the value of pid is negative.
32

RETURN VALUE

34       Upon successful completion, the sched_getparam() function shall  return
35       zero.  If  the  call  to sched_getparam() is unsuccessful, the function
36       shall return a value of -1 and set errno to indicate the error.
37

ERRORS

39       The sched_getparam() function shall fail if:
40
41       EPERM  The requesting process does not have permission  to  obtain  the
42              scheduling parameters of the specified process.
43
44       ESRCH  No process can be found corresponding to that specified by pid.
45
46
47       The following sections are informative.
48

EXAMPLES

50       None.
51

APPLICATION USAGE

53       None.
54

RATIONALE

56       None.
57

FUTURE DIRECTIONS

59       None.
60

SEE ALSO

62       sched_getscheduler(),  sched_setparam(), sched_setscheduler(), the Base
63       Definitions volume of IEEE Std 1003.1-2001, <sched.h>
64

66       Portions of this text are reprinted and reproduced in  electronic  form
67       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
68       -- Portable Operating System Interface (POSIX),  The  Open  Group  Base
69       Specifications  Issue  6,  Copyright  (C) 2001-2003 by the Institute of
70       Electrical and Electronics Engineers, Inc and The Open  Group.  In  the
71       event of any discrepancy between this version and the original IEEE and
72       The Open Group Standard, the original IEEE and The Open Group  Standard
73       is  the  referee document. The original Standard can be obtained online
74       at http://www.opengroup.org/unix/online.html .
75
76
77
78IEEE/The Open Group                  2003                   SCHED_GETPARAM(3P)
Impressum