Changes the object name in a thread-specific data key object.

1  –  C Binding

    #include <pthread.h>

    int
    pthread_key_setname_np (
             pthread_key_t   *cond,
             const char   *name,
             void   *mbz);

2  –  Arguments

 key

    Address of the thread-specific data key object whose object name
    is to be changed.

 name

    Object name value to copy into the key object.

 mbz

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

3  –  Description

    This routine changes the object name in the thread-specific
    data key object specified by the key argument to the value
    specified by the name argument. To set a new thread-specific data
    key object's object name, call this routine immediately after
    initializing the key 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 key is not a valid key, 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_key_getname_np()