[apple/libpthread.git] / man / pthread_mutexattr.3

.\" $NetBSD: pthread_mutexattr.3,v 1.11 2010/07/08 22:46:34 jruoho Exp $
.\"
.\" Copyright (c) 2002, 2010 The NetBSD Foundation, Inc.
.\" All rights reserved.
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.\" Copyright (C) 2000 Jason Evans <jasone@FreeBSD.org>.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice(s), this list of conditions and the following disclaimer as
.\"    the first lines of this file unmodified other than the possible
.\"    addition of one or more copyright notices.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice(s), this list of conditions and the following disclaimer in
.\"    the documentation and/or other materials provided with the
.\"    distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) ``AS IS'' AND ANY
.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) BE
.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
.\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
.\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
.\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.\" $FreeBSD$
.Dd July 9, 2010
.Dt PTHREAD_MUTEXATTR 3
.Os
.Sh NAME
.Nm pthread_mutexattr_init ,
.Nm pthread_mutexattr_destroy ,
.Nm pthread_mutexattr_setprioceiling ,
.Nm pthread_mutexattr_getprioceiling ,
.Nm pthread_mutexattr_setprotocol ,
.Nm pthread_mutexattr_getprotocol ,
.Nm pthread_mutexattr_settype ,
.Nm pthread_mutexattr_gettype
.Nd mutex attribute operations
.Sh SYNOPSIS
.In pthread.h
.Ft int
.Fn pthread_mutexattr_init "pthread_mutexattr_t *attr"
.Ft int
.Fn pthread_mutexattr_destroy "pthread_mutexattr_t *attr"
.Ft int
.Fn pthread_mutexattr_setprioceiling "pthread_mutexattr_t *attr" "int prioceiling"
.Ft int
.Fn pthread_mutexattr_getprioceiling "pthread_mutexattr_t *attr" "int *prioceiling"
.Ft int
.Fn pthread_mutexattr_setprotocol "pthread_mutexattr_t *attr" "int protocol"
.Ft int
.Fn pthread_mutexattr_getprotocol "pthread_mutexattr_t *attr" "int *protocol"
.Ft int
.Fn pthread_mutexattr_settype "pthread_mutexattr_t *attr" "int type"
.Ft int
.Fn pthread_mutexattr_gettype "pthread_mutexattr_t *attr" "int *type"
.Sh DESCRIPTION
Mutex attributes are used to specify parameters to
.Fn pthread_mutex_init .
Like with thread attributes,
one attribute object can be used in multiple calls to
.Xr pthread_mutex_init 3 ,
with or without modifications between calls.
.Pp
The
.Fn pthread_mutexattr_init
function initializes
.Fa attr
with all the default mutex attributes.
.Pp
The
.Fn pthread_mutexattr_destroy
function destroys
.Fa attr .
.Pp
The
.Fn pthread_mutexattr_settype
functions set the mutex
.Fa type
value of the attribute.
Valid mutex types are:
.Bl -tag -width "XXX" -offset 2n
.It Dv PTHREAD_MUTEX_NORMAL
This type of mutex does not check for usage errors.
It will deadlock if reentered, and result in undefined behavior if a
locked mutex is unlocked by another thread.
Attempts to unlock an already unlocked
.Dv PTHREAD_MUTEX_NORMAL
mutex will result in undefined behavior.
.It Dv PTHREAD_MUTEX_ERRORCHECK
These mutexes do check for usage errors.
If an attempt is made to relock a
.Dv PTHREAD_MUTEX_ERRORCHECK
mutex without first dropping the lock, an error will be returned.
If a thread attempts to unlock a
.Dv PTHREAD_MUTEX_ERRORCHECK
mutex that is locked by another thread, an error will be returned.
If a thread attempts to unlock a
.Dv PTHREAD_MUTEX_ERRORCHECK
thread that is unlocked, an error will be returned.
.It Dv PTHREAD_MUTEX_RECURSIVE
These mutexes allow recursive locking.
An attempt to relock a
.Dv PTHREAD_MUTEX_RECURSIVE
mutex that is already locked by the same thread succeeds.
An equivalent number of
.Xr pthread_mutex_unlock 3
calls are needed before the mutex will wake another thread waiting
on this lock.
If a thread attempts to unlock a
.Dv PTHREAD_MUTEX_RECURSIVE
mutex that is locked by another thread, an error will be returned.
If a thread attempts to unlock a
.Dv PTHREAD_MUTEX_RECURSIVE
thread that is unlocked, an error will be returned.
.Pp
It is advised that
.Dv PTHREAD_MUTEX_RECURSIVE
mutexes are not used with condition variables.
This is because of the implicit unlocking done by
.Xr pthread_cond_wait 3
and
.Xr pthread_cond_timedwait 3 .
.It Dv PTHREAD_MUTEX_DEFAULT
Also this type of mutex will cause undefined behavior if reentered.
Unlocking a
.Dv PTHREAD_MUTEX_DEFAULT
mutex locked by another thread will result in undefined behavior.
Attempts to unlock an already unlocked
.Dv PTHREAD_MUTEX_DEFAULT
mutex will result in undefined behavior.
This is the default mutex type for
.Fn pthread_mutexaddr_init .
.El
.Pp
.Fn pthread_mutexattr_gettype
functions copy the type value of the attribute to the location pointed to by the second parameter.
.Pp
The
.Fn pthread_mutexattr_set*
functions set the attribute that corresponds to each function name.
.Pp
The
.Fn 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.
.Sh RETURN VALUES
If successful, these functions return 0.
Otherwise, an error number is returned to indicate the error.
.Sh ERRORS
The
.Fn pthread_mutexattr_init
function shall fail if:
.Bl -tag -width Er
.It Bq Er ENOMEM
Out of memory.
.El
.Pp
The
.Fn pthread_mutexattr_destroy
function will fail if:
.Bl -tag -width Er
.It Bq Er EINVAL
Invalid value for
.Fa attr .
.El
.Pp
The
.Fn pthread_mutexattr_setprioceiling
function will fail if:
.Bl -tag -width Er
.It Bq Er EINVAL
Invalid value for
.Fa attr ,
or invalid value for
.Fa prioceiling .
.El
.Pp
The
.Fn pthread_mutexattr_getprioceiling
function will fail if:
.Bl -tag -width Er
.It Bq Er EINVAL
Invalid value for
.Fa attr .
.El
.Pp
The
.Fn pthread_mutexattr_setprotocol
function will fail if:
.Bl -tag -width Er
.It Bq Er EINVAL
Invalid value for
.Fa attr ,
or invalid value for
.Fa protocol .
.El
.Pp
The
.Fn pthread_mutexattr_getprotocol
function will fail if:
.Bl -tag -width Er
.It Bq Er EINVAL
Invalid value for
.Fa attr .
.El
.Pp
The
.Fn pthread_mutexattr_settype
function shall fail if:
.Bl -tag -width Er
.It Bq Er EINVAL
The value specified either by
.Fa type
or
.Fa attr
is invalid.
.El
.Pp
The
.Fn pthread_mutexattr_gettype
function will fail if:
.Bl -tag -width Er
.It Bq Er EINVAL
Invalid value for
.Fa attr .
.El
.Sh SEE ALSO
.Xr pthread_mutex_init 3
.Sh STANDARDS
The
.Fn pthread_mutexattr_init
and
.Fn pthread_mutexattr_destroy
functions conform to
.St -p1003.1-96
.Pp
The
.Fn pthread_mutexattr_setprioceiling ,
.Fn pthread_mutexattr_getprioceiling ,
.Fn pthread_mutexattr_setprotocol ,
.Fn pthread_mutexattr_getprotocol ,
.Fn pthread_mutexattr_settype ,
and
.Fn pthread_mutexattr_gettype
functions conform to
.St -susv2
Commit	Line	Data
2546420a	1	.\" $NetBSD: pthread_mutexattr.3,v 1.11 2010/07/08 22:46:34 jruoho Exp $
f1a1da6c	2	.\"
2546420a	3	.\" Copyright (c) 2002, 2010 The NetBSD Foundation, Inc.
f1a1da6c A	4	.\" All rights reserved.
	5	.\" Redistribution and use in source and binary forms, with or without
	6	.\" modification, are permitted provided that the following conditions
	7	.\" are met:
	8	.\" 1. Redistributions of source code must retain the above copyright
	9	.\" notice, this list of conditions and the following disclaimer.
	10	.\" 2. Redistributions in binary form must reproduce the above copyright
	11	.\" notice, this list of conditions and the following disclaimer in the
	12	.\" documentation and/or other materials provided with the distribution.
