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

1  –  C Binding

    #include <pthread.h>

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

2  –  Arguments

 rwlock

    Address of the read-write lock object whose object name is to be
    changed.

 name

    Object name value to copy into the read-write lock object.

 mbz

    Reserved for future use. The value must be zero (0).

3  –  Description

    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 read-write lock object.

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

4  –  Return Values

    If an error condition occurs, this routine returns an integer
    value indicating the type of error. Possible return values are as
    follows:

    Return      Description

    0           Successful completion, the read-write lock object was
                acquired for read access.
    [EINVAL]    The value specified by rwlock is invalid, or the
                length in characters of name exceeds 31.
    [ENOMEM]    Insufficient memory to create a copy of the object
                name string.

5  –  Associated Routines

       pthread_rwlock_getname_np()
       pthread_rwlock_init()