NAME
pthread_mutexattr_init,
pthread_mutexattr_destroy,
pthread_mutexattr_setprioceiling,
pthread_mutexattr_getprioceiling,
pthread_mutexattr_setprotocol,
pthread_mutexattr_getprotocol,
pthread_mutexattr_settype,
pthread_mutexattr_gettype —
mutex attribute operations
SYNOPSIS
#include
<pthread.h>
int
pthread_mutexattr_init(pthread_mutexattr_t
*attr);
int
pthread_mutexattr_destroy(pthread_mutexattr_t
*attr);
int
pthread_mutexattr_setprioceiling(pthread_mutexattr_t
*attr, int
prioceiling);
int
pthread_mutexattr_getprioceiling(pthread_mutexattr_t
*attr, int
*prioceiling);
int
pthread_mutexattr_setprotocol(pthread_mutexattr_t
*attr, int
protocol);
int
pthread_mutexattr_getprotocol(pthread_mutexattr_t
*attr, int
*protocol);
int
pthread_mutexattr_settype(pthread_mutexattr_t
*attr, int
type);
int
pthread_mutexattr_gettype(pthread_mutexattr_t
*attr, int
*type);
DESCRIPTION
Mutex attributes are used to specify parameters to
pthread_mutex_init().
One attribute object can be used in multiple calls to
pthread_mutex_init(), with or without modifications
between calls.
The
pthread_mutexattr_init()
function initializes attr with all the default mutex
attributes.
The
pthread_mutexattr_destroy()
function destroys attr.
The
pthread_mutexattr_set*()
functions set the attribute that corresponds to each function name.
The
pthread_mutexattr_get*()
functions copy the value of the attribute that corresponds to each function
name to the location pointed to by the second function parameter.
RETURN VALUES
If successful, these functions return 0. Otherwise, an error number is returned to indicate the error.
ERRORS
pthread_mutexattr_init() will fail if:
- [
ENOMEM] - Out of memory.
pthread_mutexattr_destroy() will fail
if:
- [
EINVAL] - Invalid value for attr.
pthread_mutexattr_setprioceiling() will
fail if:
- [
EINVAL] - Invalid value for attr, or invalid value for prioceiling.
pthread_mutexattr_getprioceiling() will
fail if:
- [
EINVAL] - Invalid value for attr.
pthread_mutexattr_setprotocol() will fail
if:
- [
EINVAL] - Invalid value for attr, or invalid value for protocol.
pthread_mutexattr_getprotocol() will fail
if:
- [
EINVAL] - Invalid value for attr.
pthread_mutexattr_settype() will fail
if:
- [
EINVAL] - Invalid value for attr, or invalid value for type.
pthread_mutexattr_gettype() will fail
if:
- [
EINVAL] - Invalid value for attr.
SEE ALSO
STANDARDS
pthread_mutexattr_init() and
pthread_mutexattr_destroy() conform to
ISO/IEC 9945-1:1996 (“POSIX.1”)
pthread_mutexattr_setprioceiling(),
pthread_mutexattr_getprioceiling(),
pthread_mutexattr_setprotocol(),
pthread_mutexattr_getprotocol(),
pthread_mutexattr_settype(), and
pthread_mutexattr_gettype() conform to
Version 2 of the Single UNIX Specification
(“SUSv2”)