[thirdparty/squid.git] / helpers / external_acl / unix_group / squid_unix_group.8

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