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)

Arguments

mutexId the shared memory key for the mutex.

Details

Mutexes are provided with every shared matrix and 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() can be used to retrieve the rw.mutex information.

Value

A new instance of type rw.mutex is returned.

Note

Shared memory is not presently supported by the Windows version of bigmemory (but you wouldn't be reading this comment if you had the Windows version). We recommend reading the additional documentation in shared.big.matrix, or contact us if you have questions.

Author(s)

John W. Emerson and Michael J. Kane

References

C libraries pthread, ipc, and shm are used for shared memory and mutexes.

See Also

big.matrix, shared.big.matrix.

Examples

# None.

[Package bigmemory version 2.3 Index]