diff options
author | Rob Crittenden <rcritten@redhat.com> | 2010-06-02 14:08:50 -0400 |
---|---|---|
committer | Rob Crittenden <rcritten@redhat.com> | 2010-06-22 13:58:04 -0400 |
commit | 901ccc1393a7e494f7b1b64eaeb2f7809056aafa (patch) | |
tree | b9523a814ed72e08ac286134bb45cf07e6e053f4 /ipalib/plugins/group.py | |
parent | 8c6c93125f344ca117cc24b2e96c55b1d9ae31bd (diff) | |
download | freeipa-901ccc1393a7e494f7b1b64eaeb2f7809056aafa.tar.gz freeipa-901ccc1393a7e494f7b1b64eaeb2f7809056aafa.tar.xz freeipa-901ccc1393a7e494f7b1b64eaeb2f7809056aafa.zip |
First pass at per-command documentation
Diffstat (limited to 'ipalib/plugins/group.py')
-rw-r--r-- | ipalib/plugins/group.py | 39 |
1 files changed, 39 insertions, 0 deletions
diff --git a/ipalib/plugins/group.py b/ipalib/plugins/group.py index 296366f6d..0f3743784 100644 --- a/ipalib/plugins/group.py +++ b/ipalib/plugins/group.py @@ -19,6 +19,45 @@ # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA """ Groups of users + +Manage groups of users. By default new groups are not Posix groups. +You can mark it as Posix at creation time with the --posix flag and +can promose a non-Posix group using the --posix flag in group-mod. +Once a group is a Posix group there is no way to undo this. + +Every group must have a description. + +Posix groups must have a group id number (gid). Changing a gid is +supported but can have impact on your file permissions. + +EXAMPLES: + + Add a new group: + ipa group-add --desc='local administrators' localadmins + + Add a new posix group: + ipa group-add --posix --desc='remote administrators' remoteadmins + + Promote a non-posix group to posix: + ipa group-mod --posix localadmins + + Create a group with a specific group ID number" + ipa group-add --posix --gid=500 --desc='unix admins' unixadmins + + Remove a group: + ipa group-del unixadmins + + Manage group membership, nested groups: + ipa group-add-member --groups=remoteadmins localadmins + + Manage group membership, users: + ipa group-add-member --users=test1,test2 localadmins + + Manage group membership, users: + ipa group-remove-member --users=test2 localadmins + + Show a group: + ipa group-show localadmins """ from ipalib import api |