Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
PTHREAD_SET_NAME_NP(3)	     Library Functions Manual	  PTHREAD_SET_NAME_NP(3)

NAME
     pthread_get_name_np,	 pthread_getname_np,	    pthread_set_name_np,
     pthread_setname_np -- set and retrieve the thread name

LIBRARY
     POSIX Threads Library (libpthread, -lpthread)

SYNOPSIS
     #include <pthread_np.h>

     void
     pthread_get_name_np(pthread_t thread, char *name, size_t len);

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

     void
     pthread_set_name_np(pthread_t thread, const char *name);

     int
     pthread_setname_np(pthread_t thread, const char *name);

DESCRIPTION
     The pthread_set_name_np() and pthread_setname_np() functions apply  a  copy
     of the given name to the given thread.

     The  pthread_get_name_np()  and pthread_getname_np() functions retrieve the
     name associated with thread.  If pthread_set_name_np() was  not  previously
     called for thread, the buffer pointed to by name will be empty.

ERRORS
     The pthread_getname_np and pthread_setname_np will fail if

     [ESRCH]		No  thread  could be found in the current process corre-
			sponding to  that  specified  by  the  given  thread  ID
			thread.

     Because	of    the    debugging	 nature   of   pthread_get_name_np   and
     pthread_set_name_np functions,  all  errors  that	may  appear  inside  are
     silently ignored.

SEE ALSO
     thr_set_name(2), pthread_np(3)

STANDARDS
     pthread_set_name_np()  and  pthread_get_name_np()	are  non-standard exten-
     sions.  pthread_setname_np() and pthread_getname_np()  are  also  non-stan-
     dard, but are implemented by larger number of operating systems so they are
     in fact more portable.

AUTHORS
     This manual page was written by Alexey Zelkin <phantom@FreeBSD.org> and
     Yuri Pankov <yuripv@yuripv.net>.

FreeBSD 15.1			October 12, 2021	  PTHREAD_SET_NAME_NP(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pthread_get_name_np&sektion=3&manpath=FreeBSD+15.1-RELEASE+and+Ports.quarterly>

home | help