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

   1 <!--
   2    $Id$
   3
   4    This file was written by Andrew G. Morgan <morgan@kernel.org>
   5 -->
   6
   7 <sect1>The promiscuous module
   8
   9 <sect2>Synopsis
  10
  11 <p>
  12 <descrip>
  13
  14 <tag><bf>Module Name:</bf></tag>
  15 pam_permit
  16
  17 <tag><bf>Author:</bf></tag>
  18 Andrew G. Morgan, &lt;morgan@kernel.org&gt;
  19
  20 <tag><bf>Maintainer:</bf></tag>
  21 Linux-PAM maintainer.
  22
  23 <tag><bf>Management groups provided:</bf></tag>
  24 account; authentication; password; session
  25
  26 <tag><bf>Cryptographically sensitive:</bf></tag>
  27
  28 <tag><bf>Security rating:</bf></tag>
  29 VERY LOW. Use with extreme caution.
  30
  31 <tag><bf>Clean code base:</bf></tag>
  32 Clean.
  33
  34 <tag><bf>System dependencies:</bf></tag>
  35
  36 <tag><bf>Network aware:</bf></tag>
  37
  38 </descrip>
  39
  40 <sect2>Overview of module
  41
  42 <p>
  43 This module is very dangerous. It should be used with extreme
  44 caution. Its action is always to permit access. It does nothing else.
  45
  46 <sect2>Account+Authentication+Password+Session components
  47
  48 <p>
  49 <descrip>
  50
  51 <tag><bf>Recognized arguments:</bf></tag>
  52
  53 <tag><bf>Description:</bf></tag>
  54
  55 No matter what management group, the action of this module is to
  56 simply return <tt/PAM_SUCCESS/ -- operation successful.
  57
  58 <p>
  59 In the case of authentication, the user's name will be acquired. Many
  60 applications become confused if this name is unknown.
  61
  62 <tag><bf>Examples/suggested usage:</bf></tag>
  63
  64 It is seldom a good idea to use this module. However, it does have
  65 some legitimate uses.  For example, if the system-administrator wishes
  66 to turn off the account management on a workstation, and at the same
  67 time continue to allow logins, then she might use the following
  68 configuration file entry for login:
  69 <tscreen>
  70 <verb>
  71 #
  72 # add this line to your other login entries to disable account
  73 # management, but continue to permit users to log in...
  74 #
  75 login   account  required       pam_permit.so
  76 </verb>
  77 </tscreen>
  78
  79 </descrip>
  80
  81 <!--
  82 End of sgml insert for this module.
  83 -->