summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/protocol/nameresolveorder.xml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/docbook/smbdotconf/protocol/nameresolveorder.xml')
-rw-r--r--docs/docbook/smbdotconf/protocol/nameresolveorder.xml70
1 files changed, 0 insertions, 70 deletions
diff --git a/docs/docbook/smbdotconf/protocol/nameresolveorder.xml b/docs/docbook/smbdotconf/protocol/nameresolveorder.xml
deleted file mode 100644
index 45bc98843f..0000000000
--- a/docs/docbook/smbdotconf/protocol/nameresolveorder.xml
+++ /dev/null
@@ -1,70 +0,0 @@
-<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
- noescape="1" 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&lt;0x1c&gt; lookups.</para>
-
-</listitem>
-</samba:parameter>