Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
REG_RM(3PVM)			 PVM Version 3.4		    REG_RM(3PVM)

NAME
     pvm_reg_rm - Register task as PVM resource manager.

SYNOPSIS
     C	  #include <pvmsdpro.h>

	  int cc = pvm_reg_rm( struct pvmhostinfo **hip )
	  struct pvmhostinfo {
	       int  hi_tid;
	       char *hi_name;
	       char *hi_arch;
	       int  hi_speed;
	  };

     Fortran   Not Available

PARAMETERS
     hostp  Returns  pointer  to a pvmhostinfo structure which contains informa-
	    tion about the master host.

DESCRIPTION
     Registers the calling task as a PVM task  and  slave  host  manager.   This
     means  it intercepts certain libpvm calls from other tasks in order to have
     a say in scheduling policy.  The resource manager will  asynchronously  re-
     ceive  messages from tasks containing requests for service, as well as mes-
     sages from pvmds notifying it of system failures.

     Before you start using this function, be warned that  it's  not  a  trivial
     thing, i.e. you can't just call it to turn off the default round-robin task
     assignment.   Rather,  it allows you to write your own resource manager and
     hook it to PVM.

     To understand what the following messages mean, you should refer to the PVM
     source code and/or user guide section on implementation; There's  just  too
     much to say about them.

     When  one	of  the  following libpvm functions is called in a task with re-
     source manager set, the given message tag is sent to to resource manager.

	 Libpvm call	       RM message	 Normal message
	 pvm_addhosts()        SM_ADDHOST	 TM_ADDHOST
	 pvm_config()	       SM_CONFIG	 TM_CONFIG
	 pvm_delhosts()        SM_DELHOST	 TM_DELHOST
	 pvm_notify()	       SM_NOTIFY	 TM_NOTIFY
	 pvm_spawn()	       SM_SPAWN 	 TM_SPAWN
	 pvm_tasks()	       SM_TASK		 TM_TASK
	 pvm_reg_rm()	       SM_SCHED 	 TM_SCHED

     The resource manager must in turn compose the following messages  and  send
     them to the pvmds:

	 RM message	   Normal message
	 SM_EXEC	   DM_EXEC
	 SM_EXECACK	   DM_EXECACK
	 SM_ADD 	   DM_ADD
	 SM_ADDACK	   DM_ADDACK
	 SM_HANDOFF	   (none - change of resource manager)

     The  following  messages are sent asynchronously to the resource manager by
     the system:

	 RM message	   Meaning
	 SM_TASKX	   notify of task exit/fail
	 SM_HOSTX	   notify of host delete/fail

     The resource manager task must  use  pvm_setopt(PvmResvTids,  1)  to  allow
     sending  reserved	messages.  Messages should be packed using encoding Pvm-
     DataDefault to ensure they can be unpacked anywhere in the system.

     pvm_reg_rm() returns PvmOk when successful.

SEE ALSO
     pvm_addhosts(3PVM), pvm_config(3PVM), pvm_delhosts(3PVM), pvm_notify(3PVM),
     pvm_spawn(3PVM), pvm_tasks(3PVM)

				  4 March, 1994 		    REG_RM(3PVM)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pvm_reg_rm&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help