Penguin

Differences between current version and predecessor to the previous major change of kill(2).

Other diffs: Previous 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
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) 
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.