posix_spawnattr_getschedparam(), posix_spawnattr_setschedparam()

get and set the spawn-schedparam attribute of a spawn attributes object 

Advanced Realtime Function


SYNOPSIS

#include <spawn.h>

#include <sched.h>

int posix_spawnattr_getschedparam(const posix_spawnattr_t *restrict attr, struct sched_param *restrict schedparam);

int posix_spawnattr_setschedparam(posix_spawnattr_t *restrict attr, const struct sched_param *restrict schedparam);


DESCRIPTION

The posix_spawnattr_getschedparam() function retrieves the value of the spawn-schedparam attribute from the attr spawn attributes object. The retrieved value is stored in the object pointed to by schedparam.

The posix_spawnattr_setschedparam() function sets the spawn-schedparam attribute in an initialized spawn attributes object pointed to by attr. The schedparam argument points to the value used for setting the attribute.

The spawn-schedparam attribute indicates the scheduling parameters to be assigned when a new process image is created by a spawn operation (when POSIX_SPAWN_SETSCHEDULER or POSIX_SPAWN_SETSCHEDPARAM is set in the spawn-flags attribute).


PARAMETERS

attr 

Points to a spawn attributes object.

schedparam 

Points to the value retrieved by posix_spawnattr_getschedparam() or to the value to be assigned to the spawn-schedparam attribute by posix_spawnattr_setschedparam().


RETURN VALUES

On success, posix_spawnattr_getschedparam() and posix_spawnattr_setschedparam() return 0. Additionally, posix_spawnattr_getschedparam() places the value retrieved from the spawn-schedparam attribute of the attr spawn attributes object in the object pointed to by schedparam.

Otherwise, one of the following error numbers is returned:

EINVAL 

The attr or schedparam arguments contains an invalid value.

ENOSYS 

The requested action could not be performed.


CONFORMANCE

UNIX 03.


MULTITHREAD SAFETY LEVEL

MT-Safe.


PORTING ISSUES

These functions are provided only to ease the porting of applications from UNIX systems to Windows systems. Calls to these functions always fail with a return value of ENOSYS.


AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition


SEE ALSO

Functions:
posix_spawn(), posix_spawnattr_destroy(), posix_spawnattr_getflags(), posix_spawnattr_getpgroup(), posix_spawnattr_getschedpolicy(), posix_spawnattr_getsigdefault(), posix_spawnattr_getsigmask(), posix_spawnattr_init(), posix_spawnattr_setflags(), posix_spawnattr_setpgroup(), posix_spawnattr_setschedpolicy(), posix_spawnattr_setsigdefault(), posix_spawnattr_setsigmask(), posix_spawnp()

Miscellaneous:
sched, spawn


PTC MKS Toolkit 10.4 Documentation Build 39.