f1a1da6c A	13	.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
	14	.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
	15	.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
	16	.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
	17	.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
	18	.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
	19	.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
	20	.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
	21	.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
	22	.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
	23	.\" POSSIBILITY OF SUCH DAMAGE.
	24	.\"
	25	.\" Copyright (C) 2000 Jason Evans <jasone@FreeBSD.org>.
	26	.\" All rights reserved.
	27	.\"
	28	.\" Redistribution and use in source and binary forms, with or without
	29	.\" modification, are permitted provided that the following conditions
	30	.\" are met:
	31	.\" 1. Redistributions of source code must retain the above copyright
	32	.\" notice(s), this list of conditions and the following disclaimer as
	33	.\" the first lines of this file unmodified other than the possible
	34	.\" addition of one or more copyright notices.
	35	.\" 2. Redistributions in binary form must reproduce the above copyright
	36	.\" notice(s), this list of conditions and the following disclaimer in
	37	.\" the documentation and/or other materials provided with the
	38	.\" distribution.
	39	.\"
	40	.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) ``AS IS'' AND ANY
	41	.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
	42	.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
	43	.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) BE
	44	.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
	45	.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
	46	.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
	47	.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
	48	.\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
	49	.\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
	50	.\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
	51	.\"
2546420a A	52	.\" $FreeBSD$
2546420a A	53	.Dd July 9, 2010
f1a1da6c A	54	.Dt PTHREAD_MUTEXATTR 3
	55	.Os
	56	.Sh NAME
