runmask

QNX SDP8.0PLMS User's GuideAPIConfigurationDeveloper
Note:
This keyword is only valid on QOS 2.2.x.

Format

runmask = runmask_value

Description

The runmask keyword specifies which processor a process can run on and is interpreted as a bitmask. The value is a 32-bit integer and can be specified using any format that strtol() recognizes. Refer to the QNX SDP documentation for more information on runmasks.

Examples

To run only on cores 0 and 1, set runmask to the following:

runmask = 0x3

Default

The system default is 0xFFFFFFFFU, indicating that a spawned process can run on any processor.

Multiplicity

Zero or one instance in a task block.

Constraints

  • The value is validated during parsing against the number of available CPUs.

  • The configuration file is rejected if the given value refers to non-existing CPU number.

  • The runmask that PLMS is started with will not be inherited by the child process.

  • Runmask 0 has the same meaning as system default runmask 0xFFFF_FFFF.

  • If runmask is specified in a task, then the task must have one of the exec*() functions so that runmask is used at run time.

Page updated: