pthread_rwlockattr_init(3) [freebsd man page]

PTHREAD_RWLOCKATTR_INIT(3)				   BSD Library Functions Manual 				PTHREAD_RWLOCKATTR_INIT(3)

NAME

     pthread_rwlockattr_init -- initialize a read/write lock

LIBRARY

     POSIX Threads Library (libpthread, -lpthread)

SYNOPSIS

     #include <pthread.h>

     int
     pthread_rwlockattr_init(pthread_rwlockattr_t *attr);

DESCRIPTION

     The pthread_rwlockattr_init() function is used to initialize a read/write lock attributes object.

RETURN VALUES

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

ERRORS

     The pthread_rwlockattr_init() function will fail if:

     [ENOMEM]		Insufficient memory exists to initialize the attribute object.

SEE ALSO

     pthread_rwlock_init(3), pthread_rwlockattr_destroy(3), pthread_rwlockattr_getpshared(3), pthread_rwlockattr_setpshared(3)

STANDARDS

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

HISTORY

     The pthread_rwlockattr_init() function first appeared in FreeBSD 3.0.

BSD
								  August 4, 1998							       BSD

pthread_rwlockattr_init(3C)											       pthread_rwlockattr_init(3C)

NAME

       pthread_rwlockattr_init, pthread_rwlockattr_destroy - initialize or destroy read-write lock attributes object

SYNOPSIS

       cc -mt [ flag... ] file... -lpthread [ library... ]
       #include <pthread.h>

       int pthread_rwlockattr_init(pthread_rwlockattr_t *attr);

       int pthread_rwlockattr_destroy(pthread_rwlockattr_t *attr);

       The  pthread_rwlockattr_init()  function  initializes  a  read-write  lock  attributes  object  attr  with the default value for all of the
       attributes defined by the implementation.

       Results are undefined if pthread_rwlockattr_init() is called specifying an already initialized read-write lock attributes object.

       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) does not affect any previously initialized read-write locks.

       The pthread_rwlockattr_destroy() function destroys a read-write lock attributes object. The effect of subsequent use of the object is unde-
       fined until the object is re-initialized by  another  call  to  pthread_rwlockattr_init().  An  implementation  can  cause  pthread_rwlock-
       attr_destroy() to set the object referenced by attr to an invalid value.

       If successful, the pthread_rwlockattr_init() and pthread_rwlockattr_destroy() functions return 0. Otherwise, an error number is returned to
       indicate the error.

       The pthread_rwlockattr_init() function will fail if:

       ENOMEM	       Insufficient memory exists to initialize the read-write lock attributes object.

       The pthread_rwlockattr_destroy() function may fail if:

       EINVAL	       The value specified by attr is invalid.

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

       pthread_rwlock_init(3C),   pthread_rwlock_rdlock(3C),   pthread_rwlock_unlock(3C),   pthread_rwlock_wrlock(3C),	  pthread_rwlockattr_getp-
       shared(3C), attributes(5), standards(5)

								    23 Mar 2005 				       pthread_rwlockattr_init(3C)