pthread_setname

Name a thread

Synopsis:

#include <pthread.h>

int pthread_setname_np(pthread_t tid,
                       const char* newname);

Arguments:

tid: The ID of the thread you want to name, or 0 if you want to name the calling thread.
newname: NULL, or a NULL-terminated string that specifies the new name. The maximum length is _NTO_THREAD_NAME_MAX (defined in <sys/neutrino.h>).

Library:

libc

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

Description:

(QNX Neutrino Core OS 6.3.2 or later) The pthread_setname_np() function sets the name of the specified thread to newname. If newname is NULL, the function deletes any name already assigned to the thread. The “np” in the function's name stands for “non-POSIX.”

Returns:

EOK: Success.
E2BIG: The name is too long.
EPERM: You don't have the appropriate permissions to set the name.

Classification:

QNX Neutrino

Safety:
Cancellation point	Yes
Interrupt handler	No
Signal handler	Yes
Thread	Yes