NAME    [Toc]    [Back]

     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    [Toc]    [Back]

     #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    [Toc]    [Back]

     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    [Toc]    [Back]

     If  successful, these functions return 0.  Otherwise, an error number is
     returned to indicate the error.

ERRORS    [Toc]    [Back]

     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    [Toc]    [Back]

     pthread_mutex_init(3)

STANDARDS    [Toc]    [Back]

     pthread_mutexattr_init()   and   pthread_mutexattr_destroy()
conform to
     ISO/IEC 9945-1:1996 (``POSIX'')

     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

OpenBSD      3.6                            May      1,      2000