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        * 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

QUESTIONS

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

REPORTING BUGS

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

SEE ALSO

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)
Impressum