Changes the object name for a condition variable object.

1  –  C Binding

    #include <pthread.h>

    int
    pthread_cond_setname_np (
             pthread_cond_t   *cond,
             const char   *name,
             void   *mbz);

2  –  Arguments

 cond

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

 name

    Object name value to copy into the condition variable object.

 mbz

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

3  –  Description

    This routine changes the object name in the condition variable
    object specified by the cond argument to the value specified
    by the name argument. To set a new condition variable object's
    object name, call this routine immediately after initializing the
    condition variable 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.
    [EINVAL]    The value specified by cond is not a valid condition
                variable object, or the length in characters of name
                exceeds 31.
    [ENOMEM]    Insufficient memory exists to create a copy of the
                object name string.

5  –  Associated Routines

       pthread_cond_getname_np()