GETOPT(3PVM) PVM Version 3.4 GETOPT(3PVM)NAME
pvm_getopt - Returns the value of libpvm options.
SYNOPSIS
C int val = pvm_getopt( int what )
Fortran call pvmfgetopt( what, val )
PARAMETERS
what Integer defining option to get. One of:
PvmRoute 1 Message routing policy
PvmDebugMask 2 Libpvm debug mask
PvmAutoErr 3 Auto error reporting
PvmOutputTid 4 Stdout destination for children
PvmOutputCode 5 Output message tag for children
PvmTraceTid 6 Trace data destination for children
PvmTraceCode 7 Trace message tag for children
PvmTraceBuffer 8 Trace buffer size for children
PvmTraceOptions 9 Trace collection options for children
PvmFragSize 10 Message fragment size
PvmResvTids 11 Allow messages to reserved tags and TIDs
PvmSelfOutputTid 12 Stdout destination
PvmSelfOutputCode 13 Output message tag
PvmSelfTraceTid 14 Trace data destination
PvmSelfTraceCode 15 Trace message tag
PvmSelfTraceBuffer 16 Trace buffer size
PvmSelfTraceOptions 17 Trace collection options
PvmShowTids 18 pvm_catchout prints task ids with output
PvmPollType 19 Message wait policy (shared memory)
PvmPollTime 20 Message spinwait duration
PvmOutputContext 21 Output message context for children
PvmTraceContext 22 Trace message context for children
PvmSelfOutputContext 23 Output message context
PvmSelfTraceContext 24 Trace message context
PvmNoReset 25 Do not kill task on reset
val Integer returning the value of the option.
DESCRIPTION
The routine pvm_getopt returns the value of the specified option in PVM. For a discussion of options and values, see pvm_setopt.
If an error occurs, the PVM error code is returned in place of the option value.
EXAMPLES
C:
val = pvm_getopt( PvmFragSize );
Fortran:
CALL PVMFGETOPT( PVMAUTOERR, VAL )
ERRORS
This error condition can be returned
PvmBadParam
giving an invalid value.
SEE ALSO pvm_setopt(3PVM)
4 April, 1994 GETOPT(3PVM)
Check Out this Related Man Page
CATCHOUT(3PVM) PVM Version 3.4 CATCHOUT(3PVM)NAME
pvm_catchout - Catch output from child tasks.
SYNOPSIS
C #include <stdio.h>
int info = pvm_catchout( FILE *ff )
Fortran call pvmfcatchout( onoff, info )
PARAMETERS
ff File descriptor on which to write collected output.
onoff Integer parameter. Turns output collection on or off.
info Integer status code returned by the routine. Values less than zero indicate an error.
DESCRIPTION
The routine pvm_catchout causes the calling task (the parent) to catch output from any tasks spawned after the call to pvm_catchout. Char-
acters printed on stdout or stderr in children tasks are collected by the pvmds and sent in control messages to the parent task, which tags
each line and appends it to the specified file. Output from grandchildren (spawned by children) tasks is also collected, provided the
children don't reset their PvmOutputTid.
If option PvmShowTids (see pvm_setopt) is true (nonzero), output is printed as shown below, tagged with the task id where the output origi-
nated:
[txxxxx] BEGIN
[txxxxx] (text from child task)
[txxxxx] END
The output from each task includes one BEGIN line and one END line, with whatever the task prints in between. If PvmShowTids is false, raw
output is printed with no additional information.
In C, the output file descriptor may be specified. Giving a null pointer turns output collection off for any subsequently spawned child
tasks. (Any existing output collection will still proceed at the child tasks, until they exit or change theirPvmOutputTid or related set-
tings - see man page for pvm_setopt().) In Fortran, output collection can only be turned on or off (again only for subsequently spawned
child tasks), and is always logged to the stdout of the parent task.
If pvm_exit is called while output collection is in effect, it will block in order to print all the output, until all tasks sending the
given task output have exited. To avoid this, output collection can be turned off by calling pvm_catchout(0) before calling pvm_exit.
pvm_catchout() always returns 0.
EXAMPLES
C:
#include <stdio.h>
pvm_catchout(stdout);
Fortran:
CALL PVMFCATCHOUT( 1, INFO )
SEE ALSO pvm_exit(3PVM), pvm_setopt(3PVM), pvm_spawn(3PVM)
13 July, 1994 CATCHOUT(3PVM)