1 .if !'po4a'hide' .TH ext_file_userip_acl 8
4 ext_file_userip_acl \- Restrict users to certain IP addresses, using a text file backend.
9 .if !'po4a'hide' .B ext_file_userip_acl
10 .if !'po4a'hide' .B [\-dh] [\-f
15 .B ext_file_userip_acl
16 is an installed binary. An external helper for the Squid external acl scheme.
18 It works by reading a pair composed by an IP address and an username
19 on STDIN and matching it against a configuration file.
22 .if !'po4a'hide' .TP 12
23 .if !'po4a'hide' .B \-d
24 Write debug info to stderr.
27 .if !'po4a'hide' .B \-f file
33 .if !'po4a'hide' .B \-h
34 Display the binary help and command line syntax info using stderr.
40 configuration for the external ACL should be:
42 .if !'po4a'hide' .B external_acl_type type-name %SRC %LOGIN /path/to/ext_file_userip_acl -f /path/to/config.file
45 If the helper program finds a matching username/ip in the configuration file, it returns
47 , otherwise it returns
50 The configuration file format is as follows:
52 .if !'po4a'hide' ip_addr[/netmask] username|@group|ALL|NONE
57 is a dotted quad format IP address, the
59 must be in dotted quad format too.
61 When the second parameter is prefixed with an
63 , the program will lookup the
65 file entry for the specified username.
67 There are other two directives,
71 , which mean \"any user on this IP address may authenticate\" or \"no user on this IP address may authenticate\".
74 This program was written by
75 .if !'po4a'hide' .I Rodrigo Campos <rodrigo@geekbunker.org>
77 This manual was written by
78 .if !'po4a'hide' .I Rodrigo Campos <rodrigo@geekbunker.org>
79 .if !'po4a'hide' .I Amos Jeffries <amosjeffries@squid-cache.org>
83 * Copyright (C) 1996-2016 The Squid Software Foundation and contributors
85 * Squid software is distributed under GPLv2+ license and includes
86 * contributions from numerous individuals and organizations.
87 * Please see the COPYING and CONTRIBUTORS files for details.
89 This program and documentation is copyright to the authors named above.
91 Distributed under the GNU General Public License (GNU GPL) version 2 or later (GPLv2+).
94 Questions on the usage of this program can be sent to the
95 .I Squid Users mailing list
96 .if !'po4a'hide' <squid-users@squid-cache.org>
99 Bug reports need to be made in English.
100 See http://wiki.squid-cache.org/SquidFaq/BugReporting for details of what you need to include with your bug report.
102 Report bugs or bug fixes using http://bugs.squid-cache.org/
104 Report serious security bugs to
105 .I Squid Bugs <squid-bugs@squid-cache.org>
107 Report ideas for new improvements to the
108 .I Squid Developers mailing list
109 .if !'po4a'hide' <squid-dev@squid-cache.org>
112 .if !'po4a'hide' .BR squid "(8), "
113 .if !'po4a'hide' .BR GPL "(7), "
116 .if !'po4a'hide' http://wiki.squid-cache.org/SquidFaq
118 The Squid Configuration Manual
119 .if !'po4a'hide' http://www.squid-cache.org/Doc/config/