1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
2 <refentry id="lmhosts">
5 <refentrytitle>lmhosts</refentrytitle>
6 <manvolnum>5</manvolnum>
11 <refname>lmhosts</refname>
12 <refpurpose>The Samba NetBIOS hosts file</refpurpose>
16 <para><filename>lmhosts</filename> is the <ulink url="samba.7.html">
17 Samba</ulink> NetBIOS name to IP address mapping file.</para>
21 <title>DESCRIPTION</title>
23 <para>This file is part of the <ulink url="samba.7.html">
24 Samba</ulink> suite.</para>
26 <para><filename>lmhosts</filename> is the <emphasis>Samba
27 </emphasis> NetBIOS name to IP address mapping file. It
28 is very similar to the <filename>/etc/hosts</filename> file
29 format, except that the hostname component must correspond
30 to the NetBIOS naming format.</para>
34 <title>FILE FORMAT</title>
35 <para>It is an ASCII file containing one line for NetBIOS name.
36 The two fields on each line are separated from each other by
37 white space. Any entry beginning with '#' is ignored. Each line
38 in the lmhosts file contains the following information :</para>
41 <listitem><para>IP Address - in dotted decimal format.</para>
44 <listitem><para>NetBIOS Name - This name format is a
45 maximum fifteen character host name, with an optional
46 trailing '#' character followed by the NetBIOS name type
47 as two hexadecimal digits.</para>
49 <para>If the trailing '#' is omitted then the given IP
50 address will be returned for all names that match the given
51 name, whatever the NetBIOS name type in the lookup.</para>
55 <para>An example follows :</para>
57 <para><programlisting>
59 # Sample Samba lmhosts file.
62 192.9.200.20 NTSERVER#20
63 192.9.200.21 SAMBASERVER
64 </programlisting></para>
66 <para>Contains three IP to NetBIOS name mappings. The first
67 and third will be returned for any queries for the names "TESTPC"
68 and "SAMBASERVER" respectively, whatever the type component of
69 the NetBIOS name requested.</para>
71 <para>The second mapping will be returned only when the "0x20" name
72 type for a name "NTSERVER" is queried. Any other name type will not
75 <para>The default location of the <filename>lmhosts</filename> file
76 is in the same directory as the <ulink url="smb.conf.5.html">
77 smb.conf(5)></ulink> file.</para>
82 <title>VERSION</title>
84 <para>This man page is correct for version 2.2 of
85 the Samba suite.</para>
89 <title>SEE ALSO</title>
90 <para><ulink url="smbclient.1.html"><command>smbclient(1)
91 </command></ulink>, <ulink url="smb.conf.5.html#NAMERESOLVEORDER">
92 smb.conf(5)</ulink>, and <ulink url="smbpasswd.8.html"><command>
93 smbpasswd(8)</command></ulink>
100 <para>The original Samba software and related utilities
101 were created by Andrew Tridgell. Samba is now developed
102 by the Samba Team as an Open Source project similar
103 to the way the Linux kernel is developed.</para>
105 <para>The original Samba man pages were written by Karl Auer.
106 The man page sources were converted to YODL format (another
107 excellent piece of Open Source software, available at
108 <ulink url="ftp://ftp.icce.rug.nl/pub/unix/">
109 ftp://ftp.icce.rug.nl/pub/unix/</ulink>) and updated for the Samba 2.0
110 release by Jeremy Allison. The conversion to DocBook for
111 Samba 2.2 was done by Gerald Carter</para>