KILL

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 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.