KILL(2) COMMAND REFERENCE KILL(2)
NAME
kill - send signal to a process
SYNOPSIS
kill(pid, sig)
int pid, sig;
DESCRIPTION
Kill sends the signal sig to a process specified by the
process number pid. Sig may be one of the signals specified
in sigvec(2), or it may be 0. If sig is 0, error checking
is performed but no signal is actually sent. This can be
used to check the validity of pid.
The sending and receiving processes must have the same
effective user ID, otherwise this call is restricted to the
super-user. A single exception is the signal SIGCONT which
may always be sent to any child or grandchild of the current
process.
If pid is greater than 0, sig is is sent to the process
whose process ID is equal to pid.
If pid is 0, sig is sent to all other processes in the
sender's process group; this is a variant of killpg(2).
If pid is -1, and the user is the super-user, sig is
broadcast universally except to system processes and the
process sending the signal.
Processes may send signals to themselves.
DIAGNOSTICS
Kill will fail and no signal will be sent if any of the
following occur:
[EINVAL] Sig is not a valid signal number.
[ESRCH] No process can be found corresponding to that
specified by pid.
[EPERM] The sending process is not the super-user and
its effective user ID does not match the
effective user ID of the receiving process.
[EINVAL] Pid is 0, but there is no process group
associated with pid.
Printed 4/6/89 1
KILL(2) COMMAND REFERENCE KILL(2)
RETURN VALUE
Upon successful completion, a value of 0 is returned.
Otherwise, a value of -1 is returned and errno is set to
indicate the error.
SEE ALSO
getpid(2), getpgrp(2), killpg(2), and sigvec(2).
Printed 4/6/89 2
%%index%%
na:240,86;
sy:326,369;
de:695,1249;
di:1944,709;
rv:2965,280;
se:3245,236;
%%index%%000000000108