plucky (2) PR_SET_NAME.2const.gz

NAME

       PR_SET_NAME, PR_GET_NAME - operations on a process or thread

LIBRARY

       Standard C library (libc, -lc)

SYNOPSIS

       #include <linux/prctl.h>  /* Definition of PR_* constants */
       #include <sys/prctl.h>

       int prctl(PR_SET_NAME, char name[16]);
       int prctl(PR_GET_NAME, const char name[16]);

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).

RETURN VALUE

       On success, 0 is returned.  On error, -1 is returned, and errno is set to indicate the error.

ERRORS

       EFAULT name 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).

STANDARDS

       Linux.

HISTORY

       PR_SET_NAME
              Linux 2.6.9.

       PR_GET_NAME
              Linux 2.6.11.

SEE ALSO

       prctl(2), pthread_setname_np(3), pthread_getname_np(3), proc_pid_comm(5)