login: add MOTD_FIRSTONLY=

[thirdparty/util-linux.git] / login-utils / login.1

diff --git a/login-utils/login.1 b/login-utils/login.1
index 1e2d3cb28990c60b080449e31eb111d9deb1feb1..24cd7d2bc1b52c5ab0446b996370e57ecaccdd5e 100644 (file)
--- a/login-utils/login.1
+++ b/login-utils/login.1
@@ -168,6 +168,25 @@ PAM module.
 The directories in the
 .B MOTD_FILE
 are supported since version 2.36.
+.PP
+Note that
+.B login
+does not implement any filenames overriding behavior like pam_motd
+(see also MOTD_FIRSTONLY), but all content from all files is displayed.  It is
+recommended to keep extra logic in content generators and use /run/motd.d rather
+than rely on overriding behavior hardcoded in system tools.
+.RE
+.PP
+.B MOTD_FIRSTONLY (boolean)
+.RS 4
+Forces
+.B login
+to stop display content specified by
+.B MOTD_FILE
+after first accessible item in the list.  Note that a directory is one item in this case.
+This option allows to configure
+.B login
+semantic to be more compatible with pam_motd.
 .RE
 .PP
 .B LOGIN_PLAIN_PROMPT