[PATCH] doc: list all settable socket options in smb.conf manpage

Uri Simchoni urisimchoni at gmail.com
Wed Jun 24 11:24:51 MDT 2015

I see what you mean. FWIW, the parameters that I found missing were
the SO_KEEPALIVE fine-tuning params, TCP_KEEPIDLE and TCP_KEEPINTVL.
On one hand they are legit (IMHO, and the documentation seems to
support it by recommending SO_KEEPALIVE over SMB keepalives), but on
the other hand they are not part of POSIX and not supported
everywhere, so listing them is not generally true. I suppose we can
have config variables HAVE_XXX and then list them in smbd -b.

On Wed, Jun 24, 2015 at 2:54 PM, Volker Lendecke
<Volker.Lendecke at sernet.de> wrote:
> On Wed, Jun 24, 2015 at 01:15:35PM +0300, Uri Simchoni wrote:
>> I thought I was missing a few useful socket options but then found out
>> they were supported but not documented in the smb.conf manpage. This
>> patch brings the code and the docs in sync (listing all
>> potentially-supported options, irrespective of OS)
> Looking at docs-xml/smbdotconf/tuning/socketoptions.xml I'm
> a bit shocked we have SNDBUF=8192 as example...
> Your patch change is obviously ok, but I'm completely unsure
> about a good wording that people should in general keep
> their hands off this. Tuning this is more black magic than
> an exact science, and I don't know if we will be able to
> ever properly document this. I'm not sure if we should not
> just remove the potential options and refer to the OS
> documentation. Maybe a testparm command could list the
> available ones in the specific situation.
> 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

More information about the samba-technical mailing list