NAME
pthread_get_name_np
,
pthread_getname_np
,
pthread_set_name_np
pthread_setname_np
—
set and retrieve the thread
name
LIBRARY
library “libpthread”
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
Thepthread_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
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>.