1ext_file_userip_acl(8)      System Manager's Manual     ext_file_userip_acl(8)
2
3
4

NAME

6       ext_file_userip_acl  -  Restrict users to certain IP addresses, using a
7       text file backend.
8
9       Version 1.0
10

SYNOPSIS

12       ext_file_userip_acl [-dh] [-f file name ]
13

DESCRIPTION

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

OPTIONS

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

CONFIGURATION

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

AUTHOR

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       This program and documentation is copyright to the authors named above.
56
57       Distributed under the GNU General Public License (GNU GPL) version 2 or
58       later (GPLv2+).
59

QUESTIONS

61       Questions  on  the usage of this program can be sent to the Squid Users
62       mailing list <squid-users@squid-cache.org>
63

REPORTING BUGS

65       Bug reports  need  to  be  made  in  English.   See  http://wiki.squid-
66       cache.org/SquidFaq/BugReporting for details of what you need to include
67       with your bug report.
68
69       Report bugs or bug fixes using http://bugs.squid-cache.org/
70
71       Report serious security bugs to Squid Bugs <squid-bugs@squid-cache.org>
72
73       Report ideas for new improvements to the Squid Developers mailing  list
74       <squid-dev@squid-cache.org>
75

SEE ALSO

77       squid(8), GPL(7),
78       The Squid FAQ wiki http://wiki.squid-cache.org/SquidFaq
79       The Squid Configuration Manual http://www.squid-cache.org/Doc/config/
80
81
82
83                                                        ext_file_userip_acl(8)
Impressum