*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->FreeBSD man pages -> pthread_rwlock_init (3)              



NAME    [Toc]    [Back]

     pthread_rwlock_init -- initialize a read/write lock

LIBRARY    [Toc]    [Back]

     Reentrant C Library (libc_r, -lc_r)

SYNOPSIS    [Toc]    [Back]

     #include <pthread.h>

     pthread_rwlock_init(pthread_rwlock_t *lock,
	 const pthread_rwlockattr_t *attr);

DESCRIPTION    [Toc]    [Back]

     The pthread_rwlock_init() function is used to initialize a read/write
     lock, with attributes specified by attr.  If 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    [Toc]    [Back]

     If successful, the pthread_rwlock_init() function will return zero.  Otherwise
 an error number will be returned to indicate the error.

SEE ALSO    [Toc]    [Back]

     pthread_rwlockattr_init(3), pthread_rwlockattr_setpshared(3),

STANDARDS    [Toc]    [Back]

     The pthread_rwlock_init() function is expected to conform to Version 2 of
     the Single UNIX Specification (``SUSv2'').

ERRORS    [Toc]    [Back]

     The pthread_rwlock_init() function will fail if:

     [EAGAIN]		The system lacked the necessary resources (other than
			memory) to initialize the lock.

     [ENOMEM]		Insufficient memory exists to initialize the lock.

     [EPERM]		The caller does not have sufficient privilege to perform
 the operation.

     The pthread_rwlock_init() function may fail if:

     [EBUSY]		The system has detected an attempt to re-initialize
			the object referenced by lock, a previously initialized
 but not yet destroyed read/write lock.

     [EINVAL]		The value specified by attr is invalid.

HISTORY    [Toc]    [Back]

     The pthread_rwlock_init() function first appeared in FreeBSD 3.0.

BUGS    [Toc]    [Back]

     The PTHREAD_PROCESS_SHARED attribute is not supported.

FreeBSD 5.2.1			August 4, 1998			 FreeBSD 5.2.1
[ Back ]
 Similar pages
Name OS Title
pthread_rwlockattr_init Tru64 Initialize a read-write lock attributes object
tis_read_trylock Tru64 Attempts to acquire a read-write lock for read access and does not wait if the lock cannot be immedi...
pthread_rwlock_rdlock IRIX lock a read-write lock object for reading
pthread_rwlock_wrlock IRIX lock a read-write lock object for writing
tis_write_unlock Tru64 Unlocks the specified read-write lock that was acquired for write access
tis_read_unlock Tru64 Unlocks a read-write lock that was acquired for read access
pthread_rwlock_wrlock Tru64 Acquires a read-write lock for write access
tis_write_lock Tru64 Acquires the specified read-write lock for write access
pthread_rwlock_rdlock Tru64 Acquires a read-write lock for read access
tis_read_lock Tru64 Acquires a read-write lock for read access
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service