helpers/external_acl/unix_group/ext_unix_group_acl.8

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