PR_SET_NAME, PR_GET_NAME - operations on a process or thread
Contents
Description
PR_SET_NAME
Set the name of the calling thread, using the value in the location pointed to by name.
The name can be up to 16 bytes long, including the terminating null byte. If the length of the
string, including the terminating null byte, exceeds 16 bytes, the string is silently truncated.
PR_GET_NAME (since Linux 2.6.11)
Return the name of the calling thread, in the buffer pointed to by name. The returned string will
be null-terminated.
This is the same attribute that can be set via pthread_setname_np(3) and retrieved using
pthread_getname_np(3).
Errors
EFAULTname is an invalid address.
Files
/proc/self/task/tid/comm The attribute is likewise accessible via this file (see proc_pid_comm(5)), where tid is the thread ID of the calling thread, as returned by gettid(2).
History
PR_SET_NAME
Linux 2.6.9.
PR_GET_NAME
Linux 2.6.11.
Library
Standard C library (libc, -lc)
Name
PR_SET_NAME, PR_GET_NAME - operations on a process or thread
Return Value
On success, 0 is returned. On error, -1 is returned, and errno is set to indicate the error.
See Also
prctl(2), pthread_setname_np(3), pthread_getname_np(3), proc_pid_comm(5) Linux man-pages 6.9.1 2024-06-02 PR_SET_NAME(2const)
Standards
Linux.
Synopsis
#include<linux/prctl.h> /* Definition of PR_* constants */
#include<sys/prctl.h>intprctl(PR_SET_NAME,charname[16]);intprctl(PR_GET_NAME,constcharname[16]);