FreeBSD manual
download PDF document: pthread_get_name_np.3.pdf
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 14.0-RELEASE-p6 October 12, 2021 FreeBSD 14.0-RELEASE-p6