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	infor-
	      mation 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	 asyn-
       chronously receive messages from	tasks containing requests for service,
       as well as messages 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 man-
       ager 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  man-
       ager.

	   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
       PvmDataDefault 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_no-
       tify(3PVM), pvm_spawn(3PVM), pvm_tasks(3PVM)

				 4 March, 1994			  REG_RM(3PVM)

NAME | SYNOPSIS | PARAMETERS | DESCRIPTION | SEE ALSO

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

home | help