[Samba] Please update docs
klaus.hartnegg at blickzentrum.de
Thu Oct 10 08:56:32 MDT 2013
For me the main challenge in updating to samba 4 are docs. This was also
the case with samba 3, but 4 is a lot more challenging. I end up
spending hours testing different variants, because by reading docs I
cannot find answers, even after hours of searching.
The results of google-search are a mixture of pages for samba 3, samba
4, and some where it's unclear which version they describe.
A very frequent find is
but many things there don't match any samba version that I know. The
best strategy seems to be to avoid that URL. These pages should at least
have a note on top saying for which version of samba they were meant.
Another great difficulty is versions of man pages.
There are two directories:
Are all pages in the first of them supposed to be for Samba 4?
Some of the pages there contain a note at the bottom saying that they
are for version 3. Some contain no such info. Does this mean that the
described functionality is the same in samba 3 and samba 4? Or have
these pages just not yet been updated, and it's up to the readers to
Some pages say that they are for version 4, but which subversion? For
says it's for version 4, but it cannot be for version 4.0.10, because
the option "acl allow execute always" is missing. How often are these
web pages updated?
Also many new features aren't yet mentioned anywhere, for example I just
vfs objects = acl_xattr
is now active by default in some cases.
It's even difficult to find the basics like why kerberos, where does
samba4 store which info, how to manually interact with the internal DNS,
which packages must be installed in debian to make it work, etc.
Standard procedure seems to be to compile it yourself, that wasn't the
case with samba 3. How long do you expect will vendors like ubuntu need
until they include samba 4? Right now the authors of the ubuntu server
manual obviously haven't noticed that samba 4 exists.
More information about the samba