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
Unknown Object (File)
Sep 14 2025, 9:29 AM
Unknown Object (File)
Sep 12 2025, 8:23 AM
Unknown Object (File)
Sep 12 2025, 7:43 AM
Unknown Object (File)
Sep 7 2025, 12:28 PM
Unknown Object (File)
Aug 23 2025, 3:20 PM
Unknown Object (File)
Aug 22 2025, 2:10 AM
Unknown Object (File)
Aug 18 2025, 4:48 PM
Unknown Object (File)
Aug 7 2025, 11:58 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