posix_spawnattr_getschedpolicy or posix_spawnattr_setschedpolicy Subroutine

Purpose

Gets and sets the spawn-schedpolicy attribute of a spawn attributes object.

Syntax

#include <spawn.h>
#include <sched.h>

int posix_spawnattr_getschedpolicy(const posix_spawnattr_t *
       restrict attr, int *restrict schedpolicy);
int posix_spawnattr_setschedpolicy(posix_spawnattr_t *attr,
       int schedpolicy);

Description

The posix_spawnattr_getschedpolicy subroutine gets the value of the spawn-schedpolicy attribute from the attributes object referenced by attr.

The posix_spawnattr_setschedpolicy subroutine sets the spawn-schedpolicy attribute in an initialized attributes object referenced by attr.

The spawn-schedpolicy attribute represents the scheduling policy to be assigned to the new process image in a spawn operation (if POSIX_SPAWN_SETSCHEDULER is set in the spawn-flags attribute). The default value of this attribute is unspecified.

Return Values

Upon successful completion, the posix_spawnattr_getschedpolicy subroutine returns 0 and stores the value of the spawn-schedpolicy attribute of attr into the object referenced by the schedpolicy parameter; otherwise, an error number is returned to indicate the error.

Upon successful completion, posix_spawnattr_setschedpolicy returns 0; otherwise, an error number is returned to indicate the error.

Error Codes

The following posix_spawnattr_getschedpolicy and posix_spawnattr_setschedpolicy subroutines might fail if the following is true:
Item Description
EINVAL The value specified by attr is invalid.
The posix_spawnattr_setschedpolicy subroutine might fail if the following is true:
Item Description
EINVAL The value of the attribute being set is not valid.