mirror of https://gitee.com/openkylin/pam.git
118 lines
3.0 KiB
XML
118 lines
3.0 KiB
XML
<?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_shells">
|
|
|
|
<refmeta>
|
|
<refentrytitle>pam_shells</refentrytitle>
|
|
<manvolnum>8</manvolnum>
|
|
<refmiscinfo class="sectdesc">Linux-PAM Manual</refmiscinfo>
|
|
</refmeta>
|
|
|
|
<refnamediv id="pam_shells-name">
|
|
<refname>pam_shells</refname>
|
|
<refpurpose>PAM module to check for valid login shell</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<cmdsynopsis id="pam_shells-cmdsynopsis">
|
|
<command>pam_shells.so</command>
|
|
</cmdsynopsis>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1 id="pam_shells-description">
|
|
|
|
<title>DESCRIPTION</title>
|
|
|
|
<para>
|
|
pam_shells is a PAM module that only allows access to the
|
|
system if the user's shell is listed in <filename>/etc/shells</filename>.
|
|
</para>
|
|
<para>
|
|
It also checks if <filename>/etc/shells</filename> is a plain
|
|
file and not world writable.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 id="pam_shells-options">
|
|
|
|
<title>OPTIONS</title>
|
|
<para> This module does not recognise any options.</para>
|
|
</refsect1>
|
|
|
|
<refsect1 id="pam_shells-types">
|
|
<title>MODULE TYPES PROVIDED</title>
|
|
<para>
|
|
The <option>auth</option> and <option>account</option>
|
|
module types are provided.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 id='pam_shells-return_values'>
|
|
<title>RETURN VALUES</title>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term>PAM_AUTH_ERR</term>
|
|
<listitem>
|
|
<para>
|
|
Access to the system was denied.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>PAM_SUCCESS</term>
|
|
<listitem>
|
|
<para>
|
|
The user's login shell was listed as valid shell in
|
|
<filename>/etc/shells</filename>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>PAM_SERVICE_ERR</term>
|
|
<listitem>
|
|
<para>
|
|
The module was not able to get the name of the user.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1>
|
|
|
|
<refsect1 id='pam_shells-examples'>
|
|
<title>EXAMPLES</title>
|
|
<para>
|
|
<programlisting>
|
|
auth required pam_shells.so
|
|
</programlisting>
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 id='pam_shells-see_also'>
|
|
<title>SEE ALSO</title>
|
|
<para>
|
|
<citerefentry>
|
|
<refentrytitle>shells</refentrytitle><manvolnum>5</manvolnum>
|
|
</citerefentry>,
|
|
<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_shells-author'>
|
|
<title>AUTHOR</title>
|
|
<para>
|
|
pam_shells was written by Erik Troan <ewt@redhat.com>.
|
|
</para>
|
|
</refsect1>
|
|
|
|
</refentry>
|