shadow/man/login.defs.d/TTYGROUP.xml
Serge Hallyn 1058872a0b Improve TTYGROUP description in login.defs manpage
Closes #457

The existing prose was confusing, or simply wrong.  Make it clear
that only the group ownership of the tty is affected, and how.
Also move the paragraph about defaults after the discussion of
acceptable TTYGROUPs, as this seems more natural.

Signed-off-by: Serge Hallyn <serge@hallyn.com>
2023-02-02 22:03:45 -06:00

34 lines
1.2 KiB
XML

<!--
SPDX-FileCopyrightText: 1991 - 1993, Julianne Frances Haugh
SPDX-FileCopyrightText: 1991 - 1993, Chip Rosenthal
SPDX-FileCopyrightText: 2007 - 2008, Nicolas François
SPDX-License-Identifier: BSD-3-Clause
-->
<varlistentry>
<term><option>TTYGROUP</option> (string)</term>
<term><option>TTYPERM</option> (string)</term>
<listitem>
<para>
The terminal permissions: the login tty will be owned by the
<option>TTYGROUP</option> group, and the permissions will be set to
<option>TTYPERM</option>.
</para>
<para>
<option>TTYGROUP</option> can be either the name of a group or a
numeric group identifier.
</para>
<para>
If TTYGROUP is not defined, then the group ownership of the terminal is
set to the user's primary group. If TTYPERM is not defined, then the
permissions are set to
<replaceable>0600</replaceable>.
</para>
<para>
If you have a <command>write</command> program which is "setgid" to
a special group which owns the terminals, define TTYGROUP to the
group number and TTYPERM to 0620. Otherwise leave TTYGROUP
commented out and assign TTYPERM to either 622 or 600.
</para>
</listitem>
</varlistentry>