f1a1da6c	57	.Nm pthread_mutexattr_init ,
2546420a	58	.Nm pthread_mutexattr_destroy ,
f1a1da6c	59	.Nm pthread_mutexattr_setprioceiling ,
2546420a	60	.Nm pthread_mutexattr_getprioceiling ,
f1a1da6c	61	.Nm pthread_mutexattr_setprotocol ,
2546420a A	62	.Nm pthread_mutexattr_getprotocol ,
	63	.Nm pthread_mutexattr_settype ,
	64	.Nm pthread_mutexattr_gettype
f1a1da6c A	65	.Nd mutex attribute operations
f1a1da6c A	66	.Sh SYNOPSIS
2546420a	67	.In pthread.h
f1a1da6c	68	.Ft int
2546420a	69	.Fn pthread_mutexattr_init "pthread_mutexattr_t *attr"
f1a1da6c	70	.Ft int
2546420a	71	.Fn pthread_mutexattr_destroy "pthread_mutexattr_t *attr"
f1a1da6c	72	.Ft int
2546420a	73	.Fn pthread_mutexattr_setprioceiling "pthread_mutexattr_t *attr" "int prioceiling"
f1a1da6c	74	.Ft int
2546420a	75	.Fn pthread_mutexattr_getprioceiling "pthread_mutexattr_t attr" "int prioceiling"
f1a1da6c	76	.Ft int
2546420a	77	.Fn pthread_mutexattr_setprotocol "pthread_mutexattr_t *attr" "int protocol"
f1a1da6c	78	.Ft int
2546420a	79	.Fn pthread_mutexattr_getprotocol "pthread_mutexattr_t attr" "int protocol"
f1a1da6c	80	.Ft int
2546420a	81	.Fn pthread_mutexattr_settype "pthread_mutexattr_t *attr" "int type"
f1a1da6c	82	.Ft int
2546420a	83	.Fn pthread_mutexattr_gettype "pthread_mutexattr_t attr" "int type"
f1a1da6c A	84	.Sh DESCRIPTION
	85	Mutex attributes are used to specify parameters to
	86	.Fn pthread_mutex_init .
