← Back to branch summary

~ubuntu-branches/ubuntu/breezy/pam/breezy

« back to all changes in this revision

Viewing changes to Linux-PAM/doc/modules/pam_rootok.sgml

  • Committer: Bazaar Package Importer
  • Author(s): Sam Hartman
  • Date: 2004-06-28 14:28:08 UTC
  • mfrom: (2.1.1 warty)
  • Revision ID: james.westby@ubuntu.com-20040628142808-adikk7vtfg3pzcjw
Tags: 0.76-22
http://bugs.debian.org/254904
* Add uploaders
* Document location of repository
* Fix options containing arguments in pam_unix, Closes: #254904

Show diffs side-by-side

added added

removed removed

Lines of Context:
Linux-PAM/doc/modules/pam_rootok.sgml
 
1
<!--
 
2
   $Id: pam_rootok.sgml,v 1.1.1.2 2002/09/15 20:08:32 hartmans Exp $
 
3
   
 
4
   This file was written by Andrew G. Morgan <morgan@kernel.org>
 
5
-->
 
6
 
 
7
<sect1>The root access module
 
8
 
 
9
<sect2>Synopsis
 
10
 
 
11
<p>
 
12
<descrip>
 
13
 
 
14
<tag><bf>Module Name:</bf></tag>
 
15
pam_rootok
 
16
 
 
17
<tag><bf>Author:</bf></tag>
 
18
Andrew G. Morgan &lt;morgan@kernel.org&gt;
 
19
 
 
20
<tag><bf>Maintainer:</bf></tag>
 
21
<bf>Linux-PAM</bf> maintainer
 
22
 
 
23
<tag><bf>Management groups provided:</bf></tag>
 
24
authentication
 
25
 
 
26
<tag><bf>Cryptographically sensitive:</bf></tag>
 
27
        
 
28
<tag><bf>Security rating:</bf></tag>
 
29
 
 
30
<tag><bf>Clean code base:</bf></tag>
 
31
Clean.
 
32
 
 
33
<tag><bf>System dependencies:</bf></tag>
 
34
 
 
35
<tag><bf>Network aware:</bf></tag>
 
36
 
 
37
</descrip>
 
38
 
 
39
<sect2>Overview of module
 
40
 
 
41
<p>
 
42
This module is for use in situations where the superuser wishes
 
43
to gain access to a service without having to enter a password.
 
44
 
 
45
<sect2>Authentication component
 
46
 
 
47
<p>
 
48
<descrip>
 
49
 
 
50
<tag><bf>Recognized arguments:</bf></tag>
 
51
<tt/debug/
 
52
 
 
53
<tag><bf>Description:</bf></tag>
 
54
 
 
55
This module authenticates the user if their <tt/uid/ is <tt/0/.
 
56
Applications that are created <em/setuid/-root generally retain the
 
57
<tt/uid/ of the user but run with the authority of an enhanced
 
58
<em/effective-/<tt/uid/. It is the real <tt/uid/ that is checked.
 
59
 
 
60
<tag><bf>Examples/suggested usage:</bf></tag>
 
61
 
 
62
In the case of the <tt/su/ application the historical usage is to
 
63
permit the superuser to adopt the identity of a lesser user without
 
64
the use of a password. To obtain this behavior under <tt/Linux-PAM/
 
65
the following pair of lines are needed for the corresponding entry in
 
66
the configuration file:
 
67
<tscreen>
 
68
<verb>
 
69
#
 
70
# su authentication. Root is granted access by default.
 
71
#
 
72
su      auth     sufficient     pam_rootok.so
 
73
su      auth     required       pam_unix_auth.so
 
74
</verb>
 
75
</tscreen>
 
76
 
 
77
<p>
 
78
Note. For programs that are run by the superuser (or started when the
 
79
system boots) this module should not be used to authenticate users.
 
80
 
 
81
</descrip>
 
82
 
 
83
<!--
 
84
End of sgml insert for this module.
 
85
-->