1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
.\" Copyright (c) 2001-2003 The Open Group, All Rights Reserved
.TH "PTHREAD_RWLOCKATTR_DESTROY" P 2003 "IEEE/The Open Group" "POSIX Programmer's Manual"
.\" pthread_rwlockattr_destroy
.SH NAME
pthread_rwlockattr_destroy, pthread_rwlockattr_init \- destroy and
initialize the read\-write lock attributes
object
.SH SYNOPSIS
.LP
\fB#include <pthread.h>
.br
.sp
int pthread_rwlockattr_destroy(pthread_rwlockattr_t\fP \fI*attr\fP\fB);
.br
int pthread_rwlockattr_init(pthread_rwlockattr_t\fP \fI*attr\fP\fB);
\fP
\fB
.br
\fP
.SH DESCRIPTION
.LP
The \fIpthread_rwlockattr_destroy\fP() function shall destroy a read-write
lock attributes object. A destroyed \fIattr\fP
attributes object can be reinitialized using \fIpthread_rwlockattr_init\fP();
the results of otherwise referencing the object
after it has been destroyed are undefined. An implementation may cause
\fIpthread_rwlockattr_destroy\fP() to set the object
referenced by \fIattr\fP to an invalid value.
.LP
The \fIpthread_rwlockattr_init\fP() function shall initialize a read-write
lock attributes object \fIattr\fP with the default
value for all of the attributes defined by the implementation.
.LP
Results are undefined if \fIpthread_rwlockattr_init\fP() is called
specifying an already initialized \fIattr\fP attributes
object.
.LP
After a read-write lock attributes object has been used to initialize
one or more read-write locks, any function affecting the
attributes object (including destruction) shall not affect any previously
initialized read-write locks.
.SH RETURN VALUE
.LP
If successful, the \fIpthread_rwlockattr_destroy\fP() and \fIpthread_rwlockattr_init\fP()
functions shall return zero;
otherwise, an error number shall be returned to indicate the error.
.SH ERRORS
.LP
The \fIpthread_rwlockattr_destroy\fP() function may fail if:
.TP 7
.B EINVAL
The value specified by \fIattr\fP is invalid.
.sp
.LP
The \fIpthread_rwlockattr_init\fP() function shall fail if:
.TP 7
.B ENOMEM
Insufficient memory exists to initialize the read-write lock attributes
object.
.sp
.LP
These functions shall not return an error code of [EINTR].
.LP
\fIThe following sections are informative.\fP
.SH EXAMPLES
.LP
None.
.SH APPLICATION USAGE
.LP
None.
.SH RATIONALE
.LP
None.
.SH FUTURE DIRECTIONS
.LP
None.
.SH SEE ALSO
.LP
\fIpthread_rwlock_destroy\fP() , \fIpthread_rwlockattr_getpshared\fP()
, \fIpthread_rwlockattr_setpshared\fP() , the Base Definitions volume
of
IEEE\ Std\ 1003.1-2001, \fI<pthread.h>\fP
.SH COPYRIGHT
Portions of this text are reprinted and reproduced in electronic form
from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
-- Portable Operating System Interface (POSIX), The Open Group Base
Specifications Issue 6, Copyright (C) 2001-2003 by the Institute of
Electrical and Electronics Engineers, Inc and The Open Group. In the
event of any discrepancy between this version and the original IEEE and
The Open Group Standard, the original IEEE and The Open Group Standard
is the referee document. The original Standard can be obtained online at
http://www.opengroup.org/unix/online.html .
|