pxfkill(3F)

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

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

IMPLEMENTATION
     UNICOS, UNICOS/mk, and IRIX systems

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.

     On UNICOS and UNICOS/mk systems, the subroutine may also return:

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

     On IRIX systems, 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

     On IRIX systems, 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.

     When using the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
     UNICOS, UNICOS/mk, or IRIX systems, all arguments must be of default
     kind unless documented otherwise. On UNICOS and UNICOS/mk, default
     kind is KIND=8 for integer, real, complex, and logical arguments; on
     IRIX systems, the default kind is KIND=4.

NOTES
     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)

     Application Programmer's Library Reference Manual for the printed
     version of this man page.