PXFKILL(3F) Last changed: 2-26-98
NAMEPXFKILL - 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
7.2 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 ALSOkill(2)
Application Programmer's Library Reference Manual, publication
SR-2165, for the printed version of this man page.
