]> git.ipfire.org Git - thirdparty/squid.git/blame - helpers/external_acl/unix_group/squid_unix_group.8
Updated UNIX group helper
[thirdparty/squid.git] / helpers / external_acl / unix_group / squid_unix_group.8
CommitLineData
6328cedc 1.TH squid_unix_group 8 "12 August 2002" "Squid UNIX Group helper"
2.
3.SH NAME
4squid_unix_group - Squid UNIX Group external_acl helper
5.
6.SH SYNOPSIS
7squid_unix_group [-g groupname] [-g groupname...] [-p]
8.
9.SH DESCRIPTION
10This helper allows Squid to base access controls on users
11memberships in UNIX groups.
12.
13.TP
14.BI "-g " "groupname "
15Specifies a group name to match.
16.
17.TP
18.BI "-p"
19Also match the users primary group from /etc/passwd
20.
21.SH EXAMPLES
22.
23This squid.conf example defines two Squid acls. usergroup1 matches users in group1, and usergroup2
24matches users in group2 or group3
25.IP
26external_acl_type unix_group %LOGIN /usr/local/squid/libexec/squid_unix_group -p
27.IP
28acl usergroup1 external unix_group group1
29.IP
30acl usergroup2 external unix_group group2 group3
31.
32.SH NOTES
33.
34By default up to 11 groups can be matched in one acl (including commandline specified
35groups). This limit is defined by MAX_GROUPS in the source code.
36.
37.SH AUTHOR
38This manual page was written by
39.I Henrik Nordstrom <hno@squid-cache.org>
40.P
41squid_unix_group is written by
42.I Rodrigo Campos <rodrigo@geekbunker.org>
43.
44.SH KNOWN ISSUES
45Does not understand gid aliased groups sometimes used to work around groups size
46limitations. If you are using gid aliased groups then you must specify each alias
47by name.
48.
49.SH QUESTIONS
50Any questions on usage can be sent to
51.IR "Squid Users <squid-users@squid-cache.org>"
52.
53.SH REPORTING BUGS
54Report bugs or bug-fixes to
55.I Rodrigo Campos <rodrigo@geekbunker.org>
56or
57.I Squid Developers <squid-dev@squid-cache.org>
58.
59.SH "SEE ALSO"
60.BR group ( 5 ), passwd ( 5 )