pthread_barrier_setname_np()

assign name to barrier 

Function


SYNOPSIS

#include <pthread.h>

int pthread_setname_np(pthread_barrier_t *barrier, const char *name);


DESCRIPTION

The pthread_barrier_setname_np() function assigns the specified name to the specified barrier. This is useful for debugging purposes, so that barriers can be identified symbolically. If a name is specified for a barrier, it is displayed by the NuTCRACKER Platform debugging utilities. The name can be obtained programmatically with the pthread_barrier_getname_np() function.


PARAMETERS

barrier 

Points to the barrier to which the name is assigned.

name 

Points to the name to assign to the barrier.


RETURN VALUES

On success, pthread_barrier_setname_np() returns 0. On error, one of the following values is returned:

ESRCH 

barrier does not specify a current barrier.

EFAULT 

name is an invalid pointer.


CONFORMANCE

PTC MKS Toolkit UNIX APIs extension.


MULTITHREAD SAFETY LEVEL

MT-safe.


PORTING ISSUES

None.


AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition


SEE ALSO

Functions:
pthread_barrier_getname_np(), pthread_barrier_init()


PTC MKS Toolkit 10.3 Documentation Build 39.