Document that SIGTTOU is sent if the process is in the background.
authormillert <millert@openbsd.org>
Sun, 10 Jul 2016 00:48:21 +0000 (00:48 +0000)
committermillert <millert@openbsd.org>
Sun, 10 Jul 2016 00:48:21 +0000 (00:48 +0000)
Adapted from text from tcsetattr(3).

lib/libc/termios/tcsetpgrp.3

index f72c77a..db5e45c 100644 (file)
@@ -1,4 +1,4 @@
-.\"    $OpenBSD: tcsetpgrp.3,v 1.12 2015/11/20 18:10:37 tb Exp $
+.\"    $OpenBSD: tcsetpgrp.3,v 1.13 2016/07/10 00:48:21 millert Exp $
 .\"
 .\" Copyright (c) 1991 The Regents of the University of California.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: November 20 2015 $
+.Dd $Mdocdate: July 10 2016 $
 .Dt TCSETPGRP 3
 .Os
 .Sh NAME
@@ -53,6 +53,16 @@ The value of
 must be the same as the process group ID of a process in the same
 session as the calling process.
 .Pp
+If the calling process is a member of a background process group,
+the process group will be sent a
+.Dv SIGTTOU
+signal.
+If the calling process is blocking or ignoring
+.Dv SIGTTOU
+signals, the process is allowed to perform the operation and the
+.Dv SIGTTOU
+signal is not sent.
+.Pp
 Upon successful completion,
 .Fn tcsetpgrp
 returns a value of zero.