pthread_rwlockattr_destroy(3t) [hpux man page]

pthread_rwlockattr_init(3T)											       pthread_rwlockattr_init(3T)

NAME

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

SYNOPSIS

PARAMETERS

	      attr	Pointer to the read-write lock attributes object to be initialized or destroyed.

DESCRIPTION

       initializes  the read-write lock attributes object attr with the default value for all attributes.  The attributes object describes a read-
       write lock in detail and is passed to the read-write lock initialization function.

       When a read-write lock attributes object is used to initialize a read-write lock, the values of the  individual	attributes  determine  the
       characteristics of the new read-write lock. Attributes objects act like additional parameters to object initialization.

       After  a  read-write  lock attributes object has been used to initialize one or more read-write lock, any function affecting the attributes
       object does not affect the previously initialized read-write locks.

       The read-write lock attributes and their default values are:

	      The default value is

       If an initialized read-write lock attributes object is reinitialized, undefined behavior results.

       destroys the read-write lock attributes object attr.  The destroyed read-write lock attributes object ceases to exist and its resources are
       reclaimed. Referencing the object after it has been destroyed results in undefined behavior.  A destroyed read-write lock attributes object
       can be reinitialized using the function

       Read-write locks which have been already initialized using this attributes object are not affected by the  destruction  of  the	read-write
       lock attributes object.

RETURN VALUE

       Upon successful completion, and return zero.  Otherwise, an error number is returned to indicate the error (the variable is not set).

ERRORS

       For each of the following conditions, if the condition is detected, the and functions return the corresponding error number:

	      [ENOMEM]	     There is insufficient memory available in which to initialize attr.

	      [EINVAL]	     The value specified by attr is invalid.

AUTHOR

       and were developed by X/Open.

SEE ALSO

       pthread_create(3T), pthread_rwlockattr_getpshared(3T), pthread_rwlockattr_setpshared(3T), pthread_rwlock_init(3T).

STANDARDS CONFORMANCE

								  Pthread Library				       pthread_rwlockattr_init(3T)

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)