Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

getpid(2)

getpgrp(2)

killpg(2)

sigvec(2)



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

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026