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>.