summaryrefslogtreecommitdiff
path: root/docs/smbdotconf/filename/mapreadonly.xml
blob: b223da1afe748f9c4c8f19f1d12f7450fbbc761f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
<samba:parameter name="map read only"
                 context="S"
				 type="enum"
                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description>
	<para>
	This controls how the DOS read only attribute should be
	mapped.
	</para>

	<para>
	This parameter can take three different values, which tell <citerefentry><refentrytitle>smbd</refentrytitle>
	<manvolnum>8</manvolnum></citerefentry> how to display the read only attribute on files, where either
	<smbconfoption name="store dos attributes"/> is set to <constant>No</constant>, or no extended attribute is
	present.
	</para>

    <para>The three settings are :</para>

    <itemizedlist>
		<listitem><para>
		<constant>Yes</constant> - The read only DOS attribute is mapped to the inverse of the user
		write bit in the unix permission mode
		</para></listitem>

		<listitem><para>
		<constant>Permissions</constant> - The read only DOS attribute is mapped to the effective permissions of
		the connecting user, as evaluated by <citerefentry><refentrytitle>smbd</refentrytitle>
		<manvolnum>8</manvolnum></citerefentry> by reading the unix permissions and POSIX ACL (if present).
		</para></listitem>

		<listitem><para>
		<constant>No</constant> - The read only DOS attribute is unaffected by permissions, and can only be set by
		the <smbconfoption name="store dos attributes"/> method.  This may be useful for exporting mounted CDs.
		</para></listitem>
    </itemizedlist>

</description>
<value type="default">yes</value>
</samba:parameter>