docs/docbook/smbdotconf/protocol/nameresolveorder.xml

   1 <samba:parameter xmlns:samba="http://samba.org/common">
   2                 <term><anchor id="NAMERESOLVEORDER"/>name resolve order (G)</term>
   3                 <listitem><para>This option is used by the programs in the Samba
   4                 suite to determine what naming services to use and in what order
   5                 to resolve host names to IP addresses. The option takes a space
   6                 separated string of name resolution options.</para>
   7
   8                 <para>The options are :&quot;lmhosts&quot;, &quot;host&quot;, &quot;wins&quot; and &quot;bcast&quot;. They
   9                 cause names to be resolved as follows :</para>
  10
  11                 <itemizedlist>
  12                         <listitem><para><constant>lmhosts</constant> : Lookup an IP
  13                         address in the Samba lmhosts file. If the line in lmhosts has
  14                         no name type attached to the NetBIOS name (see the <ulink url="lmhosts.5.html">lmhosts(5)</ulink> for details) then
  15                         any name type matches for lookup.</para></listitem>
  16
  17                         <listitem><para><constant>host</constant> : Do a standard host
  18                         name to IP address resolution, using the system <filename moreinfo="none">/etc/hosts
  19                         </filename>, NIS, or DNS lookups. This method of name resolution
  20                         is operating system depended for instance on IRIX or Solaris this
  21                         may be controlled by the <filename moreinfo="none">/etc/nsswitch.conf</filename>
  22                         file.  Note that this method is only used if the NetBIOS name
  23                         type being queried is the 0x20 (server) name type, otherwise
  24                         it is ignored.</para></listitem>
  25
  26                         <listitem><para><constant>wins</constant> : Query a name with
  27                         the IP address listed in the <link linkend="WINSSERVER"><parameter moreinfo="none">
  28                         wins server</parameter></link> parameter.  If no WINS server has
  29                         been specified this method will be ignored.</para></listitem>
  30
  31                         <listitem><para><constant>bcast</constant> : Do a broadcast on
  32                         each of the known local interfaces listed in the <link linkend="INTERFACES"><parameter moreinfo="none">interfaces</parameter></link>
  33                         parameter. This is the least reliable of the name resolution
  34                         methods as it depends on the target host being on a locally
  35                         connected subnet.</para></listitem>
  36                 </itemizedlist>
  37
  38                 <para>Default: <command moreinfo="none">name resolve order = lmhosts host wins bcast
  39                 </command></para>
  40                 <para>Example: <command moreinfo="none">name resolve order = lmhosts bcast host
  41                 </command></para>
  42
  43                 <para>This will cause the local lmhosts file to be examined
  44                 first, followed by a broadcast attempt, followed by a normal
  45                 system hostname lookup.</para>
  46                 </listitem>
  47                 </samba:parameter>