pthread_rwlock_init
- initialize a read/write lock
LIBRARY
Lb libpthread
SYNOPSIS
#include <pthread.h> int
pthread_rwlock_init (pthread_rwlock_t *lock const pthread_rwlockattr_t *attr);
DESCRIPTION
The
pthread_rwlock_init ();
function is used to initialize a read/write lock, with attributes
specified by
Fa attr .
If
Fa attr
is NULL, the default read/write lock attributes are used.
The results of calling
pthread_rwlock_init ();
with an already initialized lock are undefined.
RETURN VALUES
If successful, the
pthread_rwlock_init ();
function will return zero.
Otherwise an error number will be returned
to indicate the error.
ERRORS
The
pthread_rwlock_init ();
function will fail if:
Bq Er EAGAIN
The system lacked the necessary resources (other than memory) to
initialize the lock.
Bq Er ENOMEM
Insufficient memory exists to initialize the lock.
Bq Er EPERM
The caller does not have sufficient privilege to perform the
operation.
The
pthread_rwlock_init ();
function may fail if:
Bq Er EBUSY
The system has detected an attempt to re-initialize the object
referenced by
Fa lock ,
a previously initialized but not yet destroyed read/write lock.
