NAME    [Toc]    [Back]

       pthread_getname_np  -  Obtain  the  object  name  from the
       thread object of an existing thread

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

       int pthread_getname_np(
               pthread_thread_t thread,
               char *name,
               size_t len );

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

PARAMETERS    [Toc]    [Back]

       Thread object whose object name is to be obtained.   Location
  to  store the obtained object name.  Length in bytes
       of buffer at the location specified by name.

DESCRIPTION    [Toc]    [Back]

       This routine copies the object name from the thread object
       specified  by  thread  to the buffer at the location name.
       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 DECthreads-based
 multithreaded application.  The maximum number
 of characters in the object name is 31.

       If the specified thread 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_attr_getname_np, which
       obtains  the  object name attribute in a thread attributes
       object that is used to create a new thread.

RETURN VALUES    [Toc]    [Back]

       If an error condition  occurs,  this  routine  returns  an
       integer  value  indicating  the  type  of  error. Possible
       return values are as follows: Successful completion.   The
       thread specified by thread does not exist.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions:     pthread_attr_getname_np(3),    pthread_setname_np(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                            pthread_getname_np(3)