---
name: "squid_unix_group"
section: "8"
platform: "linux"
package: "squid"
version: "2.7.STABLE9-4.1+deb7u1"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/squid_unix_group"
---

# squid\_unix\_group(8)

Squid UNIX Group external\_acl helper

## NAME

squid\_unix\_group - Squid UNIX Group external\_acl helper

## SYNOPSIS

squid\_unix\_group \[-g groupname\] \[-g groupname...\] \[-p\] \[-s\]

## DESCRIPTION

This helper allows Squid to base access controls on users memberships in UNIX groups.

- **-g** *groupname*

  Specifies a group name to match.

- **-p**

  Also match the users primary group from /etc/passwd

- **-s**

  Strip NT domain name component from user names (/ or \\ separated)

## EXAMPLES

This squid.conf example defines two Squid acls. usergroup1 matches users in group1, and usergroup2 matches users in group2 or group3

-

  external\_acl\_type unix\_group %LOGIN /usr/local/squid/libexec/squid\_unix\_group -p

-

  acl usergroup1 external unix\_group group1

-

  acl usergroup2 external unix\_group group2 group3

## 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.

## AUTHOR

This manual page was written by  *Henrik Nordstrom \<hno@squid-cache.org\>*

squid\_unix\_group is written by  *Rodrigo Campos \<rodrigo@geekbunker.org\>*

## 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.

## QUESTIONS

Any questions on usage can be sent to  *Squid Users \<squid-users@squid-cache.org\>*

## REPORTING BUGS

Report bugs or bug-fixes to *Rodrigo Campos \<rodrigo@geekbunker.org\>* or  *Squid Developers \<squid-dev@squid-cache.org\>*

## SEE ALSO

**group**(**5**),**passwd**(**5**)