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

FreeBSD Manual Pages

  
 
  

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 pre-
       viously 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 cor-
			  responding 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-
       standard, 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	13.2		       October 12, 2021		PTHREAD_SET_NAME_NP(3)

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | ERRORS | SEE ALSO | STANDARDS | AUTHORS

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+14.0-RELEASE+and+Ports>

home | help