qthread_get_tasklocal - Man Page

get pointer to the task-local data segment

Synopsis

#include <qthread/qthread.h>

void *
qthread_get_tasklocal (unsigned int size);

Description

Use this function to retrieve a pointer to the task-specific data segment. When successful, the return value is a pointer to a memory segment at least as large as size bytes; otherwise, NULL is returned. If size is larger than the current amount of allocated space, then the allocation will be increased to the requested size. The current size of the task-local data segment can be found using qthread_size_tasklocal(). If the function is called from outside a qthread context, NULL is returned.

Environment

The operation of qthread_get_tasklocal() is modified by the following environment variable:

QTHREAD_TASKLOCAL_SIZE

This variable sets the task-local data segment size at initialization. Changes to this value during the course of the program run are ignored; the value is only considered when qthread_init() is run.

See Also

qthread_size_tasklocal(3)

Referenced By

qthread_size_tasklocal(3).

JUNE 2011 libqthread