summaryrefslogtreecommitdiff
path: root/Linux-PAM/modules/pam_ftp/pam_ftp.8
diff options
context:
space:
mode:
Diffstat (limited to 'Linux-PAM/modules/pam_ftp/pam_ftp.8')
-rw-r--r--Linux-PAM/modules/pam_ftp/pam_ftp.878
1 files changed, 44 insertions, 34 deletions
diff --git a/Linux-PAM/modules/pam_ftp/pam_ftp.8 b/Linux-PAM/modules/pam_ftp/pam_ftp.8
index 0c730267..e07c9885 100644
--- a/Linux-PAM/modules/pam_ftp/pam_ftp.8
+++ b/Linux-PAM/modules/pam_ftp/pam_ftp.8
@@ -1,84 +1,94 @@
.\" Title: pam_ftp
.\" Author:
-.\" Generator: DocBook XSL Stylesheets v1.70.1 <http://docbook.sf.net/>
-.\" Date: 06/09/2006
-.\" Manual: Linux\-PAM Manual
-.\" Source: Linux\-PAM Manual
+.\" Generator: DocBook XSL Stylesheets v1.73.1 <http://docbook.sf.net/>
+.\" Date: 01/08/2008
+.\" Manual: Linux-PAM Manual
+.\" Source: Linux-PAM Manual
.\"
-.TH "PAM_FTP" "8" "06/09/2006" "Linux\-PAM Manual" "Linux\-PAM Manual"
+.TH "PAM_FTP" "8" "01/08/2008" "Linux-PAM Manual" "Linux\-PAM Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.SH "NAME"
-pam_ftp \- PAM module for anonymous access module
+pam_ftp - PAM module for anonymous access module
.SH "SYNOPSIS"
.HP 11
-\fBpam_ftp.so\fR [debug] [ignore] [users=\fIXXX,YYY,\fR...]
+\fBpam_ftp\.so\fR [debug] [ignore] [users=\fIXXX,YYY,\fR...]
.SH "DESCRIPTION"
.PP
-pam_ftp is a PAM module which provides a pluggable anonymous ftp mode of access.
+pam_ftp is a PAM module which provides a pluggable anonymous ftp mode of access\.
.PP
-This module intercepts the user's name and password. If the name is
+This module intercepts the user\'s name and password\. If the name is
\fIftp\fR
or
-\fIanonymous\fR, the user's password is broken up at the
+\fIanonymous\fR, the user\'s password is broken up at the
\fI@\fR
delimiter into a
\fIPAM_RUSER\fR
and a
\fIPAM_RHOST\fR
-part; these pam\-items being set accordingly. The username (\fIPAM_USER\fR) is set to
-\fIftp\fR. In this case the module succeeds. Alternatively, the module sets the
+part; these pam\-items being set accordingly\. The username (\fIPAM_USER\fR) is set to
+\fIftp\fR\. In this case the module succeeds\. Alternatively, the module sets the
\fIPAM_AUTHTOK\fR
-item with the entered password and fails.
+item with the entered password and fails\.
.PP
-This module is not safe and easily spoofable.
+This module is not safe and easily spoofable\.
.SH "OPTIONS"
.PP
-.TP 3n
+.PP
\fBdebug\fR
-Print debug information.
-.TP 3n
+.RS 4
+Print debug information\.
+.RE
+.PP
\fBignore\fR
-Pay no attention to the email address of the user (if supplied).
-.TP 3n
-\fBftp=\fR\fB\fIXXX,YYY,...\fR\fR
+.RS 4
+Pay no attention to the email address of the user (if supplied)\.
+.RE
+.PP
+\fBftp=\fR\fB\fIXXX,YYY,\.\.\.\fR\fR
+.RS 4
Instead of
\fIftp\fR
or
\fIanonymous\fR, provide anonymous login to the comma separated list of users:
-\fB\fIXXX,YYY,...\fR\fR. Should the applicant enter one of these usernames the returned username is set to the first in the list:
-\fIXXX\fR.
+\fB\fIXXX,YYY,\.\.\.\fR\fR\. Should the applicant enter one of these usernames the returned username is set to the first in the list:
+\fIXXX\fR\.
+.RE
.SH "MODULE SERVICES PROVIDED"
.PP
Only the
\fBauth\fR
-service is supported.
+service is supported\.
.SH "RETURN VALUES"
.PP
-.TP 3n
+.PP
PAM_SUCCESS
-The authentication was successfull.
-.TP 3n
+.RS 4
+The authentication was successfull\.
+.RE
+.PP
PAM_USER_UNKNOWN
-User not known.
+.RS 4
+User not known\.
+.RE
.SH "EXAMPLES"
.PP
Add the following line to
-\fI/etc/pam.d/ftpd\fR
+\fI/etc/pam\.d/ftpd\fR
to handle ftp style anonymous login:
.sp
-.RS 3n
+.RS 4
.nf
#
-# ftpd; add ftp\-specifics. These lines enable anonymous ftp over
+# ftpd; add ftp\-specifics\. These lines enable anonymous ftp over
# standard UN*X access (the listfile entry blocks access to
# users listed in /etc/ftpusers)
#
-auth sufficient pam_ftp.so
-auth required pam_unix.so use_first_pass
-auth required pam_listfile.so \\
+auth sufficient pam_ftp\.so
+auth required pam_unix\.so use_first_pass
+auth required pam_listfile\.so \e
onerr=succeed item=user sense=deny file=/etc/ftpusers
.fi
@@ -92,4 +102,4 @@ auth required pam_listfile.so \\
\fBpam\fR(8)
.SH "AUTHOR"
.PP
-pam_ftp was written by Andrew G. Morgan <morgan@kernel.org>.
+pam_ftp was written by Andrew G\. Morgan <morgan@kernel\.org>\.