Page MenuHomeFreeBSD

Mention when SIGTTOU AND SIGTTIN can be raised in tcsetpgrp(3) and tcgetpgrp(3)
Needs ReviewPublic

Authored by felix.the.red_gmail.com on Jun 26 2025, 11:49 PM.
Tags
None
Referenced Files
F160589347: D51074.diff
Thu, Jun 25, 11:29 PM
Unknown Object (File)
Tue, Jun 23, 5:46 AM
Unknown Object (File)
Sat, May 30, 1:43 AM
Unknown Object (File)
Fri, May 29, 11:36 PM
Unknown Object (File)
May 27 2026, 6:07 PM
Unknown Object (File)
May 22 2026, 3:02 AM
Unknown Object (File)
May 17 2026, 8:50 PM
Unknown Object (File)
Apr 30 2026, 12:49 AM
Subscribers

Details

Reviewers
None
Group Reviewers
manpages
Summary

For tcsetpgrp(3), mention SIGTTOU can be raised.
For tcgetpgrp(3), mention SIGTTIN can be raised.
In both cases, suggest options to handle the signal.
Add cross references to sigaction and signal.

From the original PR:
I recently had some difficulties when trying to use tcsetpgrp(3)
from a process trying to bring itself as the foreground process
group leader of its controlling terminal.
The process got a SIGTTOU sent, that was unexpected as this signal
is not mentioned at all in the tcsetpgrp(3) manpage.

An explanation of the role of SIGTTOU and its usage relative to
tcsetpgrp(3) should be added to the manual page as it plays an
important role in the correct application of this library function.

PR:264971

Test Plan

mandoc -Tlint

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Skipped
Unit
Tests Skipped