NAME

pvm_kill − Terminates a specified PVM process. 
 

SYNOPSIS

Cint info = pvm_kill( int tid )
 
Fortrancall pvmfkill( tid, info )

PARAMETERS

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

infoInteger 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 Fortran 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