pthread_get_name_np(3)

pthread_get_name_np3

Set and retrieve the thread name

Part of pthread_set_name_np(3).

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

22 releases since FreeBSD 11.3-RELEASE; the text changed 9 times.

  1. 11.3
  2. 11.4
  3. 12.0
  4. 12.1
  5. 12.2
  6. 12.3
  7. 12.4
  8. 13.0
  9. 13.1–13.2
  10. 13.3–16.0

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 ⟨[email protected]⟩ and Yuri Pankov ⟨[email protected]⟩.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.