Docu-patch

[Jelmer Vernooij]

On Fri, Apr 05, 2013 at 04:45:44PM +0200, Volker Lendecke wrote:
> A customer of mine was just bitten by this :-)
> 
> Please review & push.
r=me; Unfortunately I don't have access to my Samba tree here, but feel free
to push with my Reviewed-By.

Cheers,

Jelmer

> 
> Thanks,
> 
> Volker
> 
> -- 
> SerNet GmbH, Bahnhofsallee 1b, 37081 G?ttingen
> phone: +49-551-370000-0, fax: +49-551-370000-9
> AG G?ttingen, HRB 2816, GF: Dr. Johannes Loxen
> http://www.sernet.de, mailto:kontakt at sernet.de

> From ced5543ecc63553d31e0c1e87197b0fafeeb59c7 Mon Sep 17 00:00:00 2001
> From: Volker Lendecke <vl at samba.org>
> Date: Fri, 5 Apr 2013 16:44:08 +0200
> Subject: [PATCH] doc: Document performance impact of "hide unxx" parameters
> 
> Signed-off-by: Volker Lendecke <vl at samba.org>
> ---
>  docs-xml/smbdotconf/filename/hideunreadable.xml    |    3 +++
>  .../smbdotconf/filename/hideunwriteablefiles.xml   |    3 +++
>  2 files changed, 6 insertions(+)
> 
> diff --git a/docs-xml/smbdotconf/filename/hideunreadable.xml b/docs-xml/smbdotconf/filename/hideunreadable.xml
> index c2c1654..992f135 100644
> --- a/docs-xml/smbdotconf/filename/hideunreadable.xml
> +++ b/docs-xml/smbdotconf/filename/hideunreadable.xml
> @@ -5,6 +5,9 @@
>   <description>
>  	<para>This parameter prevents clients from seeing the
>  		existance of files that cannot be read. Defaults to off.</para>
> +	<para>Please note that enabling this can slow down listing large
> +	directories significantly. Samba has to evaluate the ACLs of all
> +	directory members, which can be a lot of effort.</para>
>  </description>
>  <value type="default">no</value>
>  </samba:parameter>
> diff --git a/docs-xml/smbdotconf/filename/hideunwriteablefiles.xml b/docs-xml/smbdotconf/filename/hideunwriteablefiles.xml
> index 831e8c6..6665860 100644
> --- a/docs-xml/smbdotconf/filename/hideunwriteablefiles.xml
> +++ b/docs-xml/smbdotconf/filename/hideunwriteablefiles.xml
> @@ -7,6 +7,9 @@
>      This parameter prevents clients from seeing the existance of files that cannot be written to. 
>      Defaults to off. Note that unwriteable directories are shown as usual.
>      </para>
> +    <para>Please note that enabling this can slow down listing large
> +    directories significantly. Samba has to evaluate the ACLs of all directory
> +    members, which can be a lot of effort.</para>
>  </description>
>  <value type="default">no</value>
>  </samba:parameter>
> -- 
> 1.7.9.5
> 


--