Scroll to navigation

THR_SET_NAME(2) System Calls Manual THR_SET_NAME(2)

NAME

thr_set_name —
set user-visible thread name

LIBRARY

Standard C Library (libc, -lc)

SYNOPSIS

#include <sys/thr.h>

int
thr_set_name(long id, const char *name);

DESCRIPTION

The thr_set_name() sets the user-visible name for the kernel thread with the identifier id in the current process, to the NUL-terminated string name. The thread name can be seen in the output of the ps(1) and top(1) commands, in the kernel debuggers and kernel tracing facility outputs, also in userland debuggers and program core files, as notes.

RETURN VALUES

If successful, thr_set_name() will return zero, otherwise -1 is returned, and errno is set to indicate the error.

ERRORS

The thr_set_name() operation may return the following errors:
[]
The memory pointed to by the name argument is not valid.
[]
The string pointed to by the name argument exceeds MAXCOMLEN + 1 bytes in length.
[]
The thread with the identifier id does not exist in the current process.

SEE ALSO

ps(1), thr_exit(2), thr_kill(2), thr_kill2(2), thr_new(2), thr_self(2), _umtx_op(2), pthread_set_name_np(3), ddb(4), ktr(9)

STANDARDS

The thr_new() system call is non-standard and is used by 1:1 Threading Library (libthr, -lthr).
June 1, 2016 Linux 4.9.0-9-amd64