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.

SEE ALSO

       pvm_exit(3PVM), pvm_halt(3PVM)

                                         30 August, 1993                               KILL(3PVM)