summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/protocol/nameresolveorder.xml
blob: 777fc2268ea16d819b4e71d2061b12c8c1300046 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
<samba:parameter name="name resolve order"
                 context="G"
                 advanced="1" wizard="1" developer="1"
                 xmlns:samba="http://samba.org/common"> 
<listitem>
    <para>This option is used by the programs in the Samba 
    suite to determine what naming services to use and in what order 
    to resolve host names to IP addresses. Its main purpose to is to
    control how netbios name resolution is performed.  The option takes a space 
    separated string of name resolution options.</para>

    <para>The options are: &quot;lmhosts&quot;, &quot;host&quot;,
    &quot;wins&quot; and &quot;bcast&quot;. They cause names to be
    resolved as follows:</para>

    <itemizedlist>
	<listitem>
	    <para><constant>lmhosts</constant> : Lookup an IP 
	    address in the Samba lmhosts file. If the line in lmhosts has 
	    no name type attached to the NetBIOS name (see the <ulink 
            url="lmhosts.5.html">lmhosts(5)</ulink> for details) then
	    any name type matches for lookup.</para>
	</listitem>

	<listitem>
	    <para><constant>host</constant> : Do a standard host 
	    name to IP address resolution, using the system <filename moreinfo="none">/etc/hosts
	    </filename>, NIS, or DNS lookups. This method of name resolution 
	    is operating system depended for instance on IRIX or Solaris this 
	    may be controlled by the <filename moreinfo="none">/etc/nsswitch.conf</filename> 
	    file.  Note that this method is used only if the NetBIOS name 
	    type being queried is the 0x20 (server) name type or 0x1c (domain controllers). 
            The latter case is only useful for active directory domains and results in a DNS
            query for the SRV RR entry matching _ldap._tcp.domain.</para>
	</listitem>

	<listitem>
	    <para><constant>wins</constant> : Query a name with 
	    the IP address listed in the <link linkend="WINSSERVER"><parameter moreinfo="none">
	    wins server</parameter></link> parameter.  If no WINS server has
	    been specified this method will be ignored.</para>
	</listitem>

	<listitem>
	    <para><constant>bcast</constant> : Do a broadcast on 
	    each of the known local interfaces listed in the <link linkend="INTERFACES"><parameter moreinfo="none">interfaces</parameter></link> 
	    parameter. This is the least reliable of the name resolution 
	    methods as it depends on the target host being on a locally 
	    connected subnet.</para>
	</listitem>
    </itemizedlist>

    <para>Default: <command moreinfo="none">name resolve order = lmhosts host wins bcast</command></para>

    <para>Example: <command moreinfo="none">name resolve order = lmhosts bcast host</command></para>
    
    <para>This will cause the local lmhosts file to be examined 
    first, followed by a broadcast attempt, followed by a normal 
    system hostname lookup.</para>

    <para>When Samba is functioning in ADS security mode (<command moreinfo="none">security = ads</command>)
    it is advised to use following settings for <parameter moreinfo="none">name resolve order</parameter>:</para>

    <para><command moreinfo="none">name resolve order = wins bcast</command></para>

    <para>DC lookups will still be done via DNS, but fallbacks to netbios names will
    not inundate your DNS servers with needless querys for DOMAIN<0x1c> lookups.</para>
    
</listitem>
</samba:parameter>