1
0
mirror of https://github.com/samba-team/samba.git synced 2025-01-08 21:18:16 +03:00

docs-xml: add 'vfs mkdir use tmp name' option

BUG: https://bugzilla.samba.org/show_bug.cgi?id=15693

Signed-off-by: Stefan Metzmacher <metze@samba.org>
Reviewed-by: Ralph Boehme <slow@samba.org>
This commit is contained in:
Stefan Metzmacher 2024-08-09 11:08:17 +02:00
parent f8be83a0a3
commit 460e280d3a
3 changed files with 50 additions and 0 deletions

View File

@ -0,0 +1,47 @@
<samba:parameter name="vfs mkdir use tmp name"
context="S"
type="enum"
enumlist="enum_bool_auto"
xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description>
<para>
Creating a new directory for an SMB client is a very complex task!
It includes things like inheriting permissions from the parent directory
and storing DOS attributes.
</para>
<para>
Other clients should not see the existence of the directory that
is in progress of being created!
</para>
<para>
This option is an enumerated type that controls the usage of a temporary directory name.
When this is set to <constant>yes</constant>,
the directory name will be prefixed with '.::TMPNAME:D:$SERVERID:' (where $SERVERID is
a unique identifier for the current process).
</para>
<para>
When this option is set to Auto (the default), the server uses a temporary directory name
if, at least, one of the following options
is effectively not set to <constant>no</constant>:
<smbconfoption name="inherit acls"/>,
<smbconfoption name="inherit owner"/>,
<smbconfoption name="inherit permissions"/>,
<smbconfoption name="nt acl support"/> or
<smbconfoption name="store dos attributes"/>.
</para>
<para>
A re-export of an SMB/CIFS mount might one rare case where
<command moreinfo="none">vfs mkdir use tmp name = no</command> could be useful.
</para>
<para>
In most cases <command moreinfo="none">vfs mkdir use tmp name = Auto</command> should be kept.
</para>
</description>
<value type="default">Auto</value>
</samba:parameter>

View File

@ -3095,6 +3095,8 @@ struct loadparm_context *loadparm_init(TALLOC_CTX *mem_ctx)
lpcfg_do_global_parameter(lp_ctx, "store dos attributes", "yes");
lpcfg_do_global_parameter(lp_ctx, "vfs mkdir use tmp name", "Auto");
lpcfg_do_global_parameter(lp_ctx, "debug encryption", "no");
lpcfg_do_global_parameter(lp_ctx, "spotlight backend", "noindex");

View File

@ -162,6 +162,7 @@ static const struct loadparm_service _sDefault =
.volume = NULL,
.fstype = NULL,
.vfs_objects = NULL,
.vfs_mkdir_use_tmp_name = Auto,
.msdfs_proxy = NULL,
.aio_write_behind = NULL,
.dfree_command = NULL,