pthread_set_name_np3
Set and retrieve the thread name
Usage
#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);
Library
POSIX Threads Library (libpthread, -lpthread)
Overview
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.
Releases
59 releases since FreeBSD 4.8-RELEASE; the text changed 35 times.