NAME    [Toc]    [Back]

       pthread_mutex_getname_np  -  Obtain the object name from a
       mutex object

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

       int pthread_mutex_getname_np(
               pthread_mutex_t *mutex,
               char *name,
               size_t len );

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

PARAMETERS    [Toc]    [Back]

       Address of the mutex 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 mutex object
       specified by mutex 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 mutex 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 mutex is invalid.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions:    pthread_mutex_init(3),    pthread_mutex_setname_np(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                      pthread_mutex_getname_np(3)