summaryrefslogtreecommitdiff
path: root/lib/libpthread/man/pthread_set_name_np.3
blob: 5c797b05ac3408a3ef3ebc90f4b6bc2af6b3c988 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
.\" $OpenBSD: pthread_set_name_np.3,v 1.7 2019/02/04 17:18:08 tedu Exp $
.\" David Leonard <d@openbsd.org>, 1999. Public domain.
.Dd $Mdocdate: February 4 2019 $
.Dt PTHREAD_SET_NAME_NP 3
.Os
.Sh NAME
.Nm pthread_set_name_np
.Nd set the name of a thread
.Sh SYNOPSIS
.In pthread.h
.In pthread_np.h
.Ft void
.Fn pthread_set_name_np "pthread_t thread" "const char *name"
.Ft void
.Fn pthread_get_name_np "pthread_t thread" "char *name" "size_t len"
.Sh DESCRIPTION
The
.Fn pthread_set_name_np
function associates
.Fa name
with
.Fa thread .
This can be useful for debugging, as the name is displayed in
the thread status as displayed when the process receives the
.Dv SIGINFO
signal.
.Pp
The string pointed to by
.Fa name
is copied, and so need not be valid for the life of the thread.
.Fn pthread_get_name_np
function retrieves
.Fa name
associated with
.Fa thread .
.Sh SEE ALSO
.Xr pthreads 3
.Sh STANDARDS
The
.Fn pthread_set_name_np
function is non-portable and may not be supported with the above
semantics on other POSIX systems.