NAME    [Toc]    [Back]

       pthread_key_setname_np  -  Change  the  object  name  in a
       thread-specific data key object

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

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

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

PARAMETERS    [Toc]    [Back]

       Address of  the  thread-specific  data  key  object  whose
       object  name  is to be changed.  Object name value to copy
       into the thread-specific data key  object.   Reserved  for
       future use. The value must be zero (0).

DESCRIPTION    [Toc]    [Back]

       This  routine  changes  the object name in the thread-specific
 data key object specified by key to the value specified
  by  name.   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.

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
       value  specified  by key is not a valid key, or the length
       in characters of name  exceeds  31.   Insufficient  memory
       exists to create a copy of the object name string.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions: pthread_key_getname_np(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                        pthread_key_setname_np(3)