tail head cat sleep
QR code linking to this page

Manual Pages  — PTHREAD_SET_NAME_NP

NAME

pthread_get_name_np, pthread_getname_np, pthread_set_name_np pthread_setname_np – set and retrieve the thread name

CONTENTS

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

pthread_np(3), thr_set_name(2)

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 <Mt phantom@FreeBSD.org> and Yuri Pankov <Mt yuripv@yuripv.net>.

PTHREAD_SET_NAME_NP (3) October 12, 2021

tail head cat sleep
QR code linking to this page


Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

The wonderful thing about standards is that there are so many of them to choose from.
— Grace Murray Hopper