Bug 13035 - Missing documentation of "winbind:ignore domains" option
Summary: Missing documentation of "winbind:ignore domains" option
Status: RESOLVED FIXED
Alias: None
Product: Samba 4.1 and newer
Classification: Unclassified
Component: Documentation (show other bugs)
Version: 4.7.0rc5
Hardware: All All
: P5 normal (vote)
Target Milestone: ---
Assignee: Samba Documentation QA Contact~
QA Contact: Samba Documentation QA Contact~
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2017-09-15 09:57 UTC by Björn Baumbach
Modified: 2021-01-12 13:19 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).
Comment 3 Rowland Penny 2021-01-12 13:19:25 UTC
Closing this, the parameter was added to 'man smb.conf' before this 'bug' was reported. See this thread: https://lists.samba.org/archive/samba-technical/2017-January/118158.html