NAME    [Toc]    [Back]

       pthread_mutex_setname_np  -  Changes  the object name in a
       mutex object

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

       int pthread_mutex_setname_np(
               pthread_mutex_t *mutex,
               const char *name,
               void *mbz );

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

PARAMETERS    [Toc]    [Back]

       Mutex object whose object name is to be  changed.   Object
       name  value  to  copy into the mutex object.  Reserved for
       future use. The value must be zero (0).

DESCRIPTION    [Toc]    [Back]

       This routine changes the object name in the  mutex  object
       specified  by mutex to the value specified by name. To set
       a new mutex object's object name, call this routine  immediately
 after initializing the mutex object.

       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.

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, or the length in
       characters of name exceeds 31.  Insufficient memory exists
       to create a copy of the object name string.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions:                    pthread_mutex_getname_np(3),
       pthread_mutex_init(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                      pthread_mutex_setname_np(3)