| 1 | <samba:parameter name="force group"
|
|---|
| 2 | context="S"
|
|---|
| 3 | type="string"
|
|---|
| 4 | xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
|
|---|
| 5 | <synonym>group</synonym>
|
|---|
| 6 | <description>
|
|---|
| 7 | <para>This specifies a UNIX group name that will be
|
|---|
| 8 | assigned as the default primary group for all users connecting
|
|---|
| 9 | to this service. This is useful for sharing files by ensuring
|
|---|
| 10 | that all access to files on service will use the named group for
|
|---|
| 11 | their permissions checking. Thus, by assigning permissions for this
|
|---|
| 12 | group to the files and directories within this service the Samba
|
|---|
| 13 | administrator can restrict or allow sharing of these files.</para>
|
|---|
| 14 |
|
|---|
| 15 | <para>In Samba 2.0.5 and above this parameter has extended
|
|---|
| 16 | functionality in the following way. If the group name listed here
|
|---|
| 17 | has a '+' character prepended to it then the current user accessing
|
|---|
| 18 | the share only has the primary group default assigned to this group
|
|---|
| 19 | if they are already assigned as a member of that group. This allows
|
|---|
| 20 | an administrator to decide that only users who are already in a
|
|---|
| 21 | particular group will create files with group ownership set to that
|
|---|
| 22 | group. This gives a finer granularity of ownership assignment. For
|
|---|
| 23 | example, the setting <filename moreinfo="none">force group = +sys</filename> means
|
|---|
| 24 | that only users who are already in group sys will have their default
|
|---|
| 25 | primary group assigned to sys when accessing this Samba share. All
|
|---|
| 26 | other users will retain their ordinary primary group.</para>
|
|---|
| 27 |
|
|---|
| 28 | <para>
|
|---|
| 29 | If the <smbconfoption name="force user"/> parameter is also set the group specified in
|
|---|
| 30 | <parameter moreinfo="none">force group</parameter> will override the primary group
|
|---|
| 31 | set in <parameter moreinfo="none">force user</parameter>.</para>
|
|---|
| 32 |
|
|---|
| 33 | </description>
|
|---|
| 34 |
|
|---|
| 35 | <related>force user</related>
|
|---|
| 36 |
|
|---|
| 37 | <value type="default"/>
|
|---|
| 38 | <value type="example">agroup</value>
|
|---|
| 39 | </samba:parameter>
|
|---|