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)