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

  man pages->Tru64 Unix man pages -> pthread_rwlock_destroy (3)              



NAME    [Toc]    [Back]

       pthread_rwlock_destroy - Destroys a read-write lock object

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

       int pthread_rwlock_destroy(
               pthread_rwlock_t *rwlock );

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

PARAMETERS    [Toc]    [Back]

       Address of the read-write lock object to be destroyed.

DESCRIPTION    [Toc]    [Back]

       This routine destroys the specified read-write lock object
       by uninitializing it, and should be called when the object
       is no longer referenced in your program. After  this  routine
  is  called,  DECthreads may reclaim internal storage
       used by the specified read-write lock object.  The  effect
       of  subsequent use of the lock is undefined until the lock
       is reinitialized by another call to pthread_rwlock_init.

       It is illegal to destroy a locked read-write lock.

       The results of this routine are unpredictable if the specified
  read-write  lock object does not currently exist or
       is not initialized. This routine destroys  the  read-write
       lock  object specified by the rwlock argument and releases
       any resources that the object used.

       A destroyed read-write lock object  can  be  reinitialized
       using  the  pthread_rwlock_init(3) routine. The results of
       otherwise referencing a destroyed read-write  lock  object
       are undefined.

RETURN VALUES    [Toc]    [Back]

       If  an  error  condition  occurs,  this routine returns an
       integer value  indicating  the  type  of  error.  Possible
       return  values  are as follows: Successful completion.  An
       attempt was made  to  destroy  the  object  referenced  by
       rwlock while it is locked or referenced.

ERRORS    [Toc]    [Back]


SEE ALSO    [Toc]    [Back]

       Functions: pthread_rwlock_init(3)

       Manuals: Guide to DECthreads and Programmer's Guide

[ Back ]
 Similar pages
Name OS Title
tis_rwlock_destroy Tru64 Destroys the specified read-write lock object
pthread_rwlock_wrlock IRIX lock a read-write lock object for writing
pthread_rwlock_rdlock IRIX lock a read-write lock object for reading
pthread_rwlock_init Tru64 Initializes a read-write lock object
pthread_rwlock_unlock IRIX unlock a read-write lock object
tis_rwlock_init Tru64 Initializes a read-write lock object
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...
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
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service