NAME    [Toc]    [Back]

       pthread_cond_getname_np  -  Obtain  the object name from a
       condition variable object

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

       int pthread_cond_getname_np(
               pthread_cond_t *cond,
               char *name,
               size_t len );

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

PARAMETERS    [Toc]    [Back]

       Address of the condition variable object whose object name
       is  to be obtained.  Location to store the obtained object
       name.  Length in bytes of buffer at the location specified
       by name.

DESCRIPTION    [Toc]    [Back]

       This  routine  copies  the  object name from the condition
       variable object specified by cond to  the  buffer  at  the
       location  name.  Before calling this routine, your program
       must allocate the buffer indicated by name.

       The object name is a C language  string  and  provides  an
       identifier that is meaningful to a person debugging a DECthreads-based
 multithreaded application.  The maximum number
 of characters in the object name is 31.

       If  the  specified  condition variable object has not been
       previously set with an object name, this routine copies  a
       C language null string into the buffer at location name.

RETURN VALUES    [Toc]    [Back]

       If  an  error  condition  occurs,  this routine returns an
       integer value  indicating  the  type  of  error.  Possible
       return  values are as follows: Successful completion.  The
       value specified by cond is invalid.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions:     pthread_cond_init(3),     pthread_cond_setname_np(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                       pthread_cond_getname_np(3)