NAME

tis_rwlock_init − Initializes a read-write lock object. 

LIBRARY

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

SYNOPSIS

#include <tis.h>

int   tis_rwlock_init(
                       tis_rwlock_t   ∗lock);

STANDARDS

None

PARAMETERS

lockAddress of a read-write lock object. 

DESCRIPTION

This routine initializes a read-write lock object.  The routine initializes the tis_rwlock_t structure that holds the object’s lock states. 

To destroy a read-write lock object, call the tis_rwlock_destroy(3) routine. 

NOTE: The tis read-write lock has no relationship to the Single UNIX Specification, Version 2 (SUSV2, or UNIX98) read-write lock routines (pthread_rwlock_init(3), etc).  The tis_rwlock_t type, in particular, cannot be used with the pthread read-write lock functions; nor can a pthread_rwlock_t type be used with the tis read-write lock functions. 

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. 

[EINVAL]The value specified by lock is not a valid read-write lock. 

[ENOMEM]Insufficient memory exists to initialize lock. 

ERRORS

None

RELATED INFORMATION

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

Manuals: Guide to DECthreads and Programmer’s Guide