PTHREAD_SET_NAME_NP(3)                        FreeBSD Library Functions Manual

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
                        corresponding 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
     extensions.  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 15.1-STABLE-HBSD       October 12, 2021         PTHREAD_SET_NAME_NP(3)