[[PageOutline(2-5,Contents,pullout)]]

= Trac Unix Groups plugin =

== Description ==

The !TracUnixGroups plugin allows Trac to use the Unix group membership for permissions assignment. It is especially convenient if you host multiple trac projects and want to use same groups across them without defining each group in every project.

Current implementation is not very efficient - it is invoking 'groups' command (which must be in PATH) to fetch user groups. Perhaps it could be optimized to use system calls to fetch this data.

The code is based on HtgroupsPlugin.


== Bugs/Feature Requests == 

Existing bugs and feature requests for TracUnixGroupsPlugin are 
[report:9?COMPONENT=TracUnixGroupsPlugin here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=TracUnixGroupsPlugin&owner=lord new ticket].

== Download ==

Download the zipped source from [download:tracunixgroupsplugin here].

== Source ==

You can check out TracUnixGroupsPlugin from [http://trac-hacks.org/svn/tracunixgroupsplugin here] using Subversion, or [source:tracunixgroupsplugin browse the source] with Trac.

== Example ==

  1. Add user to group 'developers' using unix 'vigr' command
  1. Use group '@developers' in track (Admin/Permissions) to assign permissions to this group members. Adding new members to this group later on will automatically give them access to these permissions in trac modules using it.

== Recent Changes ==

[[ChangeLog(tracunixgroupsplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:lord] [[BR]]
'''Maintainer:''' [wiki:lord] [[BR]]
'''Contributors:'''