1 .\" Copyright (c) 1980, 1991 Regents of the University of California.
2 .\" All rights reserved.
4 .\" %%%LICENSE_START(BSD_4_CLAUSE_UCB)
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\" notice, this list of conditions and the following disclaimer.
10 .\" 2. Redistributions in binary form must reproduce the above copyright
11 .\" notice, this list of conditions and the following disclaimer in the
12 .\" documentation and/or other materials provided with the distribution.
13 .\" 3. All advertising materials mentioning features or use of this software
14 .\" must display the following acknowledgement:
15 .\" This product includes software developed by the University of
16 .\" California, Berkeley and its contributors.
17 .\" 4. Neither the name of the University nor the names of its contributors
18 .\" may be used to endorse or promote products derived from this software
19 .\" without specific prior written permission.
21 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
22 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34 .\" @(#)killpg.2 6.5 (Berkeley) 3/10/91
36 .\" Modified Fri Jul 23 21:55:01 1993 by Rik Faith <faith@cs.unc.edu>
37 .\" Modified Tue Oct 22 08:11:14 EDT 1996 by Eric S. Raymond <esr@thyrsus.com>
38 .\" Modified 2004-06-16 by Michael Kerrisk <mtk.manpages@gmail.com>
39 .\" Added notes on CAP_KILL
40 .\" Modified 2004-06-21 by aeb
42 .TH KILLPG 2 2010-09-20 "Linux" "Linux Programmer's Manual"
44 killpg \- send signal to a process group
46 .B #include <signal.h>
48 .BI "int killpg(int " pgrp ", int " sig );
51 Feature Test Macro Requirements for glibc (see
52 .BR feature_test_macros (7)):
57 _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 ||
58 _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
68 for a list of signals.
74 sends the signal to the calling process's process group.
77 is less than or equal to 1, the behavior is undefined.)
79 For a process to have permission to send a signal
80 it must either be privileged (under Linux: have the
82 capability), or the real or effective
83 user ID of the sending process must equal the real or
84 saved set-user-ID of the target process.
87 it suffices when the sending and receiving
88 processes belong to the same session.
90 On success, zero is returned.
91 On error, \-1 is returned, and
98 is not a valid signal number.
101 The process does not have permission to send the signal
102 to any of the target processes.
105 No process can be found in the process group specified by
109 The process group was given as 0 but the sending process does not
110 have a process group.
114 function call first appeared in 4BSD), POSIX.1-2001.
116 There are various differences between the permission checking
117 in BSD-type systems and System\ V-type systems.
118 See the POSIX rationale for
120 A difference not mentioned by POSIX concerns the return
123 BSD documents that no signal is sent and
125 returned when the permission check failed for at least one target process,
126 while POSIX documents
128 only when the permission check failed for all target processes.
132 is implemented as a library function that makes the call
133 .IR "kill(-pgrp,\ sig)" .
138 .BR capabilities (7),
141 This page is part of release 3.68 of the Linux
144 A description of the project,
145 information about reporting bugs,
146 and the latest version of this page,
148 \%http://www.kernel.org/doc/man\-pages/.