|
|
1.1 root 1: .TH KILLPG 2J
2: .UC 4
3: .SH NAME
4: killpg \- send signal to a process or a process group
5: .SH SYNOPSIS
6: .B killpg(pgrp, sig)
7: .PP
8: .B cc ... \-ljobs
9: .SH DESCRIPTION
10: .I Killpg
11: sends the signal
12: .I sig
13: to the specified process group.
14: See
15: .IR sigsys (2)
16: for a list of signals;
17: see
18: .IR jobs (3)
19: for an explanation of process groups.
20: .PP
21: The sending process and members of the process group must
22: have the same effective user ID, otherwise
23: this call is restricted to the super-user.
24: As a single special case the continue signal SIGCONT may be sent
25: to any process which is a descendant of the current process. This
26: allows a command interpreter such as
27: .IR csh (1)
28: to restart set-user-id processes stopped from the keyboard with a stop signal.
29: .PP
30: The calls
31: .IP
32: .B "killpg(0, sig)"
33: .LP
34: and
35: .IP
36: .B "kill(0, sig)
37: .LP
38: have identical effects, sending the signal to all members of the
39: invoker's process group (including the process itself).
40: It is preferable to use the call involving
41: .I kill
42: in this case, as it is portable to other UNIX systems.
43: .SH "SEE ALSO"
44: jobs(3), kill(2), sigsys(2), signal(2), csh(1), kill(1)
45: .SH DIAGNOSTICS
46: Zero is returned if the processes are sent the signals;
47: \-1 is returned if any process in the process group cannot be sent
48: the signal, or if there are no members in the process group.
49: .SH BUGS
50: The job control facilities are not available in standard version 7 UNIX.
51: These facilities are still under development and may change in future
52: releases of the system as better inter-process communication facilities
53: and support for virtual terminals become available. The options and
54: specifications of this system call and even the call itself
55: are thus subject to change.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.