NAME
pthread_attr_getname_np —
get and set
descriptive name of an attribute
LIBRARY
POSIX Threads Library (libpthread, -lpthread)
SYNOPSIS
#include <pthread.h>
int
pthread_attr_getname_np(
const
pthread_attr_t attr,
char
*name,
size_t len);
int
pthread_attr_setname_np(
pthread_attr_t
attr,
const char
*name,
void *arg);
DESCRIPTION
The
pthread_attr_getname_np() function gets the descriptive
name of a thread attribute. It takes the following arguments:
-
-
- attr
- The attribute whose descriptive name will be obtained.
-
-
- name
- The buffer to be filled with the descriptive name of the
attribute.
-
-
- len
- The size of the buffer name in
bytes.
The
pthread_attr_setname_np() function sets the descriptive
name of a thread attribute. It takes the following arguments:
-
-
- attr
- The attribute whose descriptive name will be set.
-
-
- name
- The printf(3)
format string to be used to construct the descriptive name of the
attribute. The resulted descriptive name should be shorter than
PTHREAD_MAX_NAMELEN_NP
.
-
-
- arg
- The printf(3)
argument used with name.
RETURN VALUES
Both functions return 0 on success. Otherwise, an error number is returned.
COMPATIBILITY
Both functions are non-standard extensions.
ERRORS
No errors are defined for
pthread_attr_getname_np().
The
pthread_attr_setname_np() function may fail if:
-
-
- [
EINVAL
]
- The supplied descriptive name was
longer than
PTHREAD_MAX_NAMELEN_NP
.
-
-
- [
ENOMEM
]
- There was insufficient memory for the operation.
SEE ALSO
pthread_attr(3),
pthread_getname_np(3)