NAME

killpg − send signal to a process or a process group

SYNOPSIS

killpg(pgrp, sig)

cc ... −ljobs

DESCRIPTION

Killpg sends the signal sig to the specified process group.  See sigsys(2) for a list of signals; see jobs(3) for an explanation of process groups.

The sending process and members of the process group must have the same effective user ID, otherwise this call is restricted to the super-user.  As a single special case the continue signal SIGCONT may be sent to any process which is a descendant of the current process.  This allows a command interpreter such as csh(1) to restart set-user-id processes stopped from the keyboard with a stop signal.

The calls

killpg(0, sig)

and

kill(0, sig)

have identical effects, sending the signal to all members of the invoker’s process group (including the process itself).  It is preferable to use the call involving kill in this case, as it is portable to other UNIX systems. 

SEE ALSO

jobs(3), kill(2), sigsys(2), signal(2), csh(1), kill(1)

DIAGNOSTICS

Zero is returned if the processes are sent the signals; −1 is returned if any process in the process group cannot be sent the signal, or if there are no members in the process group. 

BUGS

The job control facilities are not available in standard version 7 UNIX.  These facilities are still under development and may change in future releases of the system as better inter-process communication facilities and support for virtual terminals become available.  The options and specifications of this system call and even the call itself are thus subject to change.