1
0
mirror of https://git.FreeBSD.org/src.git synced 2024-10-19 02:29:40 +00:00

stty(1): provide details about interaction with job control

PR:	266627

(cherry picked from commit a7eac01843)
This commit is contained in:
Konstantin Belousov 2022-09-27 00:34:22 +03:00
parent e2ba9f0f60
commit 298d7504ae

View File

@ -32,7 +32,7 @@
.\" @(#)stty.1 8.4 (Berkeley) 4/18/94
.\" $FreeBSD$
.\"
.Dd October 20, 2018
.Dd September 27, 2022
.Dt STTY 1
.Os
.Sh NAME
@ -594,6 +594,32 @@ Same as the control character
Same as the control character
.Cm reprint .
.El
.Sh INTERACTION WITH JOB CONTROL
Modifications to the terminal settings are treated by job control
(see
.Xr termios 4 )
same as writes.
When the
.Nm
utility is executing in a background process group,
such attempts result in the kernel sending the
.Dv SIGTTOU
signal and stopping the process until its group is returned
to foreground.
The non-blocking open of the terminal device with the
.Fl f
option to
.Nm
does not affect the behavior.
If it is desirable to modify the settings from the background,
.Xr sh 1
users might utilize the following idiom:
.Bd -literal
(trap '' TTOU; stty -f /dev/tty sane)
.Ed
.Pp
Note that changing terminal settings for a running foreground
job that is not prepared for it might cause inconsistencies.
.Sh EXIT STATUS
.Ex -std
.Sh SEE ALSO