posix_spawnattr_addpartid()

Synopsis:

#include <spawn.h>

int posix_spawnattr_addpartid(
       posix_spawnattr_t *_Restrict attrp,
       part_id_t part_id,
       part_dcmd_flags_t part_flags);

Arguments:

attrp: A pointer to the spawn attributes object that you want to modify.
part_id: A unique partition identifier for the partition that you want to associate the spawned process with. You can retrieve the ID by sending the appropriate devctl() command to the partition manager.
part_flags: The flags you want to associate with the partition. No flags are currently defined, so pass 0 for this argument.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The posix_spawnattr_addpartid() specifies, by its partition identifier, a resource partition that the spawned process should be associated with. You must have already initialized the spawn attributes object by calling posix_spawnattr_init(). If you specify an ID for a non-existent partition, it won't be known until the posix_spawn() call is made.

An additional form for this call, posix_spawnattr_addschedpartid(), is implemented as a macro in <spawn.h>.

The partition association takes effect only if the POSIX_SPAWN_SETSPART flag is set in the spawn attributes; to set this flag, call posix_spawnattr_setxflags(). Setting this flag without specifying a scheduling partition may produce unintended results.

Note: This function is a QNX Neutrino extension.

For information about inheritance rules as they apply to partition association, see the Adaptive Partitioning User's Guide.

Returns:

EOK: Success.
EINVAL: An argument was invalid.
ENOMEM: The partition ID couldn't be added to the attributes object.

Note: Some partition association errors may not be reported until the posix_spawn() call is made.

Classification:

QNX Neutrino

Safety:
Cancellation point	No
Interrupt handler	Yes
Signal handler	Yes
Thread	Yes