.PVM.freebuf {rpvm}R Documentation

Free message buffer

Description

Disposes of a message buffer.

Usage

.PVM.freebuf (bufid)

Arguments

bufid integer message buffer id

Details

This function frees the memory associated with the message buffer identified by bufid. Message buffers are created by .PVM.mkbuf, .PVM.initsend and .PVM.recv.

.PVM.freebuf should be called for a send buffer created by .PVM.mkbuf after the message has been send and is no longer needed.

Receive buffer typically do not have to be freed unless they have been saved in the cources of using multiple buffers. But .PVM.freebuf can be used to destroy receive buffers as well. Therefore, messages that arrive but are no longer needed as a result of some other event can be destroyed to save buffer space.

Value

Returns 0 if successful or -1 if failed.

Author(s)

Na (Michael) Li nali@umn.edu and A.J. Rossini rossini@u.washington.edu

References

PVM documentation

See Also

.PVM.initsend, .PVM.mkbuf, .PVM.setrbuf, .PVM.recv

Examples

## Not run: bufid <- .PVM.mkbuf ("Raw")
## Send the message ...
## Not run: .PVM.freebuf (bufid)

[Package rpvm version 0.6-2 Index]