NAME

tis_rwlock_destroy − Destroys the specified read-write lock object. 

LIBRARY

Standard C Library (libc.so, libc.a)

SYNOPSIS

#include <tis.h>

int   tis_rwlock_destroy(
                       tis_rwlock_t   ∗lock);

STANDARDS

None

PARAMETERS

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

DESCRIPTION

This routine destroys the specified read-write lock object.  Prior to calling this routine, ensure that there are no locks granted to the specified read-write lock and that there are no threads waiting for pending lock acquisitions on the specified read-write lock. 

This routine should be called only after all reader threads (and perhaps one writer thread) have finished using the specified read-write lock. 

RETURN VALUES

If an error condition occurs, this routine returns an integer value indicating the type of error.  Possible return values are as follows:

0Successful completion. 

[EBUSY]The lock is in use. 

ERRORS

None

RELATED INFORMATION

Functions: tis_read_lock(3), tis_read_trylock(3), tis_read_unlock(3), tis_rwlock_init(3), tis_write_lock(3), tis_write_trylock(3), tis_write_unlock(3)

Manuals: Guide to DECthreads and Programmer’s Guide