This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

pmm_start()

Start a thread pool to handle client requests

Synopsis:

#include <sys/pmm.h>

int pmm_start(thread_pool_attr_t *tatttr);

libc

This starts a thread pool to begin servicing client requests, and is the last action the product specific initialisation code performs:

attr: Pointer to the power manager server attributes.
tattr: Specifies the attributes of the thread pool used to service client requests.
If tattr is NULL, the thread pool is created with internal defaults.

The return value from this function depends on the thread pool flags:

if tattr is NULL, an initial thread pool thread is created and the calling thread returns 0.
if tattr->flags specifies POOL_FLAG_USE_SELF, the calling thread becomes the initial thread pool thread and does not return unless an error has occurred.
if tattr->flags specifies POOL_FLAG_EXIT_SELF, an initial thread pool thread is created and the calling thread exits without returning.
In this case, the caller should call procmgr_daemon() before calling >pmm_start() in order to set the process as a daemon.

If an error occurs, it returns -1 and errno is set one of the following: