.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
.
.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.
.
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
.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
.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
.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+).