SourceFormat Enforcement

[thirdparty/squid.git] / helpers / basic_auth / PAM / basic_pam_auth.8

diff --git a/helpers/basic_auth/PAM/basic_pam_auth.8 b/helpers/basic_auth/PAM/basic_pam_auth.8
index 7e1c71f165a86ea05802923e5866c930c76f69b3..ae572b6c09a4f6a7065fd7722a2713ac7935aaa4 100644 (file)
--- a/helpers/basic_auth/PAM/basic_pam_auth.8
+++ b/helpers/basic_auth/PAM/basic_pam_auth.8
@@ -1,14 +1,12 @@
 .if !'po4a'hide' .TH basic_pam_auth 8 "5 Sep 2003"
 .
 .SH NAME
-.if !'po4a'hide' .B basic_pam_auth
-.if !'po4a'hide' \-
-Squid PAM Basic authentication helper
+basic_pam_auth \- PAM Basic authentication helper for Squid
 .
 .SH SYNOPSIS
 .if !'po4a'hide' .B "basic_pam_auth [\-n \""
 service name
-.if !'po4a'hide'.B "\"] [\-t "
+.if !'po4a'hide' .B "\"] [\-t "
 TTL
 .if !'po4a'hide' .B "] [\-o] [\-1]"
 .
@@ -20,12 +18,12 @@ authentication.
 .
 .SH OPTIONS
 .if !'po4a'hide' .TP 12
-.if !'po4a'hide' .BI "\-s " "service\-name"
+.if !'po4a'hide' .B "\-s " "service\-name"
 Specifies the PAM service name Squid uses, defaults to
 .B squid
 .
 .if !'po4a'hide' .TP
-.if !'po4a'hide' .BI "\-t " TTL
+.if !'po4a'hide' .B "\-t " TTL
 Enables persistent PAM connections where the connection to the PAM
 database is kept open and reused for new logins. The TTL specifies
 how long the connection will be kept open (in seconds).  Default is
@@ -34,7 +32,7 @@ persistent PAM connections is slightly outside the PAM
 specification and may not work with all PAM configurations.
 .
 .if !'po4a'hide' .TP
-.if !'po4a'hide' .BI \-o
+.if !'po4a'hide' .B \-o
 Do not perform the PAM account management group (account
 expiration etc)
 .
@@ -45,9 +43,11 @@ or
 .BR /etc/pam.d/squid
 .PP
 The default service name is
-.B \"squid\"
+.B squid
 , and the program makes use of the
-.BR "" ' auth "' and '" account '
+.B auth
+and
+.B account
 management groups to verify the password and the accounts validity.
 .PP
 For details on how to configure PAM services, see the PAM
@@ -63,9 +63,9 @@ program is not recommended, but if you absolutely need to then make
 the program setuid root
 .if !'po4a'hide' .RS
 .if !'po4a'hide' .P
-.if !'po4a'hide' .B chown root pam_auth
+.if !'po4a'hide' .B chown root basic_pam_auth
 .if !'po4a'hide' .br
-.if !'po4a'hide' .B chmod u+s pam_auth
+.if !'po4a'hide' .B chmod u+s basic_pam_auth
 .if !'po4a'hide' .RE
 .PP
 Please note that in such configurations it is also strongly recommended
@@ -80,12 +80,19 @@ This program and documentation was written by
 .if !'po4a'hide' .I Henrik Nordstrom <hno@squid-cache.org>
 .
 .SH COPYRIGHT
+.PP
+ * Copyright (C) 1996-2015 The Squid Software Foundation and contributors
+ *
+ * Squid software is distributed under GPLv2+ license and includes
+ * contributions from numerous individuals and organizations.
+ * Please see the COPYING and CONTRIBUTORS files for details.
+.PP
 Squid
 .B basic_pam_auth
 and this manual is Copyright 1999,2002,2003
 .if !'po4a'hide' .I Henrik Nordstrom <hno@squid-cache.org>
 .
-Distributed under the GNU General Public License (GNU GPL) version 2 or later (GPL2+).
+Distributed under the GNU General Public License (GNU GPL) version 2 or later (GPLv2+).
 .
 .SH QUESTIONS
 Questions on the usage of this program can be sent to the
@@ -93,6 +100,9 @@ Questions on the usage of this program can be sent to the
 .if !'po4a'hide' <squid-users@squid-cache.org>
 .
 .SH REPORTING BUGS
+Bug reports need to be made in English.
+See http://wiki.squid-cache.org/SquidFaq/BugReporting for details of what you need to include with your bug report.
+.PP
 Report bugs or bug fixes using http://bugs.squid-cache.org/
 .PP
 Report serious security bugs to
@@ -104,9 +114,17 @@ Report ideas for new improvements to the
 .
 .SH SEE ALSO
 .if !'po4a'hide' .BR squid "(8), "
-.if !'po4a'hide' .BR pam "(8), "
+.if !'po4a'hide' .BR pam "(3), "
 .if !'po4a'hide' .BR pam.conf "(5), "
 .if !'po4a'hide' .BR chown "(1), "
 .if !'po4a'hide' .BR chmod "(1), "
+.if !'po4a'hide' .BR GPL "(7), "
 .br
 PAM Systems Administrator Guide
+.br
+The Squid FAQ wiki
+.if !'po4a'hide' http://wiki.squid-cache.org/SquidFaq
+.br
+The Squid Configuration Manual
+.if !'po4a'hide' http://www.squid-cache.org/Doc/config/
+