#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
Fa attr
with all the default mutex attributes.
The
pthread_mutexattr_destroy ();
function destroys
Fa 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
The
pthread_mutexattr_init ();
function will fail if:
Bq Er ENOMEM
Out of memory.
The
pthread_mutexattr_destroy ();
function will fail if:
Bq Er EINVAL
Invalid value for
Fa attr .
The
pthread_mutexattr_setprioceiling ();
function will fail if:
Bq Er EINVAL
Invalid value for
Fa attr ,
or invalid value for
Fa prioceiling .
The
pthread_mutexattr_getprioceiling ();
function will fail if:
Bq Er EINVAL
Invalid value for
Fa attr .
The
pthread_mutexattr_setprotocol ();
function will fail if:
Bq Er EINVAL
Invalid value for
Fa attr ,
or invalid value for
Fa protocol .
The
pthread_mutexattr_getprotocol ();
function will fail if:
Bq Er EINVAL
Invalid value for
Fa attr .
The
pthread_mutexattr_settype ();
function will fail if:
Bq Er EINVAL
Invalid value for
Fa attr ,
or invalid value for
Fa type .
The
pthread_mutexattr_gettype ();
function will fail if:
Bq Er EINVAL
Invalid value for
Fa attr .
SEE ALSO
pthread_mutex_init3
STANDARDS
The
pthread_mutexattr_init ();
and
pthread_mutexattr_destroy ();
functions conform to
St -p1003.1-96
The
pthread_mutexattr_setprioceiling (,);
pthread_mutexattr_getprioceiling (,);
pthread_mutexattr_setprotocol (,);
pthread_mutexattr_getprotocol (,);
pthread_mutexattr_settype (,);
and
pthread_mutexattr_gettype ();
functions conform to
St -susv2