Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages
ext_file_userip_acl(8) FreeBSD System Manager's Manual ext_file_userip_acl(8)

ext_file_userip_acl - Restrict users to certain IP addresses, using a text file backend.
Version 1.0

ext_file_userip_acl [-dh] [-f file name ]

ext_file_userip_acl is an installed binary. An external helper for the Squid external acl scheme.
It works by reading a pair composed by an IP address and an username on STDIN and matching it against a configuration file.

Write debug info to stderr.
-f file
Configuration file to load.
Display the binary help and command line syntax info using stderr.

The squid.conf configuration for the external ACL should be:
external_acl_type type-name %SRC %LOGIN /path/to/ext_file_userip_acl -f /path/to/config.file
If the helper program finds a matching username/ip in the configuration file, it returns OK , otherwise it returns ERR .
The configuration file format is as follows:
ip_addr[/netmask] username|@group|ALL|NONE
Where ip_addr is a dotted quad format IP address, the netmask must be in dotted quad format too.
When the second parameter is prefixed with an @ , the program will lookup the /etc/group file entry for the specified username.
There are other two directives, ALL and NONE , which mean "any user on this IP address may authenticate" or "no user on this IP address may authenticate".

This program was written by Rodrigo Campos <>
This manual was written by Rodrigo Campos <> Amos Jeffries <>

* Copyright (C) 1996-2018 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.
This program and documentation is copyright to the authors named above.
Distributed under the GNU General Public License (GNU GPL) version 2 or later (GPLv2+).

Questions on the usage of this program can be sent to the Squid Users mailing list <>

Bug reports need to be made in English. See for details of what you need to include with your bug report.
Report bugs or bug fixes using
Report serious security bugs to Squid Bugs <>
Report ideas for new improvements to the Squid Developers mailing list <>

squid(8), GPL(7),
The Squid FAQ wiki
The Squid Configuration Manual

Search for    or go to Top of page |  Section 8 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.