docs/smbdotconf/protocol/nameresolveorder.xml

   1 <samba:parameter name="name resolve order"
   2                  context="G"
   3                                  type="list"
   4                  advanced="1" wizard="1" developer="1"
   5                  xmlns:samba="http://samba.org/common">
   6 <description>
   7     <para>This option is used by the programs in the Samba
   8     suite to determine what naming services to use and in what order
   9     to resolve host names to IP addresses. Its main purpose to is to
  10     control how netbios name resolution is performed.  The option takes a space
  11     separated string of name resolution options.</para>
  12
  13     <para>The options are: &quot;lmhosts&quot;, &quot;host&quot;,
  14     &quot;wins&quot; and &quot;bcast&quot;. They cause names to be
  15     resolved as follows:</para>
  16
  17     <itemizedlist>
  18         <listitem>
  19             <para><constant>lmhosts</constant> : Lookup an IP
  20             address in the Samba lmhosts file. If the line in lmhosts has
  21             no name type attached to the NetBIOS name (see the <ulink
  22             noescape="1" url="lmhosts.5.html">lmhosts(5)</ulink> for details) then
  23             any name type matches for lookup.</para>
  24         </listitem>
  25
  26         <listitem>
  27             <para><constant>host</constant> : Do a standard host
  28             name to IP address resolution, using the system <filename moreinfo="none">/etc/hosts
  29             </filename>, NIS, or DNS lookups. This method of name resolution
  30             is operating system depended for instance on IRIX or Solaris this
  31             may be controlled by the <filename moreinfo="none">/etc/nsswitch.conf</filename>
  32             file.  Note that this method is used only if the NetBIOS name
  33             type being queried is the 0x20 (server) name type or 0x1c (domain controllers).
  34             The latter case is only useful for active directory domains and results in a DNS
  35             query for the SRV RR entry matching _ldap._tcp.domain.</para>
  36         </listitem>
  37
  38         <listitem>
  39             <para><constant>wins</constant> : Query a name with
  40             the IP address listed in the <link linkend="WINSSERVER"><parameter moreinfo="none">
  41             wins server</parameter></link> parameter.  If no WINS server has
  42             been specified this method will be ignored.</para>
  43         </listitem>
  44
  45         <listitem>
  46             <para><constant>bcast</constant> : Do a broadcast on
  47             each of the known local interfaces listed in the <link linkend="INTERFACES"><parameter moreinfo="none">interfaces</parameter></link>
  48             parameter. This is the least reliable of the name resolution
  49             methods as it depends on the target host being on a locally
  50             connected subnet.</para>
  51         </listitem>
  52 </itemizedlist>
  53
  54     <para>The example below will cause the local lmhosts file to be examined
  55     first, followed by a broadcast attempt, followed by a normal
  56     system hostname lookup.</para>
  57
  58     <para>When Samba is functioning in ADS security mode (<command moreinfo="none">security = ads</command>)
  59     it is advised to use following settings for <parameter moreinfo="none">name resolve order</parameter>:</para>
  60
  61     <para><command moreinfo="none">name resolve order = wins bcast</command></para>
  62
  63     <para>DC lookups will still be done via DNS, but fallbacks to netbios names will
  64                 not inundate your DNS servers with needless querys for DOMAIN&lt;0x1c&gt; lookups.</para>
  65
  66 </description>
  67
  68 <value type="default">lmhosts host wins bcast</value>
  69 <value type="example">lmhosts bcast host</value>
  70 </samba:parameter>