Differences between version 2 and previous revision of kill(2).
Other diffs: Previous Major Revision, Previous Author, or view the Annotated Edit History
Newer page: | version 2 | Last edited on Thursday, February 20, 2003 11:28:40 pm | by PerryLorier | Revert |
Older page: | version 1 | Last edited on Tuesday, June 4, 2002 12:23:42 am | by perry | Revert |
@@ -1,98 +1,35 @@
-KILL
-!!!KILL
-NAME
-SYNOPSIS
-DESCRIPTION
-RETURN VALUE
-ERRORS
-BUGS
-CONFORMING TO
-SEE ALSO
-----
!!NAME
-
-
kill - send signal to a process
!!SYNOPSIS
-
-
-__#include
-__ ''pid''__, int__ ''sig''__);
-
__
+ __#include <sys/types.h>__
+ __#include <signal.h>__
+ __int kill(pid_t
__ ''pid''__, int__ ''sig''__);__
!!DESCRIPTION
+The kill(2) system call can be used to send any signal to any process group or process.
+If ''pid'' is positive, then signal ''sig'' is sent to ''pid''.
-The __kill__ system call can be used
to send any signal
-to any
process group or
process.
+If ''pid'' equals , then ''sig'' is sent
to every process in the
process group of the current
process.
+If ''pid'' equals -1, then ''sig'' is sent to every process except for the first one.
-If ''pid'' is positive
, then signal
''sig'' is sent to
-
''pid''.
+If ''pid'' is less than -1
, then ''sig'' is sent to every process in the process group
''-
pid''.
+If ''sig'' is 0, then no signal is sent, but error checking is still performed. This is an excellent way to see if a process is still running, send it signal 0, then check to see if you got [ESRCH] as an error.
-If ''pid'' equals 0, then ''sig'' is sent to every
-process in the process group of the current
-process.
-
-
-If ''pid'' equals -1, then ''sig'' is sent to every
-process except for the first one.
-
-
-If ''pid'' is less than -1, then ''sig'' is sent to
-every process in the process group ''-pid''.
-
-
-If ''sig'' is 0, then no signal is sent, but error
-checking is still performed.
!!RETURN VALUE
-
-
-
On success, zero is returned. On error, -1 is returned, and
-
''errno'' is set appropriately.
+On success, zero is returned. On error, -1 is returned, and ''errno'' is set appropriately.
!!ERRORS
+;[EINVAL]: An invalid signal was specified.
+;[ESRCH]: The pid or process group does not exist. Note that an existing process might be a zombie, a process which already committed termination, but has not yet been [wait4(2)]ed for.
+;[EPERM]: The process does not have permission to send the signal to any of the receiving processes. For a process to have permission to send a signal to process ''pid'' it must either have root privileges, or the real or effective user ID of the sending process must equal the real or saved set-user-ID of the receiving process. In the case of [SIGCONT] it suffices when the sending and receiving processes belong to the same session.
-
-__EINVAL__
-
-
-An invalid signal was specified.
-
-
-__ESRCH__
-
-
-The pid or process group does not exist. Note that an
-existing process might be a zombie, a process which already
-committed termination, but has not yet been __wait()__ed
-for.
-
-
-__EPERM__
-
-
-The process does not have permission to send the signal to
-any of the receiving processes. For a process to have
-permission to send a signal to process ''pid'' it must
-either have root privileges, or the real or effective user
-ID of the sending process must equal the real or saved
-set-user-ID of the receiving process. In the case of SIGCONT
-it suffices when the sending and receiving processes belong
-to the same session.
!!BUGS
+It is impossible to send a signal to task number one, the init process, for which it has not installed a signal handler. This is done to assure the system is not brought
+down accidentally.
-
-It is impossible to send a signal to task number one, the
-init process, for which it has not installed a signal
-handler. This is done to assure the system is not brought
-down accidentally.
!!CONFORMING TO
+SVr4, SVID, POSIX.1, X/OPEN, BSD 4.3
-
-SVr4, SVID, POSIX.1, X/OPEN, BSD 4.3
!!SEE ALSO
-
-
-
_exit(2), exit(3), signal(2),
-
signal(7)
-----
+_exit(2), exit(3), signal(2), signal(7)