From e4bd855661afe7c83ad2745d086a538398205225 Mon Sep 17 00:00:00 2001 From: Michael Vetter Date: Thu, 6 Aug 2026 17:51:37 +0200 Subject: [PATCH] man: Document UAPI merging in login.defs b52ce71c added support for UAPI/libeconf. The first release to contain this change was 4.8. Update our man pages to properly describe the various locations of login.defs if shadow is compiled with libeconf and without. Ref: b52ce71c (2019-10-05; "Add support for a vendor directory and libeconf") Closes: Closes: Signed-off-by: Michael Vetter --- man/chfn.1.xml | 6 +++++- man/chgpasswd.8.xml | 6 +++++- man/chpasswd.8.xml | 6 +++++- man/chsh.1.xml | 6 +++++- man/groupadd.8.xml | 6 +++++- man/groupmod.8.xml | 6 +++++- man/login.1.xml | 6 +++++- man/login.access.5.xml | 6 +++++- man/login.defs.5.xml | 21 +++++++++++++++++---- man/newusers.8.xml | 6 +++++- man/passwd.1.xml | 6 +++++- man/pwconv.8.xml | 6 +++++- man/su.1.xml | 6 +++++- man/useradd.8.xml | 6 +++++- man/userdel.8.xml | 6 +++++- man/usermod.8.xml | 6 +++++- 16 files changed, 92 insertions(+), 19 deletions(-) diff --git a/man/chfn.1.xml b/man/chfn.1.xml index e329efe90..dc7a8d0ae 100644 --- a/man/chfn.1.xml +++ b/man/chfn.1.xml @@ -187,7 +187,11 @@ FILES - /etc/login.defs + + + login.defs5 + + Shadow password suite configuration. diff --git a/man/chgpasswd.8.xml b/man/chgpasswd.8.xml index 81d8985f9..7afcae827 100644 --- a/man/chgpasswd.8.xml +++ b/man/chgpasswd.8.xml @@ -218,7 +218,11 @@ - /etc/login.defs + + + login.defs5 + + Shadow password suite configuration. diff --git a/man/chpasswd.8.xml b/man/chpasswd.8.xml index 80d8ce594..94a8669dc 100644 --- a/man/chpasswd.8.xml +++ b/man/chpasswd.8.xml @@ -272,7 +272,11 @@ - /etc/login.defs + + + login.defs5 + + Shadow password suite configuration. diff --git a/man/chsh.1.xml b/man/chsh.1.xml index c4e5614e0..1e86e8119 100644 --- a/man/chsh.1.xml +++ b/man/chsh.1.xml @@ -190,7 +190,11 @@ - /etc/login.defs + + + login.defs5 + + Shadow password suite configuration. diff --git a/man/groupadd.8.xml b/man/groupadd.8.xml index c6001671f..fa11e6f35 100644 --- a/man/groupadd.8.xml +++ b/man/groupadd.8.xml @@ -274,7 +274,11 @@ - /etc/login.defs + + + login.defs5 + + Shadow password suite configuration. diff --git a/man/groupmod.8.xml b/man/groupmod.8.xml index ca2874411..a8e5a5e24 100644 --- a/man/groupmod.8.xml +++ b/man/groupmod.8.xml @@ -237,7 +237,11 @@ - /etc/login.defs + + + login.defs5 + + Shadow password suite configuration. diff --git a/man/login.1.xml b/man/login.1.xml index 83aa52d28..600cb654a 100644 --- a/man/login.1.xml +++ b/man/login.1.xml @@ -354,7 +354,11 @@ - /etc/login.defs + + + login.defs5 + + Shadow password suite configuration. diff --git a/man/login.access.5.xml b/man/login.access.5.xml index 3c425cc1d..af53f64a6 100644 --- a/man/login.access.5.xml +++ b/man/login.access.5.xml @@ -97,7 +97,11 @@ FILES - /etc/login.defs + + + login.defs5 + + Shadow password suite configuration. diff --git a/man/login.defs.5.xml b/man/login.defs.5.xml index b7cdf3e78..0cc30a63d 100644 --- a/man/login.defs.5.xml +++ b/man/login.defs.5.xml @@ -115,10 +115,23 @@ DESCRIPTION - The /etc/login.defs file defines the - site-specific configuration for the shadow password suite. This file - is required. Absence of this file will not prevent system operation, - but will probably result in undesirable operation. + The configuration for the shadow password suite is defined by + login.defs. + + + Depending on compile-time configuration, + the settings are either read from a single file + (/etc/login.defs), + or merged hierarchically + (if compiled with libeconf support): + from /usr/etc/login.defs, + /usr/lib/login.defs, + /etc/login.defs, + and drop-ins under /etc/login.defs.d/. + + + The merging follows the UAPI configuration file specification: + https://uapi-group.org/specifications/specs/configuration_files_specification/ diff --git a/man/newusers.8.xml b/man/newusers.8.xml index 59f868226..621848463 100644 --- a/man/newusers.8.xml +++ b/man/newusers.8.xml @@ -436,7 +436,11 @@ - /etc/login.defs + + + login.defs5 + + Shadow password suite configuration. diff --git a/man/passwd.1.xml b/man/passwd.1.xml index b133eb6d5..35048ed3a 100644 --- a/man/passwd.1.xml +++ b/man/passwd.1.xml @@ -411,7 +411,11 @@ - /etc/login.defs + + + login.defs5 + + Shadow password suite configuration. diff --git a/man/pwconv.8.xml b/man/pwconv.8.xml index 89741a203..3ed70b256 100644 --- a/man/pwconv.8.xml +++ b/man/pwconv.8.xml @@ -225,7 +225,11 @@ FILES - /etc/login.defs + + + login.defs5 + + Shadow password suite configuration. diff --git a/man/su.1.xml b/man/su.1.xml index 5c5001453..e5a55341e 100644 --- a/man/su.1.xml +++ b/man/su.1.xml @@ -354,7 +354,11 @@ - /etc/login.defs + + + login.defs5 + + Shadow password suite configuration. diff --git a/man/useradd.8.xml b/man/useradd.8.xml index 9e15763fa..5a0937d23 100644 --- a/man/useradd.8.xml +++ b/man/useradd.8.xml @@ -893,7 +893,11 @@ - /etc/login.defs + + + login.defs5 + + Shadow password suite configuration. diff --git a/man/userdel.8.xml b/man/userdel.8.xml index e10a6af80..0a40d4f80 100644 --- a/man/userdel.8.xml +++ b/man/userdel.8.xml @@ -181,7 +181,11 @@ - /etc/login.defs + + + login.defs5 + + Shadow password suite configuration. diff --git a/man/usermod.8.xml b/man/usermod.8.xml index c84d10f24..230b7c52e 100644 --- a/man/usermod.8.xml +++ b/man/usermod.8.xml @@ -601,7 +601,11 @@ - /etc/login.defs + + + login.defs5 + + Shadow password suite configuration -- 2.47.3