THR_GETNAME(3C) | Standard C Library Functions | THR_GETNAME(3C) |
thr_getname
,
thr_setname
— get or set the
name of a thread
#include
<thread.h>
int
thr_getname
(thread_t tid,
char *name, size_t len);
int
thr_setname
(thread_t tid,
const char *name);
The
thr_getname
()
and thr_setname
() functions, respectively, get and
set the names of the thread whose id is given by the
tid parameter. For
thr_getname
(), len indicates
the size of name.
Thread names are limited to
THREAD_NAME_MAX
including the terminating NUL. They
may only contain printable ASCII characters.
To clear a thread name, call
thr_setname
()
with NULL.
Unlike some other systems, threads do not inherit the process name by default.
Upon successful completion, the
thr_getname
() and
thr_setname
() functions return
0. Otherwise, an
error number is returned to indicate the error. If the thread identified by
tid does not have a name set,
thr_getname will be set to an empty string (length =
0).
On failure, the contents of the buffer are undefined. Errors from
open(2),
read(2), or
write(2) are possible. In addition, the
thr_getname
() function will fail with:
EINVAL
ERANGE
ESRCH
The thr_setname
() function will fail
with:
August 22, 2018 | OmniOS |