2546420a A	87	Like with thread attributes,
	88	one attribute object can be used in multiple calls to
	89	.Xr pthread_mutex_init 3 ,
f1a1da6c A	90	with or without modifications between calls.
	91	.Pp
	92	The
	93	.Fn pthread_mutexattr_init
	94	function initializes
	95	.Fa attr
2546420a	96	with all the default mutex attributes.
f1a1da6c A	97	.Pp
	98	The
	99	.Fn pthread_mutexattr_destroy
	100	function destroys
	101	.Fa attr .
	102	.Pp
	103	The
	104	.Fn pthread_mutexattr_settype
2546420a A	105	functions set the mutex
	106	.Fa type
	107	value of the attribute.
	108	Valid mutex types are:
	109	.Bl -tag -width "XXX" -offset 2n
	110	.It Dv PTHREAD_MUTEX_NORMAL
	111	This type of mutex does not check for usage errors.
	112	It will deadlock if reentered, and result in undefined behavior if a
	113	locked mutex is unlocked by another thread.
	114	Attempts to unlock an already unlocked
f1a1da6c A	115	.Dv PTHREAD_MUTEX_NORMAL
f1a1da6c A	116	mutex will result in undefined behavior.
2546420a A	117	.It Dv PTHREAD_MUTEX_ERRORCHECK
2546420a A	118	These mutexes do check for usage errors.
f1a1da6c A	119	If an attempt is made to relock a
	120	.Dv PTHREAD_MUTEX_ERRORCHECK
	121	mutex without first dropping the lock, an error will be returned.
	122	If a thread attempts to unlock a
	123	.Dv PTHREAD_MUTEX_ERRORCHECK
2546420a A	124	mutex that is locked by another thread, an error will be returned.
2546420a A	125	If a thread attempts to unlock a
f1a1da6c A	126	.Dv PTHREAD_MUTEX_ERRORCHECK
f1a1da6c A	127	thread that is unlocked, an error will be returned.
2546420a A	128	.It Dv PTHREAD_MUTEX_RECURSIVE
2546420a A	129	These mutexes allow recursive locking.
f1a1da6c A	130	An attempt to relock a
f1a1da6c A	131	.Dv PTHREAD_MUTEX_RECURSIVE
2546420a A	132	mutex that is already locked by the same thread succeeds.
2546420a A	133	An equivalent number of
f1a1da6c	134	.Xr pthread_mutex_unlock 3
2546420a A	135	calls are needed before the mutex will wake another thread waiting
	136	on this lock.
	137	If a thread attempts to unlock a
f1a1da6c	138	.Dv PTHREAD_MUTEX_RECURSIVE
2546420a A	139	mutex that is locked by another thread, an error will be returned.
2546420a A	140	If a thread attempts to unlock a
f1a1da6c A	141	.Dv PTHREAD_MUTEX_RECURSIVE
	142	thread that is unlocked, an error will be returned.
	143	.Pp
2546420a A	144	It is advised that
	145	.Dv PTHREAD_MUTEX_RECURSIVE
	146	mutexes are not used with condition variables.
	147	This is because of the implicit unlocking done by
	148	.Xr pthread_cond_wait 3
	149	and
	150	.Xr pthread_cond_timedwait 3 .
	151	.It Dv PTHREAD_MUTEX_DEFAULT
	152	Also this type of mutex will cause undefined behavior if reentered.
f1a1da6c A	153	Unlocking a
f1a1da6c A	154	.Dv PTHREAD_MUTEX_DEFAULT
2546420a A	155	mutex locked by another thread will result in undefined behavior.
2546420a A	156	Attempts to unlock an already unlocked
f1a1da6c A	157	.Dv PTHREAD_MUTEX_DEFAULT
f1a1da6c A	158	mutex will result in undefined behavior.
2546420a A	159	This is the default mutex type for
	160	.Fn pthread_mutexaddr_init .
	161	.El
