1ext_file_userip_acl(8) System Manager's Manual ext_file_userip_acl(8)
2
3
4
6 ext_file_userip_acl - Restrict users to certain IP addresses, using a
7 text file backend.
8
9 Version 1.0
10
12 ext_file_userip_acl [-dh] [-f file name ]
13
15 ext_file_userip_acl is an installed binary. An external helper for the
16 Squid external acl scheme.
17
18 It works by reading a pair composed by an IP address and an username on
19 STDIN and matching it against a configuration file.
20
22 -d Write debug info to stderr.
23
24 -f file Configuration file to load.
25
26 -h Display the binary help and command line syntax info using
27 stderr.
28
30 The squid.conf configuration for the external ACL should be:
31 external_acl_type type-name %SRC %LOGIN
32 /path/to/ext_file_userip_acl -f /path/to/config.file
33
34 If the helper program finds a matching username/ip in the configuration
35 file, it returns OK , otherwise it returns ERR .
36
37 The configuration file format is as follows:
38 ip_addr[/netmask] username|@group|ALL|NONE
39
40 Where ip_addr is a dotted quad format IP address, the netmask must be
41 in dotted quad format too.
42
43 When the second parameter is prefixed with an @ , the program will
44 lookup the /etc/group file entry for the specified username.
45
46 There are other two directives, ALL and NONE , which mean
47
49 This program was written by Rodrigo Campos <rodrigo@geekbunker.org>
50
51 This manual was written by Rodrigo Campos <rodrigo@geekbunker.org> Amos
52 Jeffries <amosjeffries@squid-cache.org>
53
55 * Copyright (C) 1996-2016 The Squid Software Foundation and contribuā
56 tors
57 *
58 * Squid software is distributed under GPLv2+ license and includes
59 * contributions from numerous individuals and organizations.
60 * Please see the COPYING and CONTRIBUTORS files for details.
61
62 This program and documentation is copyright to the authors named above.
63
64 Distributed under the GNU General Public License (GNU GPL) version 2 or
65 later (GPLv2+).
66
68 Questions on the usage of this program can be sent to the Squid Users
69 mailing list <squid-users@squid-cache.org>
70
72 Bug reports need to be made in English. See http://wiki.squid-
73 cache.org/SquidFaq/BugReporting for details of what you need to include
74 with your bug report.
75
76 Report bugs or bug fixes using http://bugs.squid-cache.org/
77
78 Report serious security bugs to Squid Bugs <squid-bugs@squid-cache.org>
79
80 Report ideas for new improvements to the Squid Developers mailing list
81 <squid-dev@squid-cache.org>
82
84 squid(8), GPL(7),
85 The Squid FAQ wiki http://wiki.squid-cache.org/SquidFaq
86 The Squid Configuration Manual http://www.squid-cache.org/Doc/config/
87
88
89
90 ext_file_userip_acl(8)