NAME    [Toc]    [Back]

       pthread_rwlock_setname_np  -  Changes the object name in a
       read-write lock object

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

       int pthread_rwlock_setname_np(
               pthread_rwlock_t *rwlock,
               const char *name,
               void *mbz );

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

PARAMETERS    [Toc]    [Back]

       Read-write lock object whose object name is to be changed.
       Object name value to copy into the read-write lock object.
       Reserved for future use. The value must be zero (0).

DESCRIPTION    [Toc]    [Back]

       This routine changes the object  name  in  the  read-write
       lock  object specified by rwlock to the value specified by
       name.  To set a new read-write lock object's object  name,
       call this routine immediately after initializing the readwrite
 lock 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 rwlock 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_rwlock_getname_np(3),
       pthread_rwlock_init(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                     pthread_rwlock_setname_np(3)