NAME | SYNOPSIS | DESCRIPTION | OPTIONS | MODULE TYPES PROVIDED | RETURN VALUES | EXAMPLES | SEE ALSO | AUTHOR | COLOPHON

PAM_MAIL(8)                   Linux-PAM Manual                   PAM_MAIL(8)

NAME         top

       pam_mail - Inform about available mail

SYNOPSIS         top

       pam_mail.so [close] [debug] [dir=maildir] [empty] [hash=count]
                   [noenv] [nopen] [quiet] [standard]

DESCRIPTION         top

       The pam_mail PAM module provides the "you have new mail" service to
       the user. It can be plugged into any application that has credential
       or session hooks. It gives a single message indicating the newness of
       any mail it finds in the user's mail folder. This module also sets
       the PAM environment variable, MAIL, to the user's mail directory.
       If the mail spool file (be it /var/mail/$USER or a pathname given
       with the dir= parameter) is a directory then pam_mail assumes it is
       in the Maildir format.

OPTIONS         top

       close
           Indicate if the user has any mail also on logout.
       debug
           Print debug information.
       dir=maildir
           Look for the user's mail in an alternative location defined by
           maildir/<login>. The default location for mail is
           /var/mail/<login>. Note, if the supplied maildir is prefixed by a
           '~', the directory is interpreted as indicating a file in the
           user's home directory.
       empty
           Also print message if user has no mail.
       hash=count
           Mail directory hash depth. For example, a hashcount of 2 would
           make the mail file be /var/spool/mail/u/s/user.
       noenv
           Do not set the MAIL environment variable.
       nopen
           Don't print any mail information on login. This flag is useful to
           get the MAIL environment variable set, but to not display any
           information about it.
       quiet
           Only report when there is new mail.
       standard
           Old style "You have..." format which doesn't show the mail spool
           being used. This also implies "empty".

MODULE TYPES PROVIDED         top

       The session and auth (on establishment and deletion of credentials)
       module types are provided.

RETURN VALUES         top

       PAM_BUF_ERR
           Memory buffer error.
       PAM_SERVICE_ERR
           Badly formed arguments.
       PAM_SUCCESS
           Success.
       PAM_USER_UNKNOWN
           User not known.

EXAMPLES         top

       Add the following line to /etc/pam.d/login to indicate that the user
       has new mail when they login to the system.
           session  optional  pam_mail.so standard

SEE ALSO         top

       pam.conf(5), pam.d(5), pam(8)

AUTHOR         top

       pam_mail was written by Andrew G. Morgan <morgan@kernel.org>.

COLOPHON         top

       This page is part of the linux-pam (Pluggable Authentication Modules
       for Linux) project.  Information about the project can be found at 
       ⟨http://www.linux-pam.org/⟩.  If you have a bug report for this manual
       page, see ⟨//www.linux-pam.org/⟩.  This page was obtained from the
       tarball Linux-PAM-1.3.0.tar.gz fetched from 
       ⟨http://www.linux-pam.org/library/⟩ on 2017-07-05.  If you discover
       any rendering problems in this HTML version of the page, or you
       believe there is a better or more up-to-date source for the page, or
       you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a mail
       to man-pages@man7.org
Linux-PAM Manual                 04/01/2016                      PAM_MAIL(8)