Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/k/kill.html on line 1

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/k/kill.html on line 1

Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/k/kill.html on line 8

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/k/kill.html on line 8

kill()

Send a signal to a process or a group of processes

Synopsis:

#include <sys/types.h>
#include <signal.h>

int kill( pid_t pid, 
          int sig );

Arguments:

pid
The ID of the process or process group that you want to send a signal to:
If pid is: Then sig is sent to:
> 0 The single process with that process ID
0 All processes that are in the same process group as the sending process
< 0 Every process that's a member of the process group -pid
sig
Zero, or the signal that you want to send. For a complete list of signals, see POSIX signals in the documentation for SignalAction().

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The kill() function sends the signal sig to a process or group of processes specified by pid. If sig is zero, no signal is sent, but the pid is still checked for validity.

For a process to have permission to send a signal to a process, the real or effective user ID of the sending process must either:

If the value of pid causes sig to be generated for the sending process, and if sig isn't blocked, either sig or at least one pending unblocked signal is delivered before the kill function returns.

This call doesn't block. However, in the network case, lower priority threads may run.

Returns:

Zero, or -1 if an error occurs (errno is set).

Errors:

EAGAIN
Insufficient system resources are available to deliver the signal.
EINVAL
The sig is invalid.
EPERM
The process doesn't have permission to send this signal to any receiving process.
ESRCH
The given pid doesn't exist.

Examples:

See sigprocmask().

Classification:

POSIX 1003.1

Safety:
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes

See also:

getpid(), killpg(), setsid(), sigaction(), signal(), SignalKill(), sigqueue()


Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/k/kill.html on line 213

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/k/kill.html on line 213