| 1 | <samba:parameter name="name resolve order"
|
|---|
| 2 | context="G"
|
|---|
| 3 | type="list"
|
|---|
| 4 | advanced="1" wizard="1" developer="1"
|
|---|
| 5 | xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
|
|---|
| 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: "lmhosts", "host",
|
|---|
| 14 | "wins" and "bcast". They cause names to be
|
|---|
| 15 | resolved as follows:</para>
|
|---|
| 16 |
|
|---|
| 17 | <itemizedlist>
|
|---|
| 18 | <listitem>
|
|---|
| 19 | <para>
|
|---|
| 20 | <constant>lmhosts</constant> : Lookup an IP address in the Samba lmhosts file. If the line in lmhosts has
|
|---|
| 21 | no name type attached to the NetBIOS name (see the manpage for lmhosts for details) then
|
|---|
| 22 | any name type matches for lookup.
|
|---|
| 23 | </para>
|
|---|
| 24 | </listitem>
|
|---|
| 25 |
|
|---|
| 26 | <listitem>
|
|---|
| 27 | <para>
|
|---|
| 28 | <constant>host</constant> : Do a standard host name to IP address resolution, using the system
|
|---|
| 29 | <filename moreinfo="none">/etc/hosts </filename>, NIS, or DNS lookups. This method of name resolution is
|
|---|
| 30 | operating system depended for instance on IRIX or Solaris this may be controlled by the <filename
|
|---|
| 31 | moreinfo="none">/etc/nsswitch.conf</filename> file. Note that this method is used only if the NetBIOS name
|
|---|
| 32 | type being queried is the 0x20 (server) name type or 0x1c (domain controllers). The latter case is only
|
|---|
| 33 | useful for active directory domains and results in a DNS query for the SRV RR entry matching
|
|---|
| 34 | _ldap._tcp.domain.
|
|---|
| 35 | </para>
|
|---|
| 36 | </listitem>
|
|---|
| 37 |
|
|---|
| 38 | <listitem>
|
|---|
| 39 | <para><constant>wins</constant> : Query a name with
|
|---|
| 40 | the IP address listed in the <smbconfoption name="WINSSERVER"><parameter moreinfo="none">
|
|---|
| 41 | wins server</parameter></smbconfoption> 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 <smbconfoption name="interfaces"/>
|
|---|
| 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<0x1c> 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>
|
|---|
