1
0
mirror of https://github.com/samba-team/samba.git synced 2025-01-11 05:18:09 +03:00

s3-docs: Add more verbose description of "username map cache time".

This commit is contained in:
Volker Lendecke 2010-07-19 12:22:05 +02:00 committed by Karolin Seeger
parent a785b4349c
commit 4c0f760edf

View File

@ -4,13 +4,22 @@
type="integer"
xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description>
<para>This option controls if and how long the result of the
<smbconfoption name="username map"/> and
<smbconfoption name="username map script"/> across smbds in gencache.
If set to non-zero, it denotes the number of seconds the output of
both mappings will be cached.</para>
<para>This option is mainly useful for heavy-weight
<smbconfoption name="username map script"/> scripts.</para>
<para>
Mapping usernames with the <smbconfoption name="username map"/>
or <smbconfoption name="username map script"/>
features of Samba can be relatively expensive.
During login of a user, the mapping is done several times.
In particular, calling the <smbconfoption name="username map script"/>
can slow down logins if external databases have to be queried from
the script being called.
</para>
<para>
The parameter <smbconfoption name="username map cache time"/>
controls a mapping cache. It specifies the number of seconds a
mapping from the username map file or script is to be efficiently cached.
The default of 0 means no caching is done.
</para>
</description>
<value type="default">0</value>