Obtains the object name from a condition variable object.

1  –  C Binding

    #include <pthread.h>

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

2  –  Arguments

 cond

    Address of the condition variable object whose object name is to
    be obtained.

 name

    Location to store the obtained object name.

 len

    Length in bytes of buffer at the location specified by name.

3  –  Description

    This routine copies the object name from the condition variable
    object specified by the cond argument to the buffer at the
    location specified by the name argument. 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 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.

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.
    [EINVAL]    The value specified by cond is not a valid condition
                variable.

5  –  Associated Routines

       pthread_cond_setname_np()