NAME

pthread_attr_getname_np, pthread_attr_setname_np — get or set thread name attribute

SYNOPSIS

#include <pthread.h>

int
pthread_attr_getname_np(pthread_attr_t *restrict attr, char *name, size_t len);

int
pthread_attr_setname_np(pthread_attr_t *restrict attr, const char *name);

DESCRIPTION

The pthread_attr_setname_np() and pthread_attr_getname_np() functions, respectively, set and get the thread name attribute in attr to name. For pthread_attr_getname_np(), len is the size of name. Any threads created with pthread_create(3c) using attr will have their name set to name upon creation.

Thread names are limited to PTHREAD_MAX_NAMELEN_NP including the terminating NUL. They may only contain printable ASCII characters.

RETURN VALUES

Upon successful completion, the pthread_attr_getname_np() and pthread_attr_setname_np() functions return 0. Otherwise, an error number is returned to indicate the error.

ERRORS

The pthread_attr_getname_np() function may fail with:

EINVAL: The name argument is NULL.
ERANGE: The size of name as indicated by len is too small to contain the thread name. The buffer may be over-written with partial contents of the thread name.

The pthread_attr_setname_np() function may fail with:

ERANGE: The length of name given in name exceeds the maximum size allowed.

INTERFACE STABILITY

Uncommitted

MT-LEVEL

MT-Safe