PVM.options {rpvm}R Documentation

libpvm Options

Description

Get or set the value of libpvm options.

Usage

PVM.options (what, val)

Arguments

what a character string specifying libpvm options, must be one of the following,
    "Route"
    Message routing policy
    "DebugMask"
    Libpvm debug mask
    "AutoErr"
    Auto error reporting
    "OutputTid"
    Stdout destination for children
    "OutputCode"
    Output message tag
    "TraceTid"
    Trace data destination for children
    "TraceCode"
    Trace message tag
    "FragSize"
    Message fragment size
    "ResvTids"
    Allow messages to reserved tags and TIDs
    "SelfOutputTid"
    Stdout destination
    "SelfOutputCode"
    Output message tag
    "PvmSelfTraceTid"
    Trace data destination
    "SelfTraceCode"
    Trace message tag
    "ShowTids"
    pvm_catchout prints task ids with output
    "PollType"
    Message wait policy (shared memory)
    "PollTime"
    Message spinwait duration
val integer value of the option

Details

.PVM.options sets or queries miscellaneous options in the PVM library. The options are,

    "Route"
    Possible values are:
    "DebugMask"
    When debugging is turned on, PVM will log detailed information about its operations and progress on its stderr stream. The value is the debugging level. Default is 0, not to print any debug information.
    "AutoErr"
    When an error results from a libpvm function call and "AutoErr" is set to 1 (the default), an error message is automatically printed on stderr. A set ting of 0 disables this. A setting of 2 causes the library to terminate the task by calling exit() after printing the error message. A setting of 3 causes the library to abort after printing the error message.
    "OutputTid"
    The stdout destination for children tasks (spawned after the the option is set). Everything printed on the standard output of tasks spawned by the calling task is packed into messages and sent to the destination. val is the TID of a PVM task. Setting PvmOutputTid to 0 redirects stdout to the master pvmd, which writes to the log file /tmp/pvml.<uid> The default setting is inherited from the parent task, else is 0.
    "OutputCode"
    The message tag for standard output messages. Should only be set when a task has "OutputTid" set to itself.
    "TraceTid"
    The trace data message destination for chilren tasks (spawned after the option is set). Libpvm trace data is sent as messages to the destination. val is the TID of a PVM task. Setting "TraceTid" to 0 discards trace data. The default setting is inherited from the parent task, else is 0.
    "TraceCode"
    The message tag for trace data messages. Should only be set when a task has "TraceTid" set to itself.
    "FragSize"
    Specifies the message fragment size in bytes. Default value varies with host architecture.
    "ResvTids"
    A value of 1 enables the task to send messages with reserved tags and to non-task destinations. The default (0) causes libpvm to generate a "BadParam" error when a reserved identifier is specified.
    "SelfOutputTid"
    Sets the stdout destination for the task. Every thing printed on stdout is packed into messages and sent to the destination. Note: this only works for spawned tasks, because the pvmd doesn't get the output from tasks started by other means. The value is the TID of a PVM task. Setting "SelfOutputTid" to 0 redirects stdout to the master pvmd, which writes to the log file /tmp/pvml.<uid>. The default setting is inherited from the parent task, else is 0. Setting either "SelfOutputTid" or "SelfOutputCode" also causes both "OutputTid" and "OutputCode" to take on the values of "SelfOutputTid" and "SelfOutputCode", respectively.
    "SelfOutputCode"
    The message tag for standard output messages.
    "PvmSelfTraceTid"
    The trace data message destination for the task. Libpvm trace data is sent as messages to the destination. The value is the TID of a PVM task. Set ting "SelfTraceTid" to 0 discards trace data. The default setting is inherited from the parent task, else is 0. Setting either "SelfTraceTid" or "SelfTraceCode" also causes both "TraceTid" and "TraceCode" to take on the values of "SelfTraceTid" and "SelfTraceCode", respectively.
    "SelfTraceCode"
    The message tag for trace data messages.
    "ShowTids"
    If true (nonzero), pvm_catchout (note: not supported by rpvm) tags each line of output printed by a child task with the task id. Otherwise, output is exactly as printed.
    "PollType"
    The message wait policy when using shared-memory message transport. Setting "PollType" to "PollConstant" causes the application to spin on its message queue waiting for a message. Setting "PollType" to "PollSleep" causes the application to poll the message queue for messages "PollTime" times before pending on the semaphore.
    "PollTime"
    The poll count for applications checking their message queue before they pend on the semaphore. This option is ignored if "PollType" is set to "PollConstant".

Value

Returns the current option value. If val is present, set the corresonding option to new value val.

Author(s)

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

References

PVM documentation

Examples

## Not run: PVM.options (what = "DebugMask")

[Package rpvm version 0.6-2 Index]