diff options
Diffstat (limited to '')
-rw-r--r-- | modules/pam_mail/pam_mail.8 | 159 | ||||
-rw-r--r-- | modules/pam_mail/pam_mail.8.xml | 280 |
2 files changed, 439 insertions, 0 deletions
diff --git a/modules/pam_mail/pam_mail.8 b/modules/pam_mail/pam_mail.8 new file mode 100644 index 0000000..41e6e44 --- /dev/null +++ b/modules/pam_mail/pam_mail.8 @@ -0,0 +1,159 @@ +'\" t +.\" Title: pam_mail +.\" Author: [see the "AUTHOR" section] +.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/> +.\" Date: 05/18/2017 +.\" Manual: Linux-PAM Manual +.\" Source: Linux-PAM Manual +.\" Language: English +.\" +.TH "PAM_MAIL" "8" "05/18/2017" "Linux-PAM Manual" "Linux\-PAM Manual" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +pam_mail \- Inform about available mail +.SH "SYNOPSIS" +.HP \w'\fBpam_mail\&.so\fR\ 'u +\fBpam_mail\&.so\fR [close] [debug] [dir=\fImaildir\fR] [empty] [hash=\fIcount\fR] [noenv] [nopen] [quiet] [standard] +.SH "DESCRIPTION" +.PP +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 +\fInewness\fR +of any mail it finds in the user\*(Aqs mail folder\&. This module also sets the PAM environment variable, +\fBMAIL\fR, to the user\*(Aqs mail directory\&. +.PP +If the mail spool file (be it +/var/mail/$USER +or a pathname given with the +\fBdir=\fR +parameter) is a directory then pam_mail assumes it is in the +\fIMaildir\fR +format\&. +.SH "OPTIONS" +.PP +.PP +\fBclose\fR +.RS 4 +Indicate if the user has any mail also on logout\&. +.RE +.PP +\fBdebug\fR +.RS 4 +Print debug information\&. +.RE +.PP +\fBdir=\fR\fB\fImaildir\fR\fR +.RS 4 +Look for the user\*(Aqs 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 \*(Aq~\*(Aq, the directory is interpreted as indicating a file in the user\*(Aqs home directory\&. +.RE +.PP +\fBempty\fR +.RS 4 +Also print message if user has no mail\&. +.RE +.PP +\fBhash=\fR\fB\fIcount\fR\fR +.RS 4 +Mail directory hash depth\&. For example, a +\fIhashcount\fR +of 2 would make the mail file be +/var/spool/mail/u/s/user\&. +.RE +.PP +\fBnoenv\fR +.RS 4 +Do not set the +\fBMAIL\fR +environment variable\&. +.RE +.PP +\fBnopen\fR +.RS 4 +Don\*(Aqt print any mail information on login\&. This flag is useful to get the +\fBMAIL\fR +environment variable set, but to not display any information about it\&. +.RE +.PP +\fBquiet\fR +.RS 4 +Only report when there is new mail\&. +.RE +.PP +\fBstandard\fR +.RS 4 +Old style "You have\&.\&.\&." format which doesn\*(Aqt show the mail spool being used\&. This also implies "empty"\&. +.RE +.SH "MODULE TYPES PROVIDED" +.PP +The +\fBsession\fR +and +\fBauth\fR +(on establishment and deletion of credentials) module types are provided\&. +.SH "RETURN VALUES" +.PP +PAM_BUF_ERR +.RS 4 +Memory buffer error\&. +.RE +.PP +PAM_SERVICE_ERR +.RS 4 +Badly formed arguments\&. +.RE +.PP +PAM_SUCCESS +.RS 4 +Success\&. +.RE +.PP +PAM_USER_UNKNOWN +.RS 4 +User not known\&. +.RE +.SH "EXAMPLES" +.PP +Add the following line to +/etc/pam\&.d/login +to indicate that the user has new mail when they login to the system\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +session optional pam_mail\&.so standard + +.fi +.if n \{\ +.RE +.\} +.sp +.SH "SEE ALSO" +.PP +\fBpam.conf\fR(5), +\fBpam.d\fR(5), +\fBpam\fR(8) +.SH "AUTHOR" +.PP +pam_mail was written by Andrew G\&. Morgan <morgan@kernel\&.org>\&. diff --git a/modules/pam_mail/pam_mail.8.xml b/modules/pam_mail/pam_mail.8.xml new file mode 100644 index 0000000..95216b6 --- /dev/null +++ b/modules/pam_mail/pam_mail.8.xml @@ -0,0 +1,280 @@ +<?xml version="1.0" encoding='UTF-8'?> +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" + "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"> + +<refentry id="pam_mail"> + + <refmeta> + <refentrytitle>pam_mail</refentrytitle> + <manvolnum>8</manvolnum> + <refmiscinfo class="sectdesc">Linux-PAM Manual</refmiscinfo> + </refmeta> + + <refnamediv id="pam_mail-name"> + <refname>pam_mail</refname> + <refpurpose>Inform about available mail</refpurpose> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="pam_mail-cmdsynopsis"> + <command>pam_mail.so</command> + <arg choice="opt"> + close + </arg> + <arg choice="opt"> + debug + </arg> + <arg choice="opt"> + dir=<replaceable>maildir</replaceable> + </arg> + <arg choice="opt"> + empty + </arg> + <arg choice="opt"> + hash=<replaceable>count</replaceable> + </arg> + <arg choice="opt"> + noenv + </arg> + <arg choice="opt"> + nopen + </arg> + <arg choice="opt"> + quiet + </arg> + <arg choice="opt"> + standard + </arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1 id="pam_mail-description"> + + <title>DESCRIPTION</title> + + <para> + 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 <emphasis>newness</emphasis> of any mail it finds + in the user's mail folder. This module also sets the PAM + environment variable, <emphasis remap='B'>MAIL</emphasis>, to the + user's mail directory. + </para> + <para> + If the mail spool file (be it <filename>/var/mail/$USER</filename> + or a pathname given with the <option>dir=</option> parameter) is + a directory then pam_mail assumes it is in the + <emphasis remap='I'>Maildir</emphasis> format. + </para> + </refsect1> + + <refsect1 id="pam_mail-options"> + + <title>OPTIONS</title> + <para> + <variablelist> + + <varlistentry> + <term> + <option>close</option> + </term> + <listitem> + <para> + Indicate if the user has any mail also on logout. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <option>debug</option> + </term> + <listitem> + <para> + Print debug information. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <option>dir=<replaceable>maildir</replaceable></option> + </term> + <listitem> + <para> + Look for the user's mail in an alternative location defined by + <filename>maildir/<login></filename>. The default + location for mail is <filename>/var/mail/<login></filename>. + Note, if the supplied + <filename>maildir</filename> is prefixed by a '~', the + directory is interpreted as indicating a file in the user's + home directory. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <option>empty</option> + </term> + <listitem> + <para> + Also print message if user has no mail. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <option>hash=<replaceable>count</replaceable></option> + </term> + <listitem> + <para> + Mail directory hash depth. For example, a + <emphasis>hashcount</emphasis> of 2 would + make the mail file be + <filename>/var/spool/mail/u/s/user</filename>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <option>noenv</option> + </term> + <listitem> + <para> + Do not set the <emphasis remap='B'>MAIL</emphasis> + environment variable. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <option>nopen</option> + </term> + <listitem> + <para> + Don't print any mail information on login. This flag is + useful to get the <emphasis remap='B'>MAIL</emphasis> + environment variable set, but to not display any information + about it. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <option>quiet</option> + </term> + <listitem> + <para> + Only report when there is new mail. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <option>standard</option> + </term> + <listitem> + <para> + Old style "You have..." format which doesn't show the + mail spool being used. This also implies "empty". + </para> + </listitem> + </varlistentry> + + </variablelist> + + </para> + </refsect1> + + <refsect1 id="pam_mail-types"> + <title>MODULE TYPES PROVIDED</title> + <para> + The <option>session</option> and + <option>auth</option> (on establishment and + deletion of credentials) module types are provided. + </para> + </refsect1> + + <refsect1 id='pam_mail-return_values'> + <title>RETURN VALUES</title> + <variablelist> + <varlistentry> + <term>PAM_BUF_ERR</term> + <listitem> + <para> + Memory buffer error. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>PAM_SERVICE_ERR</term> + <listitem> + <para> + Badly formed arguments. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>PAM_SUCCESS</term> + <listitem> + <para> + Success. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>PAM_USER_UNKNOWN</term> + <listitem> + <para> + User not known. + </para> + </listitem> + </varlistentry> + + </variablelist> + </refsect1> + + <refsect1 id='pam_mail-examples'> + <title>EXAMPLES</title> + <para> + Add the following line to <filename>/etc/pam.d/login</filename> to + indicate that the user has new mail when they login to the system. + <programlisting> +session optional pam_mail.so standard + </programlisting> + </para> + </refsect1> + + <refsect1 id='pam_mail-see_also'> + <title>SEE ALSO</title> + <para> + <citerefentry> + <refentrytitle>pam.conf</refentrytitle><manvolnum>5</manvolnum> + </citerefentry>, + <citerefentry> + <refentrytitle>pam.d</refentrytitle><manvolnum>5</manvolnum> + </citerefentry>, + <citerefentry> + <refentrytitle>pam</refentrytitle><manvolnum>8</manvolnum> + </citerefentry> + </para> + </refsect1> + + <refsect1 id='pam_mail-author'> + <title>AUTHOR</title> + <para> + pam_mail was written by Andrew G. Morgan <morgan@kernel.org>. + </para> + </refsect1> + +</refentry> |