SchedSet(), SchedSet_r()

Set the scheduling policy for a thread

Synopsis:

#include <sys/neutrino.h>

int SchedSet( 
       pid_t pid,
       int tid,
       int policy,
       const struct sched_param * param );

int SchedSet_r(
       pid_t pid,
       int tid,
       int policy,
       const struct sched_param * param );

Arguments:

pid

0 or a process ID; see below.

tid

0 or a thread ID; see below.

policy

The scheduling policy; one of:

• SCHED_FIFO -- a fixed-priority scheduler in which the highest priority, ready thread runs until it blocks or is preempted by a higher priority thread.
• SCHED_RR -- the same as SCHED_FIFO, except threads at the same priority level time slice (round robin) every 50 msec.
• SCHED_OTHER -- currently the same as SCHED_RR.
• SCHED_NOCHANGE -- this isn't actually a policy, but a special value that tells the kernel to update the parameters specified in param, without changing the policy.

param

A pointer to a sched_param structure where the function can store the scheduling parameters. This structure includes these members:

• int sched_priority -- the priority of the thread.

  The value of this member must be between the minimum and maximum values returned by sched_get_priority_min() and sched_get_priority_max() for the specified scheduling policy.

Library:

libc

Description:

These kernel calls set both the scheduling policy and the associated parameters for the thread specified by tid in the process specified by pid. If pid is zero the current process is used to look up a nonzero tid. If tid is zero, then the calling thread is used and pid is ignored.

The SchedSet() and SchedSet_r() functions are identical except in the way they indicate errors. See the Returns section for details.

Blocking states

These calls don't block.

Returns:

The only difference between these functions is the way they indicate errors:

SchedSet()

If an error occurs, -1 is returned and errno is set. Any other value returned indicates success.

SchedSet_r()

EOK is returned on success. This function does NOT set errno. If an error occurs, any value in the Errors section may be returned.

Errors:

EFAULT

A fault occurred when the kernel tried to access the buffers you provided.

EINVAL

The given scheduling policy is invalid.

EPERM

The process doesn't have permission to change the scheduling of the indicated thread.

ESRCH

The process indicated by pid or thread indicated by tid doesn't exist.

Classification:

QNX 6

See also:

sched_get_priority_max(), sched_get_priority_min(), SchedGet(), SchedInfo(), SchedYield()