PTHREAD_ATTR_GETNAME_NP(3)

PTHREAD_ATTR_GETNAME_NP(3) | Library Functions Manual | PTHREAD_ATTR_GETNAME_NP(3)

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

July 7, 2010 | NetBSD 8.0