Home
QNX Software Development Platform
QNX SDP is a cross-compiling and debugging environment, including an IDE and command-line tools, for building binary images and programs for target boards running the QNX OS 8.0.
Utilities & Libraries
C Library Reference
P
posix_spawnattr_setrunmask()
Set the runmask attribute in a spawn attributes object

QNX Momentics IDE User's Guide
This User's Guide describes version 8.0 of the Integrated Development Environment (IDE) that's part of the QNX Tool Suite.
QNX Software Development Platform
QNX SDP is a cross-compiling and debugging environment, including an IDE and command-line tools, for building binary images and programs for target boards running the QNX OS 8.0.
- Quickstart Guide
- System Architecture
  The System Architecture guide accompanies the QNX OS and is intended for both application developers and end-users.
- OS Components & Operations
- Graphics
- Programming
- System Security Guide
  The QNX System Security Guide is intended for both system integrators who are responsible for the security of a QNX OS system and developers who want to create a QNX OS resource manager free from vulnerabilities.
- Utilities & Libraries
  - C Library Reference
    - What's in a Function Description?
    - Manifests
    - Character Sets
    - A
    - B
    - C
    - D
    - E
    - F
    - G
    - H
    - I
    - J
    - K
    - L
    - M
    - N
    - O
    - P
      - pathconf()
        Return the value of a configurable limit
      - pathfind(), pathfind_r()
        Search for a file in a list of directories
      - pathmgr_link()
        Create a node in the path space that represents the mountpoint of a device or filesystem
      - pathmgr_symlink()
        Create a procmgr symlink
      - pathmgr_unlink()
        Remove a link
      - pause()
        Suspend the calling thread until it runs a signal handler
      - _PAYLOAD_OF()
        Generate a pointer to the payload that follows the specified header member of an object
      - pci_*()
        Connect to the PCI server
      - pclose()
        Close a pipe
      - perror()
        Print an error message associated with errno
      - pipe()
        Create a pipe
      - pipe2()
        Create a pipe with additional control flags.
      - poll()
        Multiplex input/output over a set of file descriptors
      - popen()
        Execute a command, creating a pipe to it
      - posix_devctl()
        Control a device
      - posix_fadvise(), posix_fadvise64()
        Provide advisory information about the expected use of a file
      - posix_fallocate(), posix_fallocate64()
        Allocate space for a file on the filesystem
      - posix_madvise()
        Provide advisory information about the expected use of memory
      - posix_mem_offset(), posix_mem_offset64()
        Get the physical address and length of a mapped memory block
      - posix_memalign()
        Allocate aligned memory
      - posix_openpt()
        Open a pseudo-terminal device
      - posix_spawn(), posix_spawnp()
        Spawn a process
      - posix_spawn_file_actions_addclose()
        Add a close a file descriptor action to a spawn file actions object
      - posix_spawn_file_actions_adddup2()
        Add a duplicate a file descriptor action to a spawn file actions object
      - posix_spawn_file_actions_addopen()
        Add an open a file action to a spawn file action object
      - posix_spawn_file_actions_destroy()
        Destroy a spawn file actions object
      - posix_spawn_file_actions_init()
        Initialize a spawn file actions object
      - posix_spawnattr_destroy()
        Destroy a spawn attributes object
      - posix_spawnattr_getaslr()
        Return the address space layout randomization (ASLR) setting from a posix_spawn() attribute structure
      - posix_spawnattr_getcred()
        Get the user and group ID attributes from a spawn attributes object
      - posix_spawnattr_getflags()
        Get the POSIX flags from a spawn attributes object
      - posix_spawnattr_getpgroup()
        Get the process group attribute of a spawn attributes object
      - posix_spawnattr_getrunmask()
        Get the runmask attribute from a spawn attributes object
      - posix_spawnattr_getschedparam()
        Get the scheduling parameters attribute of a spawn attributes object
      - posix_spawnattr_getschedpolicy()
        Get the scheduling policy attribute of a spawn attributes object
      - posix_spawnattr_getsigdefault()
        Get the default signals attribute of a spawn attributes object
      - posix_spawnattr_getsigignore()
        Get the ignored signals attribute from a spawn attributes object
      - posix_spawnattr_getsigmask()
        Get the signal mask attribute of a spawn attributes object
      - posix_spawnattr_getstackmax()
        Get the maximum stack size attribute from a spawn attributes object
      - posix_spawnattr_gettypeid()
        Get the type identifier of a spawn attributes object
      - posix_spawnattr_getxflags()
        Get the POSIX flags and the QNX OS extended flags from a spawn attributes object
      - posix_spawnattr_init()
        Initialize a spawn attributes object
      - posix_spawnattr_setasid()
        Set the address space ID attribute in a spawn attributes object
      - posix_spawnattr_setaslr()
        Control how the address space layout randomization (ASLR) setting of a child is determined
      - posix_spawnattr_setcred()
        Set the user and group ID attributes in a spawn attributes object
      - posix_spawnattr_setcwd_np()
        Set the current working directory attribute in a spawn attributes object
      - posix_spawnattr_setflags()
        Set the POSIX flags in a spawn attributes object
      - posix_spawnattr_setpgroup()
        Set the process group attribute in a spawn attributes object
      - posix_spawnattr_setrunmask()
        Set the runmask attribute in a spawn attributes object
      - posix_spawnattr_setschedparam()
        Set the scheduling parameters attribute of a spawn attributes object
      - posix_spawnattr_setschedpolicy()
        Set the scheduling policy attribute of a spawn attributes object
      - posix_spawnattr_setsigdefault()
        Set the default signals attribute of a spawn attributes object
      - posix_spawnattr_setsigignore()
        Set the ignored signals attribute of a spawn attributes object
      - posix_spawnattr_setsigmask()
        Set the signal mask attribute of a spawn attributes object
      - posix_spawnattr_setstackmax()
        Set the maximum stack size attribute in a spawn attributes object
      - posix_spawnattr_settypeid()
        Set the type identifier of a spawn attributes object
      - posix_spawnattr_setxflags()
        Set the POSIX flags and the QNX OS extended flags in a spawn attributes object
      - posix_typed_mem_get_info()
        Get information about a typed memory object
      - posix_typed_mem_open()
        Open a typed memory object
      - pow(), powf(), powl()
        Raise a number to a given power
      - pread(), pread64()
        Read from a file without moving the file pointer
      - printf()
        Write formatted output to stdout
      - prlimit(), prlimit64()
        Set and get the limit on a system resource
      - procmgr_ability()
        Control a process's ability to perform certain operations
      - procmgr_ability_create()
        Create a process-manager ability
      - procmgr_ability_lookup()
        Look up a process-manager ability
      - procmgr_ability_name()
        Get the name of a custom ability
      - procmgr_daemon()
        Run a process in the background
      - procmgr_event_notify()
        Ask to be notified of system-wide events
      - procmgr_event_notify_add()
        Add a request to be notified of system-wide events
      - procmgr_event_notify_delete()
        Delete a request to be notified of system-wide events
      - procmgr_event_trigger(), procmgr_event_trigger_updateable()
        Trigger a system-wide event
      - procmgr_session(), procmgr_session_ext()
        Provide process manager session support
      - procmgr_set_type_id()
        Allows a function to change its own type identifier
      - procmgr_timer_tolerance()
        Get or set the default timer tolerance for a process
      - procmgr_value_current()
        Get the current value of an item being monitored
      - procmgr_value_notify_add()
        Add an event to be triggered when a monitored value crosses a trigger point
      - __progname
        The basename of the program being executed
      - pthread_abort()
        Unconditionally terminate the target thread
      - pthread_atfork()
        Register fork handlers
      - pthread_attr_destroy()
        Destroy a thread-attribute object
      - pthread_attr_getdetachstate()
        Get the thread detach state attribute
      - pthread_attr_getguardsize()
        Get the size of the thread's guard area
      - pthread_attr_getinheritsched()
        Get a thread's inherit-scheduling attribute
      - pthread_attr_getschedparam()
        Get the thread scheduling parameters attribute
      - pthread_attr_getschedpolicy()
        Get the thread scheduling policy attribute
      - pthread_attr_getscope()
        Get the thread contention scope attribute
      - pthread_attr_getstack()
        Get the thread-creation stack attributes
      - pthread_attr_getstackaddr()
        Get the thread stack address attribute
      - pthread_attr_getstacklazy()
        Get the thread lazy-stack attribute
      - pthread_attr_getstackprealloc()
        Get the amount of memory to preallocate for a thread's MAP_LAZY stack
      - pthread_attr_getstacksize()
        Get the thread stack-size attribute
      - pthread_attr_getsuspendstate_np()
        Get the thread suspend state attribute
      - pthread_attr_init()
        Initialize a thread-attribute object
      - pthread_attr_setdetachstate()
        Set the thread detach state attribute
      - pthread_attr_setguardsize()
        Set the size of the thread's guard area
      - pthread_attr_setinheritsched()
        Set the thread's inherit-scheduling attribute
      - pthread_attr_setschedparam()
        Set a thread's scheduling parameters attribute
      - pthread_attr_setschedpolicy()
        Set the thread scheduling policy attribute
      - pthread_attr_setscope()
        Set the thread contention scope attribute
      - pthread_attr_setstack()
        Set the thread-creation stack attributes
      - pthread_attr_setstackaddr()
        Set the thread stack address attribute
      - pthread_attr_setstacklazy()
        Set the thread lazy-stack attribute
      - pthread_attr_setstackprealloc()
        Set the amount of memory to preallocate for a thread's MAP_LAZY stack
      - pthread_attr_setstacksize()
        Set the thread stack-size attribute
      - pthread_attr_setsuspendstate_np()
        Set the thread suspend state attribute
      - pthread_barrier_destroy()
        Destroy a barrier object
      - pthread_barrier_init()
        Initialize a barrier object
      - pthread_barrier_wait()
        Synchronize participating threads at the barrier
      - pthread_barrierattr_destroy()
        Destroy a barrier-attributes object
      - pthread_barrierattr_getpshared()
        Get the value of a barrier's process-shared attribute
      - pthread_barrierattr_init()
        Initialize a barrier attributes object
      - pthread_barrierattr_setpshared()
        Set the value of a barrier's process-shared attribute
      - pthread_cancel()
        Cancel a thread
      - pthread_cleanup_pop()
        Pop a function off of a thread's cancellation-cleanup stack
      - pthread_cleanup_push()
        Push a function onto a thread's cancellation-cleanup stack
      - pthread_cluster_get_runmask()
        Validate a cluster name and provide its associated runmask
      - pthread_cluster_set()
        Set cluster characteristics for the calling thread
      - pthread_cluster_set_and_inherit()
        Set cluster characteristics for the calling thread and for its children to inherit
      - pthread_cond_broadcast()
        Unblock threads waiting on a condition
      - pthread_cond_clockwait()
        Wait on a condition variable, with a time limit measured against a specific clock
      - pthread_cond_destroy()
        Destroy a condition variable
      - pthread_cond_init()
        Initialize a condition variable
      - pthread_cond_signal()
        Unblock a thread that's waiting on a condition variable
      - pthread_cond_timedwait()
        Wait on a condition variable, with a time limit
      - pthread_cond_wait()
        Wait on a condition variable
      - pthread_condattr_destroy()
        Destroy a condition-variable attribute object
      - pthread_condattr_getclock()
        Get the clock attribute from a condition-variable attribute object
      - pthread_condattr_getpshared()
        Get the process-shared attribute from a condition variable attribute object
      - pthread_condattr_init()
        Initialize the attribute object for creating condition variables
      - pthread_condattr_setclock()
        Set the clock attribute of a condition-variable attribute object
      - pthread_condattr_setpshared()
        Set the process-shared attribute in a condition variable attribute object
      - pthread_create()
        Create a thread
      - pthread_detach()
        Detach a thread from a process
      - pthread_equal()
        Compare two thread IDs
      - pthread_exit()
        Terminate a thread
      - pthread_getconcurrency()
        Get the level of thread concurrency
      - pthread_getcpuclockid()
        Return the clock ID of the CPU-time clock from a specified thread
      - pthread_getname_np()
        Retrieve the name of a thread
      - pthread_getschedparam()
        Get a thread's scheduling parameters
      - pthread_getspecific()
        Get a thread-specific data value
      - pthread_join()
        Join thread
      - pthread_key_create()
        Create a thread-specific data key
      - pthread_key_delete()
        Delete a thread-specific data key
      - pthread_kill()
        Send a signal to a thread
      - pthread_mutex_clocklock()
        Lock a mutex with a time limit measured against a specific clock
      - pthread_mutex_consistent()
        Mark as consistent the state that's protected by a mutex
      - pthread_mutex_destroy()
        Destroy a mutex
      - pthread_mutex_getprioceiling()
        Get a mutex's priority ceiling
      - pthread_mutex_init()
        Initialize a mutex
      - pthread_mutex_lock()
        Lock a mutex
      - pthread_mutex_setprioceiling()
        Set a mutex's priority ceiling
      - pthread_mutex_timedlock(), pthread_mutex_timedlock_monotonic()
        Lock a mutex, with a time limit
      - pthread_mutex_trylock()
        Attempt to lock a mutex
      - pthread_mutex_unlock()
        Unlock a mutex
      - pthread_mutex_wakeup_np()
        Unblock any threads that are waiting on a mutex
      - pthread_mutexattr_destroy()
        Destroy mutex attribute object
      - pthread_mutexattr_getprioceiling()
        Get the priority ceiling of a mutex attribute object
      - pthread_mutexattr_getprotocol()
        Get a mutex's scheduling protocol
      - pthread_mutexattr_getpshared()
        Get the process-shared attribute from a mutex attribute object
      - pthread_mutexattr_getrecursive()
        Get the recursive attribute from a mutex attribute object
      - pthread_mutexattr_getrobust()
        Get the robust attribute from a mutex attribute object
      - pthread_mutexattr_gettype()
        Get a mutex type
      - pthread_mutexattr_getwakeup_np()
        Get the wake-up attribute of a mutex
      - pthread_mutexattr_init()
        Initialize a mutex attribute object
      - pthread_mutexattr_setprioceiling()
        Set the priority ceiling of a mutex attribute object
      - pthread_mutexattr_setprotocol()
        Set a mutex's scheduling protocol
      - pthread_mutexattr_setpshared()
        Set the process-shared attribute in mutex attribute object
      - pthread_mutexattr_setrecursive()
        Set the recursive attribute in mutex attribute object
      - pthread_mutexattr_setrobust()
        Set the robust attribute in a mutex attribute object
      - pthread_mutexattr_settype()
        Set a mutex type
      - pthread_mutexattr_setwakeup_np()
        Set the wake-up attribute of a mutex
      - pthread_once()
        Dynamic package initialization
      - pthread_rwlock_clockrdlock()
        Lock a read-write lock for reading with a time limit measured against a clock
      - pthread_rwlock_clockwrlock()
        Lock a read-write lock for writing with a time limit measured against a specific clock
      - pthread_rwlock_destroy()
        Destroy a read-write lock
      - pthread_rwlock_init()
        Initialize a read-write lock
      - pthread_rwlock_rdlock()
        Acquire a shared read lock on a read-write lock
      - pthread_rwlock_timedrdlock()
        Lock a read-write lock for reading
      - pthread_rwlock_timedwrlock()
        Lock a read-write lock for writing
      - pthread_rwlock_tryrdlock()
        Attempt to acquire a shared lock on a read-write lock
      - pthread_rwlock_trywrlock()
        Attempt to acquire an exclusive lock on a read-write lock
      - pthread_rwlock_unlock()
        Unlock a read-write lock
      - pthread_rwlock_wrlock()
        Acquire an exclusive write lock on a read-write lock
      - pthread_rwlockattr_destroy()
        Destroy a read-write lock attribute object
      - pthread_rwlockattr_getpshared()
        Get the process-shared attribute of a read-write lock attribute object
      - pthread_rwlockattr_init()
        Create a read-write lock attribute object
      - pthread_rwlockattr_setpshared()
        Set the process-shared attribute of a read-write lock attribute object
      - pthread_self()
        Get the calling thread's ID
      - pthread_setcancelstate()
        Set a thread's cancellation state
      - pthread_setcanceltype()
        Set a thread's cancellation type
      - pthread_setconcurrency()
        Set the concurrency level for a thread
      - pthread_setname_np()
        Name a thread
      - pthread_setschedparam()
        Set thread scheduling parameters
      - pthread_setschedprio()
        Set a thread's priority
      - pthread_setspecific()
        Set a thread-specific data value
      - pthread_sigmask()
        Modify or examine a thread's signal-blocked mask
      - pthread_spawnattr_getrunmask_np()
        Get the 64-bit runmask attribute from a spawn attributes object
      - pthread_spawnattr_setrunmask_np()
        Set the 64-bit runmask attribute in a spawn attributes object
      - pthread_spin_destroy()
        Destroy a thread spinlock
      - pthread_spin_init()
        Initialize a thread spinlock
      - pthread_spin_lock()
        Lock a thread spinlock
      - pthread_spin_trylock()
        Try to lock a thread spinlock
      - pthread_spin_unlock()
        Unlock a thread spinlock
      - pthread_testcancel()
        Test thread cancellation
      - pthread_timedjoin(), pthread_timedjoin_monotonic()
        Join a thread, with a time limit
      - ptsname()
        Get the name of a slave pseudo-terminal device
      - ptsname_r()
        Get the name of a slave pseudo-terminal device
      - _pulse
        Structure that describes a pulse
      - pulse_attach()
        Attach a handler function to a pulse code
      - pulse_detach()
        Detach a handler function from a pulse code
      - putc()
        Write a character to a stream
      - putc_unlocked()
        Write a character to an output stream
      - putchar()
        Write a character to standard output
      - putchar_unlocked()
        Write a character to stdout
      - putenv()
        Add, change or delete an environment variable
      - puts()
        Write a string to stdout
      - putspent()
        Put an entry into the shadow password database
      - pututline()
        Write an entry in the user-information file
      - putw()
        Put a word on a stream
      - putwc()
        Write a wide character to a stream
      - putwchar()
        Write a wide character to a stdout
      - pwrite(), pwrite64()
        Write into a file without changing the file pointer
    - Q
    - R
    - S
    - T
    - U
    - V
    - W
    - X
    - Y
    - Z
    - Full Safety Information
    - Glossary
  - Devctl and Ioctl Commands
  - JSON Library Reference
  - PAM Reference
  - QNX Helpers Developer's Guide
    These libraries provide QNX helpers, including helpers that assist with logging, string conversion, and number and type sizes.
  - SPI Framework Technote
  - Utilities Reference
  - WPA Control Interface Reference
    This document provides a reference for the Wi-Fi Protected Access (WPA) control interface, which provides a C API for the WPA/IEEE 802.11i protocols in Wi-Fi client stations. Application developers who want to control WPA operations and get associated status and event data should read this reference.