f1a1da6c A	162	.Pp
	163	.Fn pthread_mutexattr_gettype
	164	functions copy the type value of the attribute to the location pointed to by the second parameter.
	165	.Pp
	166	The
	167	.Fn pthread_mutexattr_set*
	168	functions set the attribute that corresponds to each function name.
	169	.Pp
	170	The
	171	.Fn pthread_mutexattr_get*
	172	functions copy the value of the attribute that corresponds to each function name
	173	to the location pointed to by the second function parameter.
	174	.Sh RETURN VALUES
	175	If successful, these functions return 0.
	176	Otherwise, an error number is returned to indicate the error.
	177	.Sh ERRORS
2546420a	178	The
f1a1da6c	179	.Fn pthread_mutexattr_init
2546420a	180	function shall fail if:
f1a1da6c A	181	.Bl -tag -width Er
	182	.It Bq Er ENOMEM
	183	Out of memory.
	184	.El
	185	.Pp
2546420a	186	The
f1a1da6c	187	.Fn pthread_mutexattr_destroy
2546420a	188	function will fail if:
f1a1da6c A	189	.Bl -tag -width Er
	190	.It Bq Er EINVAL
	191	Invalid value for
	192	.Fa attr .
	193	.El
	194	.Pp
2546420a	195	The
f1a1da6c	196	.Fn pthread_mutexattr_setprioceiling
2546420a	197	function will fail if:
f1a1da6c A	198	.Bl -tag -width Er
	199	.It Bq Er EINVAL
	200	Invalid value for
	201	.Fa attr ,
	202	or invalid value for
	203	.Fa prioceiling .
	204	.El
	205	.Pp
2546420a	206	The
f1a1da6c	207	.Fn pthread_mutexattr_getprioceiling
2546420a	208	function will fail if:
f1a1da6c A	209	.Bl -tag -width Er
	210	.It Bq Er EINVAL
	211	Invalid value for
	212	.Fa attr .
	213	.El
	214	.Pp
2546420a	215	The
f1a1da6c	216	.Fn pthread_mutexattr_setprotocol
2546420a	217	function will fail if:
f1a1da6c A	218	.Bl -tag -width Er
	219	.It Bq Er EINVAL
	220	Invalid value for
	221	.Fa attr ,
	222	or invalid value for
	223	.Fa protocol .
	224	.El
	225	.Pp
2546420a	226	The
f1a1da6c	227	.Fn pthread_mutexattr_getprotocol
2546420a	228	function will fail if:
f1a1da6c A	229	.Bl -tag -width Er
	230	.It Bq Er EINVAL
	231	Invalid value for
	232	.Fa attr .
	233	.El
	234	.Pp
2546420a	235	The
f1a1da6c	236	.Fn pthread_mutexattr_settype
2546420a	237	function shall fail if:
f1a1da6c A	238	.Bl -tag -width Er
f1a1da6c A	239	.It Bq Er EINVAL
2546420a A	240	The value specified either by
	241	.Fa type
	242	or
	243	.Fa attr
	244	is invalid.
f1a1da6c A	245	.El
f1a1da6c A	246	.Pp
2546420a	247	The
f1a1da6c	248	.Fn pthread_mutexattr_gettype
2546420a	249	function will fail if:
f1a1da6c A	250	.Bl -tag -width Er
	251	.It Bq Er EINVAL
	252	Invalid value for
	253	.Fa attr .
	254	.El
	255	.Sh SEE ALSO
	256	.Xr pthread_mutex_init 3
	257	.Sh STANDARDS
2546420a	258	The
f1a1da6c A	259	.Fn pthread_mutexattr_init
	260	and
	261	.Fn pthread_mutexattr_destroy
2546420a	262	functions conform to
f1a1da6c A	263	.St -p1003.1-96
f1a1da6c A	264	.Pp
2546420a	265	The
f1a1da6c A	266	.Fn pthread_mutexattr_setprioceiling ,
	267	.Fn pthread_mutexattr_getprioceiling ,
	268	.Fn pthread_mutexattr_setprotocol ,
	269	.Fn pthread_mutexattr_getprotocol ,
	270	.Fn pthread_mutexattr_settype ,
	271	and
	272	.Fn pthread_mutexattr_gettype
2546420a	273	functions conform to
f1a1da6c	274	.St -susv2