date and time created 91/03/07 10:23:53 by bostic

[unix-history] / usr / src / lib / libc / compat-43 / killpg.2

diff --git a/usr/src/lib/libc/compat-43/killpg.2 b/usr/src/lib/libc/compat-43/killpg.2
index 177ae44..3f19055 100644 (file)
--- a/usr/src/lib/libc/compat-43/killpg.2
+++ b/usr/src/lib/libc/compat-43/killpg.2
@@ -1,61 +1,56 @@
-.\" Copyright (c) 1980 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1980 The Regents of the University of California.
+.\" All rights reserved.

 .\"
 .\"

-.\"    @(#)killpg.2    4.1 (Berkeley) %G%
+.\" %sccs.include.redist.man%

 .\"
 .\"

-.TH KILLPG 2J
+.\"    @(#)killpg.2    6.4 (Berkeley) %G%
+.\"
+.TH KILLPG 2 ""

 .UC 4
 .SH NAME
 .UC 4
 .SH NAME

-killpg \- send signal to a process or a process group
+killpg \- send signal to a process group

 .SH SYNOPSIS
 .SH SYNOPSIS

-.B killpg(pgrp, sig)
-.PP
-.B cc ... \-ljobs
+.ft B
+killpg(pgrp, sig)
+.br
+int pgrp, sig;
+.ft R

 .SH DESCRIPTION
 .I Killpg
 sends the signal
 .I sig
 .SH DESCRIPTION
 .I Killpg
 sends the signal
 .I sig

-to the specified process group.
+to the process group
+.IR pgrp .

 See
 See

-.IR sigsys (2)
-for a list of signals;
-see
-.IR jobs (3)
-for an explanation of process groups.
+.IR sigvec (2)
+for a list of signals.

 .PP
 The sending process and members of the process group must
 .PP
 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.
+have the same effective user ID, or
+the sender must be the super-user.

 As a single special case the continue signal SIGCONT may be sent
 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
-.IR csh (1)
-to restart set-user-id processes stopped from the keyboard with a stop signal.
-.PP
-The calls
-.IP
-.B "killpg(0, sig)"
-.LP
-and
-.IP
-.B "kill(0, sig)
-.LP
-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
-.I kill
-in this case, as it is portable to other UNIX systems.
+to any process that is a descendant of the current process.
+.SH "RETURN VALUE
+Upon successful completion, a value of 0 is returned.  Otherwise,
+a value of \-1 is returned and the global variable \fIerrno\fP
+is set to indicate the error.
+.SH "ERRORS
+\fIKillpg\fP will fail and no signal will be sent if any of the
+following occur:
+.TP 15
+[EINVAL]
+\fISig\fP is not a valid signal number.
+.TP 15
+[ESRCH]
+No process can be found in the process group specified by \fIpgrp\fP.
+.TP 15
+[ESRCH]
+The process group was given as 0
+but the sending process does not have a process group.
+.TP 15
+[EPERM]
+The sending process is not the super-user and one or more
+of the target processes has an effective user ID different from that
+of the sending process.

 .SH "SEE ALSO"
 .SH "SEE ALSO"

-jobs(3), kill(2), sigsys(2), signal(2), csh(1), kill(1)
-.SH 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.
-.SH 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.
+kill(2), getpgrp(2), sigvec(2)