{get,set}hostid moves in from sys

[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..54d2c20 100644 (file)
--- a/usr/src/lib/libc/compat-43/killpg.2
+++ b/usr/src/lib/libc/compat-43/killpg.2
@@ -1,61 +1,69 @@
-.\" 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, 1991 Regents of the University of California.
+.\" All rights reserved.

 .\"
 .\"

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

 .\"
 .\"

-.TH KILLPG 2J
-.UC 4
-.SH NAME
-killpg \- send signal to a process or a process group
-.SH SYNOPSIS
-.B killpg(pgrp, sig)
-.PP
-.B cc ... \-ljobs
-.SH DESCRIPTION
-.I Killpg
+.\"     @(#)killpg.2   6.6 (Berkeley) %G%
+.\"
+.Dd 
+.Dt KILLPG 2
+.Os BSD 4
+.Sh NAME
+.Nm killpg
+.Nd send signal to a process group
+.Sh SYNOPSIS
+.Fd #include <signal.h>
+.Ft int
+.Fn killpg "pid_t pgrp" "int sig"
+.Sh DESCRIPTION
+.Fn Killpg

 sends the signal
 sends the signal

-.I sig
-to the specified process group.
+.Fa sig
+to the process group
+.Fa pgrp .

 See
 See

-.IR sigsys (2)
-for a list of signals;
-see
-.IR jobs (3)
-for an explanation of process groups.
-.PP
+.Xr sigaction 2
+for a list of signals.
+If
+.Fa pgrp
+is 0,
+.Fn killpg
+sends the signal to the sending process's process group.
+.Pp

 The sending process and members of the process group must
 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.
-.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.
+to any process that is a descendant of the current process.
+.Sh RETURN VALUES
+Upon successful completion, a value of 0 is returned.  Otherwise,
+a value of -1 is returned and the global variable
+.Va errno
+is set to indicate the error.
+.Sh ERRORS
+.Fn Killpg
+will fail and no signal will be sent if:
+.Bl -tag -width Er
+.It Bq Er EINVAL
+.Fa Sig
+is not a valid signal number.
+.It Bq Er ESRCH
+No process can be found in the process group specified by
+.Fa pgrp .
+.It Bq Er ESRCH
+The process group was given as 0
+but the sending process does not have a process group.
+.It Bq Er 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.
+.El
+.Sh SEE ALSO
+.Xr kill 2 ,
+.Xr getpgrp 2 ,
+.Xr sigaction 2
+.Sh HISTORY
+The
+.Nm
+function call appeared in
+.Bx 4.0 .