Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

pvm_catchout(3pvm) [debian 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)

Check Out this Related Man Page

ADVISE(3PVM)							  PVM Version 3.4						      ADVISE(3PVM)

NAME

       pvm_advise() - Controls use of direct task-to-task routing.
       [In Version 3.2: Replaced by pvm_setopt]

SYNOPSIS

       C    int info = pvm_advise( int route )

       Fortran	 call pvmfadvise( route, info )

PARAMETERS

       route   Integer advising PVM to set up direct task-to-task links.
									  route options
	       PvmDontRoute	   1	Don't allow direct links to this task
	       PvmAllowDirect	   2	Allow but don't request direct links
	       PvmRouteDirect	   3	Request direct links

       info    Integer returning error status.

DESCRIPTION

       The routine pvm_advise advises PVM on whether or not to set up direct task-to-task links (using TCP) for all subsequent communication. Once
       a link is established it remains until the application finishes.  If a direct link can not be established because one of the two tasks  has
       requested  PvmDontRoute	or  because no resources are available, then the default route through the PVM daemons is used.  pvm_advise can be
       called multiple times to selectively establish direct links, but is typically set only once near the beginning of each  task.   PvmAllowDi-
       rect  is  the default advise setting.  This setting on task A allows other tasks to set up direct links to A.  Once a direct link is estab-
       lished between tasks both tasks will use it for sending messages.  pvm_advise returns the error status in info.	The performance of  direct
       task-to-task  links can be up to a factor of two better than the default route. The draw back is a lack of scalability of the direct links.
       Some versions of UNIX limit the number of links to no more than 30.

EXAMPLES

       C:
			   info = pvm_advise( PvmRouteDirect );

       Fortran:
			   CALL PVMFADVISE( PVMROUTEDIRECT, INFO )

ERRORS

       This error condition can be returned by pvm_advise

       PvmBadParam
	      giving an invalid route value.

SEE ALSO

       pvm_setopt(3PVM)

								  30 August, 1993						      ADVISE(3PVM)
Man Page