Bug 13035 - Missing documentation of "winbind:ignore domains" option
Missing documentation of "winbind:ignore domains" option
Status: NEW
Product: Samba 4.1 and newer
Classification: Unclassified
Component: Documentation
4.7.0rc5
All All
: P5 normal
: ---
Assigned To: Samba Documentation QA Contact~
Samba Documentation QA Contact~
:
Depends on:
Blocks:
  Show dependency treegraph
 
Reported: 2017-09-15 09:57 UTC by Björn Baumbach
Modified: 2017-09-15 10:51 UTC (History)
0 users

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Björn Baumbach 2017-09-15 09:57:38 UTC
The "winbind:ignore domains" smb.conf option is not documented:

source3/winbindd/winbindd_util.c:       ignored_domains = lp_parm_string_list(-1, "winbind", "ignore domains", NULL);
Comment 1 Karolin Seeger 2017-09-15 10:45:11 UTC
(In reply to Björn Baumbach from comment #0)
Usually, parametric options are not documented, because they are made for special tweaks that can do harm.
Comment 2 Björn Jacke 2017-09-15 10:51:04 UTC
On 15.09.2017 12:45, samba-bugs@samba.org wrote:
> https://bugzilla.samba.org/show_bug.cgi?id=13035
> 
> --- Comment #1 from Karolin Seeger <kseeger@samba.org> ---
> (In reply to Björn Baumbach from comment #0)
> Usually, parametric options are not documented, because they are made for
> special tweaks that can do harm.

hm, this is is what often happens but not what is supposed to be. We
have lot's of parametric options useful for many people, which are just
known by one or two people, this is a good example for that. We never
had a rule that parametric options need not to be docuemted, it was just
bad habit that this happens again and again (maybe because not even
testparm -v tells people that those options exist).