pvm_kill(3pvm) [redhat man page]

KILL(3PVM)							  PVM Version 3.4							KILL(3PVM)

NAME

       pvm_kill - Terminates a specified PVM process.

SYNOPSIS

       C    int info = pvm_kill( int tid )

       Fortran	 call pvmfkill( tid, info )

PARAMETERS

       tid     Integer task identifier of the PVM process to be killed (not yourself).

       info    Integer status code returned by the routine.  Values less than zero indicate an error.

DESCRIPTION

       The routine pvm_kill sends a terminate (SIGTERM) signal to the PVM process identified by tid.  In the case of multiprocessors the terminate
       signal is replaced with a host dependent method for killing a process.  If pvm_kill is successful, info will be 0.  If  some  error  occurs
       then info will be < 0.

       pvm_kill  is not designed to kill the calling process.  To kill yourself in C call pvm_exit() followed by exit().  To kill yourself in For-
       tran call pvmfexit followed by stop.

EXAMPLES

       C:
	    info = pvm_kill( tid );

       Fortran:
	    CALL PVMFKILL( TID, INFO )

ERRORS

       These error conditions can be returned by pvm_kill

       PvmBadParam
	      giving an invalid tid value.

       PvmSysErr
	      pvmd not responding.

SEE ALSO

       pvm_exit(3PVM), pvm_halt(3PVM)

								  30 August, 1993							KILL(3PVM)

SENDSIG(3PVM)							  PVM Version 3.4						     SENDSIG(3PVM)

NAME

       pvm_sendsig - Sends a signal to another PVM process.

SYNOPSIS

       C    int info = pvm_sendsig( int tid, int signum )

       Fortran	 call pvmfsendsig( tid, signum, info )

PARAMETERS

       tid     Integer task identifier of PVM process to receive the signal.

       signum  Integer signal number.

       info    Integer status code returned by the routine.

DESCRIPTION

       The routine pvm_sendsig sends the signal number signum to the PVM process identified by tid.  If pvm_sendsig is successful, info will be 0.
       If some error occurs then info will be < 0.

       pvm_sendsig should only be used by programmers with Unix signal handling experience.  Many library functions (and in fact the  PVM  library
       functions) cannot be called in a signal handler context because they do not mask signals or lock internal data structures.

       Further	caveat:   the  signal  numbers	passed	between systems are not mapped - PVM assumes that signal 9 on one system is the same as on
       another.

EXAMPLES

       C:
	    tid = pvm_parent();
	    info = pvm_sendsig( tid, SIGKILL);

       Fortran:
	    CALL PVMFBUFINFO( BUFID, BYTES, TYPE, TID, INFO );
	    CALL PVMFSENDSIG( TID, SIGNUM, INFO )

ERRORS

       These error conditions can be returned by pvm_sendsig

       PvmSysErr
	      pvmd not responding.

       PvmBadParam
	      giving an invalid tid value.

SEE ALSO

								  30 August, 1993						     SENDSIG(3PVM)