pthread_cond_setname_np()

assign name to condition variable 

Function

SYNOPSIS

#include <pthread.h>

int pthread_cond_setname_np(pthread_cond_t *cond, const char *name);

DESCRIPTION

The pthread_cond_setname_np() function assigns the specified name to the specified condition variable. This is useful for debugging purposes, so that condition variables can be identified symbolically. If a name is specified for a condition variable, it is displayed by the NuTCRACKER Platform debugging utilities. The name can be obtained programmatically with the pthread_cond_getname_np() function.

PARAMETERS

cond 

Is the condition variable to which the name is assigned.

name 

Is the name to assign to the condition variable.

RETURN VALUES

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

EINVAL 

cond does not refer to an initialized condition variable.

EFAULT 

cond or 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_cond_getname_np(), pthread_cond_init()

PTC MKS Toolkit 10.5 Documentation Build 40.