granicus.if.org Git - linux-pam/blob - doc/modules/pam_nologin.sgml

   1 <!--
   2    $Id$
   3
   4    This file was written by Michael K. Johnson <johnsonm@redhat.com>
   5 -->
   6
   7 <sect1>The no-login module
   8
   9 <sect2>Synopsis
  10
  11 <p>
  12 <descrip>
  13
  14 <tag><bf>Module Name:</bf></tag>
  15 <tt/pam_nologin/
  16
  17 <tag><bf>Author:</bf></tag>
  18 Written by Michael K. Johnson &lt;johnsonm@redhat.com&gt;<newline>
  19 (based on code taken from a module written by Andrew G. Morgan
  20 &lt;morgan@parc.power.net&gt;).
  21
  22 <tag><bf>Maintainer:</bf></tag>
  23 Michael K. Johnson &lt;johnsonm@redhat.com&gt;
  24
  25 <tag><bf>Management groups provided:</bf></tag>
  26 authentication
  27
  28 <tag><bf>Cryptographically sensitive:</bf></tag>
  29
  30 <tag><bf>Security rating:</bf></tag>
  31
  32 <tag><bf>Clean code base:</bf></tag>
  33 1 warning about dropping const
  34
  35 <tag><bf>System dependencies:</bf></tag>
  36
  37 <tag><bf>Network aware:</bf></tag>
  38
  39 </descrip>
  40
  41 <sect2>Overview of module
  42
  43 <p>
  44 Provides standard Unix <em/nologin/ authentication.
  45
  46 <sect2>Authentication component
  47
  48 <p>
  49 <descrip>
  50
  51 <tag><bf>Recognized arguments:</bf></tag>
  52
  53 <tag><bf>Description:</bf></tag>
  54
  55 Provides standard Unix <em/nologin/ authentication.  If the file
  56 <tt>/etc/nologin</tt> exists, only root is allowed to log in; other
  57 users are turned away with an error message.  All users (root or
  58 otherwise) are shown the contents of <tt>/etc/nologin</tt>.
  59
  60 <p>
  61 If the file <tt>/etc/nologin</tt> does not exist, this module succeeds
  62 silently.
  63
  64 <tag><bf>Examples/suggested usage:</bf></tag>
  65
  66 In order to make this module effective, all login methods should
  67 be secured by it.  It should be used as a <tt>required</tt>
  68 method listed before any <tt>sufficient</tt> methods in order to
  69 get standard Unix nologin semantics.
  70
  71 </descrip>
  72
  73 <!--
  74 End of sgml insert for this module.
  75 -->