Skip to content

Man: Document FORCE_SHADOW option in login.defs(5) - #1730

Open
asakure wants to merge 1 commit into
shadow-maint:masterfrom
asakure:document_force_shadow
Open

Man: Document FORCE_SHADOW option in login.defs(5)#1730
asakure wants to merge 1 commit into
shadow-maint:masterfrom
asakure:document_force_shadow

Conversation

@asakure

@asakure asakure commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

FORCE_SHADOW option is already implemented in code
but it was missing from the login.defs(5) man-page.

Comment thread man/login.defs.d/FORCE_SHADOW.xml
@asakure
asakure force-pushed the document_force_shadow branch from 15241e3 to a1c266b Compare September 7, 2026 06:56
Comment on lines +9 to +15
If set to <replaceable>yes</replaceable>,
the shadow utilities will create the shadow passwd and
shadow group files if
<filename>/etc/shadow</filename> or
<filename>/etc/gshadow</filename> are missing and
use them.
The default value is <replaceable>no</replaceable>.

@alejandro-colomar alejandro-colomar Sep 7, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's just name /etc/shadow and /etc/gshadow in the first reference:

If set to <replaceable>yes</replaceable>,
the shadow utilities will create
<filename>/etc/shadow</filename>
and/or
<filename>/etc/gshadow</filename>
if they are missing,
and use them. 
The default value is <replaceable>no</replaceable>.

@hallyn , @ikerexxe , I've never used this feature, and thus don't know it enough; if you know it, please verify that this text matches the actual behavior.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @alejandro-colomar I have rephrased the text in FORCE_SHADOW.xml file.
One more question - do I need to add FORCE_SHADOW under CROSS REFERENCES section as well ? (as of now, I did it for a few but not for all)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't know. What do we do for similar variables?

FORCE_SHADOW option is already implemented in code but
it was missing from the man-page.

Signed-off-by: Akshay Sakure <asakure@redhat.com>
@asakure
asakure force-pushed the document_force_shadow branch from a1c266b to 1d59b2c Compare September 7, 2026 14:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants