Obtains the object name attribute from a thread attributes
    object.

1  –  C Binding

    #include <pthread.h>

    int
    pthread_attr_getname_np (
             const pthread_attr_t   *attr,
             char   *name,
             size_t   len,
             void   **mbz);

2  –  Arguments

 attr

    Address of the thread attributes object whose object name
    attribute is to be obtained.

 name

    Location to store the obtained object name.

 len

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

 mbz

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

3  –  Description

    This routine copies the object name attribute from the thread
    attributes object specified by the attr 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. A new thread created using the thread attributes object is
    initialized with the object name that was set in that attributes
    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.

    If the specified thread attributes object has not been previously
    set with an object name, this routine copies a C language null
    string into the buffer at location name.

    This routine contrasts with pthread_getname_np(), which obtains
    the object name from the thread object for an existing thread.

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 attr is not a valid thread
                attributes object.

5  –  Associated Routines

       pthread_getname_np()
       pthread_attr_setname_np()
       pthread_setname_np()