Bug 12514 - name resolve order documentation seems incomplete
Summary: name resolve order documentation seems incomplete
Status: RESOLVED INVALID
Alias: None
Product: Samba 4.1 and newer
Classification: Unclassified
Component: Documentation (show other bugs)
Version: 4.4.2
Hardware: All All
: P5 normal (vote)
Target Milestone: ---
Assignee: Douglas Bagnall
QA Contact: Samba Documentation QA Contact~
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2017-01-13 04:41 UTC by Matthieu Patou
Modified: 2025-05-24 05:55 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 Matthieu Patou 2017-01-13 04:41:50 UTC
Looking at docs-xml/smbdotconf/protocol/nameresolveorder.xml and also at the generated man pages it seems that name resolve order option supports:

* lmhosts
* host
* wins
* bcast

But when looking at source3/libsmb/namequery.c in the function get_dc_list it seems that we support kdc and ads parameters as well but they are not documented.
Comment 1 Douglas Bagnall 2025-05-24 05:55:25 UTC
I think this is invalid. The documentation is correct.

While get_dc_list() does construct lists containing (only) "ads" or "kdc", which are handled by internal_resolve_name(), these can't be used in smb.conf, because handle_name_resolve_order() in lib/param/loadparm.c only allows values that are in the default list:

	valid_values = str_list_make_v3_const(NULL,
					      DEFAULT_NAME_RESOLVE_ORDER,
					      NULL);

so if you e.g. add 'ads', you see:

handle_name_resolve_order: WARNING: Ignoring invalid list value 'ads' for parameter 'name resolve order'
Can't load st/ad_member/lib/server.conf - run testparm to debug it