PR_GET_NAME(2const)

PR_GET_NAME2const

Operations on a process or thread

Part of PR_SET_NAME(2const).

Usage

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

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

Library

Standard C library (libc, -lc)

Overview

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

Releases

2 releases since Debian 13 (Trixie); the text changed 1 time.

  1. 13
  2. Arch

Standards

Linux.

History

PR_SET_NAME

Linux 2.6.9.

PR_GET_NAME

Linux 2.6.11.

From man-pages 6.19-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.