Obtains the object name from a thread-specific data key object.

1  –  C Binding

    #include <pthread.h>

    int
    pthread_key_getname_np (
             pthread_key_t   *key,
             char   *name,
             size_t   len);

2  –  Arguments

 key

    Address of the thread-specific data key 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 thread-specific
    data key object specified by the key 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 thread-specific data key 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 key is not a valid key.

5  –  Associated Routines

       pthread_key_setname_np()