thread_pool_limits()

Convenience wrapper function for thread_pool_control()

Synopsis:

#include <sys/dispatch.h>

int thread_pool_limits( thread_pool_t * pool, 
                        int lowater,
                        int hiwater,
                        int maximum,
                        int increment,
                        unsigned flags );

Library:

libc

Description:

The thread_pool_limits() function is a wrapper function for thread_pool_control(). If the value of lowater, hiwater, maximum or increment is >=0 then that value is adjusted in the thread pool according to the handle pool. The only flag that's accepted is THREAD_POOL_CONTROL_NONBLOCK.

If THREAD_POOL_CONTROL_NONBLOCK isn't specified, the upper and lower bounds for waiting are:

• lower = (lowater != -1) : lowater ? 0;
• upper = (maximum != -1) : maximum ? USHRT_MAX;

Having several threads call this function with the same thread pool handle isn't recommended.

Returns:

-1 if an error occurs (errno is set).

Classification:

QNX 6

See also:

thread_pool_control(), thread_pool_create(), thread_pool_destroy(), thread_pool_start()