diff options
Diffstat (limited to 'modules/pam_motd/README')
| -rw-r--r-- | modules/pam_motd/README | 82 |
1 files changed, 0 insertions, 82 deletions
diff --git a/modules/pam_motd/README b/modules/pam_motd/README deleted file mode 100644 index 01bc64e9..00000000 --- a/modules/pam_motd/README +++ /dev/null @@ -1,82 +0,0 @@ -pam_motd — Display the motd file - -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ - -DESCRIPTION - -pam_motd is a PAM module that can be used to display arbitrary motd (message of -the day) files after a successful login. By default, pam_motd shows files in -the following locations: - -/etc/motd -/run/motd -/usr/lib/motd -/etc/motd.d/ -/run/motd.d/ -/usr/lib/motd.d/ - -Each message size is limited to 64KB. - -If /etc/motd does not exist, then /run/motd is shown. If /run/motd does not -exist, then /usr/lib/motd is shown. - -Similar overriding behavior applies to the directories. Files in /etc/motd.d/ -override files with the same name in /run/motd.d/ and /usr/lib/motd.d/. Files -in /run/motd.d/ override files with the same name in /usr/lib/motd.d/. - -Files in the directories listed above are displayed in lexicographic order by -name. Moreover, the files are filtered by reading them with the credentials of -the target user authenticating on the system. - -To silence a message, a symbolic link with target /dev/null may be placed in / -etc/motd.d with the same filename as the message to be silenced. Example: -Creating a symbolic link as follows silences /usr/lib/motd.d/my_motd. - -ln -s /dev/null /etc/motd.d/my_motd - -The MOTD_SHOWN=pam environment variable is set after showing the motd files, -even when all of them were silenced using symbolic links. - -OPTIONS - -motd=/path/filename - - The /path/filename file is displayed as message of the day. Multiple paths - to try can be specified as a colon-separated list. By default this option - is set to /etc/motd:/run/motd:/usr/lib/motd. - -motd_dir=/path/dirname.d - - The /path/dirname.d directory is scanned and each file contained inside of - it is displayed. Multiple directories to scan can be specified as a - colon-separated list. By default this option is set to /etc/motd.d:/run/ - motd.d:/usr/lib/motd.d. - -When no options are given, the default behavior applies for both options. -Specifying either option (or both) will disable the default behavior for both -options. - -EXAMPLES - -The suggested usage for /etc/pam.d/login is: - -session optional pam_motd.so - - -To use a motd file from a different location: - -session optional pam_motd.so motd=/elsewhere/motd - - -To use a motd file from elsewhere, along with a corresponding .d directory: - -session optional pam_motd.so motd=/elsewhere/motd motd_dir=/elsewhere/motd.d - - -AUTHOR - -pam_motd was written by Ben Collins <bcollins@debian.org>. - -The motd_dir= option was added by Allison Karlitskaya -<allison.karlitskaya@redhat.com>. - |