]> git.ipfire.org Git - thirdparty/squid.git/blobdiff - helpers/external_acl/file_userip/ext_file_userip_acl.8
Boilerplate: update copyright blurbs on Squid helpers
[thirdparty/squid.git] / helpers / external_acl / file_userip / ext_file_userip_acl.8
index 31a024186083205b091d88ff90c3699f8fda4f72..f0173739934be2450a5a2e667b4f9a2e2fb56a9c 100644 (file)
@@ -3,7 +3,7 @@
 .SH NAME
 .if !'po4a'hide' .B ext_file_userip_acl
 .if !'po4a'hide' \-
-Restrict users to cetain IP addresses, using a text file backend.
+Restrict users to certain IP addresses, using a text file backend.
 .PP
 Version 1.0
 .
@@ -17,15 +17,21 @@ file name
 .B ext_file_userip_acl
 is an installed binary. An external helper for the Squid external acl scheme.
 .PP
-It works by reading a pair composed by an ip address and an username
+It works by reading a pair composed by an IP address and an username
 on STDIN and matching it against a configuration file.
 .
 .SH OPTIONS
 .if !'po4a'hide' .TP 12
 .if !'po4a'hide' .B \-d
 Write debug info to stderr.
-.if !'po4a'hide' .B \-f
-Configuration file to load.
+.
+.if !'po4a'hide' .TP
+.if !'po4a'hide' .B \-f file
+Configuration 
+.B file 
+to load.
+.
+.if !'po4a'hide' .TP
 .if !'po4a'hide' .B \-h
 Display the binary help and command line syntax info using stderr.
 .
@@ -34,9 +40,9 @@ Display the binary help and command line syntax info using stderr.
 The 
 .B squid.conf 
 configuration for the external ACL should be:
-.if !'po4a'hide' .
-.if !'po4a'hide' external_acl_type type-name %SRC %LOGIN /path/to/ext_file_userip_acl -f /path/to/config.file
-.if !'po4a'hide' .
+.if !'po4a'hide' .RS
+.if !'po4a'hide' .B external_acl_type type-name %SRC %LOGIN /path/to/ext_file_userip_acl -f /path/to/config.file
+.if !'po4a'hide' .RE
 .PP
 If the helper program finds a matching username/ip in the configuration file, it returns
 .B OK
@@ -44,8 +50,9 @@ If the helper program finds a matching username/ip in the configuration file, it
 .B ERR .
 .PP
 The configuration file format is as follows:
-.
-ip_addr[/netmask]              username|@group|ALL|NONE
+.if !'po4a'hide' .RS
+.if !'po4a'hide' ip_addr[/netmask]     username|@group|ALL|NONE
+.if !'po4a'hide' .RE
 .PP
 Where 
 .B ip_addr 
@@ -63,7 +70,7 @@ There are other two directives,
 .B ALL 
 and 
 .B NONE 
-, which mean \"any user on this IP address may authenticate\" or \"no user on this ip address may authenticate\".
+, which mean \"any user on this IP address may authenticate\" or \"no user on this IP address may authenticate\".
 .
 .SH AUTHOR
 This program was written by
@@ -74,6 +81,13 @@ This manual was written by
 .if !'po4a'hide' .I Amos Jeffries <amosjeffries@squid-cache.org>
 .
 .SH COPYRIGHT
+.PP
+ * Copyright (C) 1996-2014 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
 This program and documentation is copyright to the authors named above.
 .PP
 Distributed under the GNU General Public License (GNU GPL) version 2 or later (GPLv2+).