summaryrefslogtreecommitdiff
path: root/doc/man/PAM.8
diff options
context:
space:
mode:
Diffstat (limited to 'doc/man/PAM.8')
-rw-r--r--doc/man/PAM.847
1 files changed, 20 insertions, 27 deletions
diff --git a/doc/man/PAM.8 b/doc/man/PAM.8
index 6f6dabc5..c693e268 100644
--- a/doc/man/PAM.8
+++ b/doc/man/PAM.8
@@ -1,11 +1,11 @@
.\" Title: pam
.\" Author:
.\" Generator: DocBook XSL Stylesheets v1.70.1 <http://docbook.sf.net/>
-.\" Date: 06/02/2006
+.\" Date: 06/19/2006
.\" Manual: Linux\-PAM Manual
.\" Source: Linux\-PAM Manual
.\"
-.TH "PAM" "8" "06/02/2006" "Linux\-PAM Manual" "Linux\-PAM Manual"
+.TH "PAM" "8" "06/19/2006" "Linux\-PAM Manual" "Linux\-PAM Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
@@ -18,8 +18,9 @@ This manual is intended to offer a quick introduction to
\fBLinux\-PAM\fR. For more information the reader is directed to the
\fBLinux\-PAM system administrators' guide\fR.
.PP
+
\fBLinux\-PAM\fR
-Is a system of libraries that handle the authentication tasks of applications (services) on the system. The library provides a stable general interface (Application Programming Interface \- API) that privilege granting programs (such as
+is a system of libraries that handle the authentication tasks of applications (services) on the system. The library provides a stable general interface (Application Programming Interface \- API) that privilege granting programs (such as
\fBlogin\fR(1)
and
\fBsu\fR(1)) defer to to perform standard authentication tasks.
@@ -29,8 +30,10 @@ The principal feature of the PAM approach is that the nature of the authenticati
configuration file
\fI/etc/pam.conf\fR. Alternatively, the configuration can be set by individual configuration files located in the
\fI/etc/pam.d/\fR
-directory.
-\fIThe presence of this directory will cause \fR\fBLinux\-PAM\fR\fI to ignore\fR
+directory. The presence of this directory will cause
+\fBLinux\-PAM\fR
+to
+\fIignore\fR
\fI/etc/pam.conf\fR.
.PP
From the point of view of the system administrator, for whom this manual is provided, it is not of primary importance to understand the internal behavior of the
@@ -71,22 +74,16 @@ group. Some authentication mechanisms lend themselves well to being updated with
\fBsession\fR
management group is important as it provides both an opening and closing hook for modules to affect the services available to a user.
.SH "FILES"
-.PP
+.TP 3n
\fI/etc/pam.conf\fR
-\- the configuration file
-
-\fI/etc/pam.d/\fR
-\- the
+the configuration file
+.TP 3n
+\fI/etc/pam.d\fR
+the
\fBLinux\-PAM\fR
configuration directory. Generally, if this directory is present, the
\fI/etc/pam.conf\fR
file is ignored.
-
-\fI/lib/libpam.so.X\fR
-\- the dynamic library
-
-\fI/lib/security/*.so\fR
-\- the PAMs
.SH "ERRORS"
.PP
Typically errors generated by the
@@ -95,16 +92,12 @@ system of libraries, will be written to
\fBsyslog\fR(3).
.SH "CONFORMING TO"
.PP
-DCE\-RFC 86.0, October 1995.
-Contains additional features, but remains backwardly compatible with this RFC.
-.SH "BUGS"
-.PP
-None known.
+DCE\-RFC 86.0, October 1995. Contains additional features, but remains backwardly compatible with this RFC.
.SH "SEE ALSO"
.PP
-The three
-\fBLinux\-PAM\fR
-Guides, for
-\fBsystem administrators\fR,
-\fBmodule developers\fR, and
-\fBapplication developers\fR.
+
+\fBpam\fR(3),
+\fBpam_authenticate\fR(3),
+\fBpam_sm_setcred\fR(3),
+\fBpam_strerror\fR(3),
+\fBPAM\fR(8)