- Migrating to QNX OS 8.0
QNX Software in the Cloud
QNX Toolkit for Visual Studio Code
This User's Guide describes the QNX^® Toolkit for Visual Studio Code. The guide introduces you to the QNX Toolkit by explaining the QNX development environment and how to build, run, and debug your QNX^® Operating System (OS) applications and systems.
Typographical Conventions, Support, and Licensing
This section describes the typographical conventions used throughout the documentation, explains how to obtain technical support, and provides some information about licensing.

posix_spawnattr_setrunmask()

QNX SDP8.0C Library ReferenceAPIDeveloper

Set the runmask attribute in a spawn attributes object

Note:

This function is now deprecated due to its support for only up to 32 CPUs. Instead, use pthread_spawnattr_setrunmask_np(), which supports up to 64 CPUs.

Synopsis:

#include <spawn.h>

int posix_spawnattr_setrunmask(
       posix_spawnattr_t *attrp,
       uint32_t runmask);

Arguments:

attrp: A pointer to the spawn attributes object that you want to modify.
runmask: The runmask that you want to use for the spawned processes.

Library:

libc

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

Description:

The posix_spawnattr_setrunmask() routine sets the value of the runmask attribute in the given spawn attributes object. You must have already initialized this object by calling posix_spawnattr_init().

This setting takes effect only if the POSIX_SPAWN_EXPLICIT_CPU flag is set; to set this flag, call posix_spawnattr_setxflags(). The default mask is 0xFFFFFFFFU, indicating that the spawned process can run on any processor.

This attribute is a bitmask representing the set of processors that a spawned process can run on. Processor numbering starts at 0, with each processor corresponding to a bit in the runmask. For example, a runmask of 0x00000005 means the spawned process is restricted to CPUs 0 and 2. For a detailed explanation about runmasks and how this attribute setting affects new processes, read the Processor affinity, clusters, runmasks, and inherit masks discussion in the QNX OS Programmer's Guide.

To get the value of this attribute, call posix_spawnattr_getrunmask().

For more information about spawn attributes, see the entry for posix_spawn().

Note:

This function is a QNX OS extension.

Returns:

EOK: Success.
EINVAL: The attrp pointer does not refer to a valid attribute structure.

Classification:


Safety:
Cancellation point	No
Signal handler	Yes
Thread	Yes

Page updated: December 04, 2024