]>
Commit | Line | Data |
---|---|---|
c152a447 | 1 | .if !'po4a'hide' .TH ext_unix_group_acl 8 "12 August 2002" |
6328cedc | 2 | . |
3 | .SH NAME | |
d632afde | 4 | ext_unix_group_acl \- Squid UNIX Group ACL helper |
6328cedc | 5 | . |
6 | .SH SYNOPSIS | |
c152a447 | 7 | .if !'po4a'hide' .B "ext_unix_group_acl [\-d] [\-g " |
92a0c1e0 | 8 | group |
83915266 | 9 | .if !'po4a'hide' .B "] [\-g " |
92a0c1e0 | 10 | group |
c152a447 | 11 | .if !'po4a'hide' .B " ...] [\-p] [\-s]" |
6328cedc | 12 | . |
13 | .SH DESCRIPTION | |
c152a447 | 14 | .B ext_unix_group_acl |
83915266 | 15 | allows Squid to base access controls on users memberships in UNIX groups. |
6328cedc | 16 | . |
83915266 AJ |
17 | .SH OPTIONS |
18 | .if !'po4a'hide' .TP | |
c152a447 AJ |
19 | .if !'po4a'hide' .BI "\-d " |
20 | Write debug info to stderr. | |
21 | . | |
92a0c1e0 | 22 | .if !'po4a'hide' .BI "\-g " "group " |
6328cedc | 23 | Specifies a group name to match. |
24 | . | |
83915266 AJ |
25 | .if !'po4a'hide' .TP |
26 | .if !'po4a'hide' .BI \-p | |
27 | Also match the users primary group from | |
28 | .B /etc/passwd | |
6328cedc | 29 | . |
83915266 AJ |
30 | .if !'po4a'hide' .TP |
31 | .if !'po4a'hide' .BI \-s | |
42aa79b5 | 32 | Strip NT domain name component from user names (/ or \\ separated) |
33 | . | |
83915266 AJ |
34 | .SH CONFIGURATION |
35 | This | |
36 | .B squid.conf | |
37 | example defines two Squid acls. | |
38 | .I usergroup1 | |
39 | matches users in | |
40 | .I group1 | |
41 | , and | |
42 | .I usergroup2 | |
43 | matches users in | |
44 | .I group2 | |
45 | or | |
46 | .I group3 | |
06fcded4 | 47 | . |
83915266 | 48 | .if !'po4a'hide' .RS |
06fcded4 AJ |
49 | .if !'po4a'hide' .B external_acl_type unix_group %LOGIN /usr/local/squid/libexec/ext_unix_group_acl -p |
50 | .if !'po4a'hide' .br | |
51 | .if !'po4a'hide' .B acl usergroup1 external unix_group group1 | |
52 | .if !'po4a'hide' .br | |
53 | .if !'po4a'hide' .B acl usergroup2 external unix_group group2 group3 | |
83915266 AJ |
54 | .if !'po4a'hide' .RE |
55 | .PP | |
06fcded4 | 56 | By default up to 11 groups can be matched in one acl (including commandline specified groups). This limit is defined by |
83915266 AJ |
57 | .B MAX_GROUPS |
58 | in the source code. | |
6328cedc | 59 | . |
60 | .SH KNOWN ISSUES | |
06fcded4 | 61 | .PP |
83915266 AJ |
62 | Does not understand GID aliased groups sometimes used to work around groups size |
63 | limitations. If you are using GID aliased groups then you must specify each alias | |
6328cedc | 64 | by name. |
65 | . | |
83915266 AJ |
66 | .SH AUTHOR |
67 | This program was written by | |
68 | .if !'po4a'hide' .I Rodrigo Campos <rodrigo@geekbunker.org> | |
69 | .PP | |
70 | This manual was written by | |
71 | .if !'po4a'hide' .I Henrik Nordstrom <hno@squid-cache.org> | |
72 | . | |
73 | .SH COPYRIGHT | |
ca02e0ec | 74 | .PP |
b8ae064d | 75 | * Copyright (C) 1996-2023 The Squid Software Foundation and contributors |
ca02e0ec AJ |
76 | * |
77 | * Squid software is distributed under GPLv2+ license and includes | |
78 | * contributions from numerous individuals and organizations. | |
79 | * Please see the COPYING and CONTRIBUTORS files for details. | |
80 | .PP | |
83915266 AJ |
81 | This program and documentation is copyright to the authors named above. |
82 | .PP | |
c871f41e | 83 | Distributed under the GNU General Public License (GNU GPL) version 2 or later (GPLv2+). |
83915266 | 84 | . |
6328cedc | 85 | .SH QUESTIONS |
83915266 AJ |
86 | Questions on the usage of this program can be sent to the |
87 | .I Squid Users mailing list | |
8311b837 | 88 | .if !'po4a'hide' <squid-users@lists.squid-cache.org> |
6328cedc | 89 | . |
90 | .SH REPORTING BUGS | |
c871f41e | 91 | Bug reports need to be made in English. |
7409131e | 92 | See https://wiki.squid-cache.org/SquidFaq/BugReporting for details of what you need to include with your bug report. |
c871f41e | 93 | .PP |
672d2a73 | 94 | Report bugs or bug fixes using https://bugs.squid-cache.org/ |
83915266 AJ |
95 | .PP |
96 | Report serious security bugs to | |
8311b837 | 97 | .I Squid Bugs <squid-bugs@lists.squid-cache.org> |
83915266 AJ |
98 | .PP |
99 | Report ideas for new improvements to the | |
100 | .I Squid Developers mailing list | |
8311b837 | 101 | .if !'po4a'hide' <squid-dev@lists.squid-cache.org> |
83915266 | 102 | .PP |
92a0c1e0 | 103 | Additionally bugs or bug\-fixes can be reported to |
83915266 | 104 | .if !'po4a'hide' .I Rodrigo Campos <rodrigo@geekbunker.org> |
6328cedc | 105 | . |
83915266 AJ |
106 | .SH SEE ALSO |
107 | .if !'po4a'hide' .BR squid "(8), " | |
108 | .if !'po4a'hide' .BR group "(5), " | |
6d5cbee6 AJ |
109 | .if !'po4a'hide' .BR passwd "(5), " |
110 | .if !'po4a'hide' .BR GPL "(7), " | |
111 | .br | |
112 | The Squid FAQ wiki | |
7409131e | 113 | .if !'po4a'hide' https://wiki.squid-cache.org/SquidFaq |
6d5cbee6 AJ |
114 | .br |
115 | The Squid Configuration Manual | |
116 | .if !'po4a'hide' http://www.squid-cache.org/Doc/config/ |