summaryrefslogtreecommitdiff
path: root/docs-xml/manpages/idmap_script.8.xml
diff options
context:
space:
mode:
authorVolker Lendecke <vl@samba.org>2016-03-31 17:10:39 +0200
committerJeremy Allison <jra@samba.org>2016-03-31 23:57:13 +0200
commit10054c4281d73652b641921b756eaaae14964e6b (patch)
tree37ec488b3d5914c35eeb3933f5badaa26508e475 /docs-xml/manpages/idmap_script.8.xml
parent74f0a2435b6f26135bfb4c25d297af5b2cc436c8 (diff)
downloadsamba-10054c4281d73652b641921b756eaaae14964e6b.tar.gz
docs: Mention _NO_WINBINDD in idmap_script.8
Thanks to Joachim Achtzehnter <joachima@netacquire.com> for pointing out this flaw! Signed-off-by: Volker Lendecke <vl@samba.org> Reviewed-by: Jeremy Allison <jra@samba.org> Autobuild-User(master): Jeremy Allison <jra@samba.org> Autobuild-Date(master): Thu Mar 31 23:57:13 CEST 2016 on sn-devel-144
Diffstat (limited to 'docs-xml/manpages/idmap_script.8.xml')
-rw-r--r--docs-xml/manpages/idmap_script.8.xml18
1 files changed, 18 insertions, 0 deletions
diff --git a/docs-xml/manpages/idmap_script.8.xml b/docs-xml/manpages/idmap_script.8.xml
index a378e7ba30d..328a16bfd2d 100644
--- a/docs-xml/manpages/idmap_script.8.xml
+++ b/docs-xml/manpages/idmap_script.8.xml
@@ -148,6 +148,24 @@
look up the mapping in a table or use some other mechanism for
mapping SIDs to UIDs and etc.
</para>
+
+ <para>
+ Please be aware that the script is called with the
+ _NO_WINBINDD environment variable set to 1. This prevents
+ recursive calls into winbind from the script both via
+ explicit calls to wbinfo and via implicit calls via
+ nss_winbind. For example a call to <command>ls -l</command>
+ could trigger such an infinite recursion.
+ </para>
+
+ <para>
+ It is safe to call <command>wbinfo -n</command> and
+ <command>wbinfo -s</command> from within an idmap script. To
+ do so, the script must unset the _NO_WINBINDD environment
+ variable right before the call to <command>wbinfo</command>
+ and set it to 1 again right after <command>wbinfo</command>
+ has returned to protect against the recursion.
+ </para>
</refsect1>
<refsect1>