7bda9154 |
1 | groupmanage(1) and user-administered groups |
2 | ------------------------------------------- |
3 | |
fe112c08 |
4 | There is a program `groupmanage', with which users can create their |
5 | own groups and change their group membership. |
7bda9154 |
6 | |
7 | For a synopsis of its usage, type `groupmanage'. |
8 | |
9 | Each group managed by groupmanage has an entry in /etc/grouplist as |
10 | well as in /etc/group. This contains the administrative information |
fe112c08 |
11 | which controls who may do what to the group, in the form: |
12 | group:description:owner:manager1,manager2,manager3:home-directory |
13 | (as many or few managers as you like). groupmanage will modify this |
14 | file as well as /etc/group |
7bda9154 |
15 | |
16 | Each group has a single owner user. The owner and managers are |
17 | allowed to add and delete managers and members; only the owner may |
18 | change the group title. Note that being a manager doesn't |
19 | automatically make you a member of a group - you must use |
20 | groupmanage --add to do that, and then log in again to ensure that the |
21 | new membership affects your session. |
22 | |
fe112c08 |
23 | There are some restrictions on groups created by users without |
24 | administrator intervention: in the default configuration the group |
25 | name must have the form <username>-<groupname>, except that if |
26 | <username> is more than 4 characters only the first 4 need be given. |
27 | All groups created by a user have that user's name in the title. Any |
28 | one user may not create more than 5 groups for themselves. |
7bda9154 |
29 | |
30 | All group names must be less than 8 characters long, and a group once |
fe112c08 |
31 | created can not easily be deleted because revoking access to a uid or |
32 | gid on unix is very hard. Groups can be renamed with assistance from |
33 | the system administrator. |
7bda9154 |
34 | |
35 | For more formal groups (for example, those corresponding to particular |
36 | organisations, or which interact with system software eg mail |
fe112c08 |
37 | delivery) should probably be created by the sysadmin on request and |
38 | need not heed these restrictions; it might also be useful to create a |
39 | home directory for shared files. |
7bda9154 |
40 | |
41 | When working with shared files, you should not remove (and should |
42 | reinstate, if necessary) the setgid bit on the shared directories, and |
43 | leave your umask set to allow group write (the default is 002). |
44 | You'll then find that you're able to work in group filespace areas |
45 | without having to ask other users to chmod files, or having to type |
46 | incantations to switch between working on shared files and your |
47 | personal files. |
48 | |
711a0748 |
49 | Copyright (C) 1999,2003 Ian Jackson |
50 | This file is part of groupmanage, part of userv-utils |
51 | |
52 | This is free software; you can redistribute it and/or modify it |
53 | under the terms of the GNU General Public License as published by |
54 | the Free Software Foundation; either version 2 of the License, or |
55 | (at your option) any later version. |
56 | |
57 | This program is distributed in the hope that it will be useful, but |
58 | WITHOUT ANY WARRANTY; without even the implied warranty of |
59 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
60 | General Public License for more details. |
61 | |
62 | You should have received a copy of the GNU General Public License |
63 | along with userv-utils; if not, write to the Free Software |
64 | Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. |
65 | |
fe112c08 |
66 | $Id$ |