pxfkill(3F)

NAME
     PXFKILL - Sends a signal to a process or group of processes

SYNOPSIS
     SUBROUTINE PXFKILL (ipid, isig, ierror)
     INTEGER ipid, isig, ierror

STANDARDS
     IEEE standard interface for FORTRAN 77

DESCRIPTION
     The PXFKILL subroutine uses the kill(2) system call to send a signal
     to a process or group of processes.

     The following is a list of valid arguments for this routine:

     ipid      A default integer input variable containing the process PID.
               The signal will be sent to a process or group of processes
               specified by ipid.

     isig      A default integer output variable containing the signal to
               be sent.

     ierror    A default integer output variable that contains zero if
               PXFKILL was successful and nonzero if PXFKILL was not
               successful.

     This subroutine may return any of the following error values:

     EINVAL         The value of the isig argument is an invalid or
                    unsupported signal number.

     EPERM          The process does not have permission to send the isig
                    signal to any receiving process.

     ESRCH          No process or process group can be found corresponding
                    to the process ID specified by ipid.

     It may also return:

     EPERM          The value of the ipid argument is 1 (proc1) and isig is
                    SIGKILL.

     ESRCH          The process group was given as 0 but the sending
                    process does not have a process group

     This routine is in libfortran.so which is linked by default when
     compiling programs with the MIPSpro 7 Fortran 90 compiler or when
     compiling programs with the -craylibs option to the MIPSpro F77
     compiler.

     All arguments must be of default kind unless documented otherwise. On
     IRIX systems, the default kind is KIND=4.

NOTES
     The PXF_DEFINITIONS module can be used by Fortran 90 users to enable
     caller-callee interface checking.

     Replace any Fortran reference to kill() with a subroutine call to
     PXFKILL.

EXAMPLES
              program pxftest
              integer ipid, isig, ierror

              CALL PXFFORK(ipid,ierror)
              if (ierror .ne. 0) then
                 print *,'FAILED: PXFFORK call failed with error = ',ierror
                 print *,'ipid=',ipid
              else
                 print *,'PASSED: PXFFORK call returned no error'
              endif
              call PXFCONST("SIGKILL",isig,ierror)
              if(ierror .ne. 0) then
                 print *, 'PXFCONST FAILED', ierror
                 print *,'isig=',isig
              else
                 print *, 'PXFCONST PASSED'
              endif
              CALL PXFKILL(ipid, isig, ierror)
              if (ierror .ne. 0) then
                 print *,'FAILED: PXFKILL call failed with error = ',ierror
                 print *,'ipid=',ipid
                 print *,'isig=',isig
              else
                 print *,'PASSED: PXFKILL call returned no error'
              endif
              end

SEE ALSO
     kill(2)