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

FreeBSD Manual Pages

  
 
  

home | help
PTHREAD_SET_NAME_NP(3) FreeBSD 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)

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	13.0			 June 3, 2020			  FreeBSD 13.0

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

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

home | help