PVM.options {rpvm} | R Documentation |
Get or set the value of libpvm options.
PVM.options (what, val)
what |
a character string specifying libpvm options, must be one of the following,
|
val |
integer value of the option |
.PVM.options
sets or queries miscellaneous options in the PVM
library. The options are,
"Route"
Possible values are:
1"RouteDirect", set up direct task-to-task links (using TCP) for all subsequent communication.
2"DontRouteDirect", communication through PVM daemon.
3"AllowDirect" (the default), this setting on task A allows other tasks to set up direct links to A.
"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"
.
Returns the current option value. If val
is present, set the
corresonding option to new value val
.
Na (Michael) Li nali@umn.edu and A.J. Rossini rossini@u.washington.edu
PVM documentation
## Not run: PVM.options (what = "DebugMask")