rw.mutex, attach.rw.mutex {bigmemory}R Documentation

Mutual exclusion functionality for shared memory matrices in package “bigmemory”

Description

These functions provide additional read/write mutexes (mutual exclusions) for use with big.matrix objects in shared memory (class big.matrix of bigmemory). They are probably unnecessary for most users.

Usage

rw.mutex()
attach.rw.mutex(mutexId)
rlock(x)
rwlock(x)
unlock(x)

Arguments

mutexId the shared memory key for the mutex.
x an object of type rw.mutex.

Details

Mutexes are provided with every shared matrix (including file-backed matrices) and are managed transparently by the various functions provided for big.matrix objects (mwhich, for example). However, the user may create an additional layer of mutexes using these functions. This may be important in certain shared memory applications.

Note that describe should be used to retrieve the rw.mutex information.

Value

A new instance of type rw.mutex is returned.

Note

We recommend you contact us if you have questions about user mutexes, which are not for the faint of heart.

Author(s)

John W. Emerson and Michael J. Kane

References

http://www.boost.org

See Also

big.matrix, shared.big.matrix, filebacked.big.matrix, describe.

Examples

# None.

[Package bigmemory version 3.10 Index]