1mailto(samba@samba.org)
2
3manpage(lmhosts htmlcommand((5)))(5)(23 Oct 1998)(Samba)(SAMBA)
4
5label(NAME)
6manpagename(lmhosts)(The Samba NetBIOS hosts file)
7
8label(SYNOPSIS)
9manpagesynopsis() 
10
11lmhosts is the bf(Samba) NetBIOS name to IP address mapping file.
12
13label(DESCRIPTION)
14manpagedescription()
15
16This file is part of the bf(Samba) suite.
17
18bf(lmhosts) is the bf(Samba) NetBIOS name to IP address mapping file.  It
19is very similar to the bf(/etc/hosts) file format, except that the
20hostname component must correspond to the NetBIOS naming format.
21
22label(FILEFORMAT)
23manpagesection(FILE FORMAT)
24
25It is an ASCII file containing one line for NetBIOS name. The two
26fields on each line are separated from each other by white space. Any
27entry beginning with # is ignored. Each line in the lmhosts file
28contains the following information :
29
30startit()
31
32it() bf(IP Address) - in dotted decimal format.
33
34it() bf(NetBIOS Name) - This name format is a maximum fifteen
35character host name, with an optional trailing tt('#') character
36followed by the NetBIOS name type as two hexadecimal digits.
37
38If the trailing tt('#') is omitted then the given IP address will be
39returned for all names that match the given name, whatever the NetBIOS
40name type in the lookup.
41
42endit()
43
44An example follows :
45
46# nl()
47# Sample Samba lmhosts file. nl()
48# nl()
49192.9.200.1	TESTPC nl()
50192.9.200.20	NTSERVER#20 nl()
51192.9.200.21	SAMBASERVER nl()
52
53Contains three IP to NetBIOS name mappings. The first and third will
54be returned for any queries for the names tt("TESTPC") and
55tt("SAMBASERVER") respectively, whatever the type component of the
56NetBIOS name requested.
57
58The second mapping will be returned only when the tt("0x20") name type
59for a name tt("NTSERVER") is queried. Any other name type will not be
60resolved.
61
62The default location of the bf(lmhosts) file is in the same directory
63as the url(bf(smb.conf))(smb.conf.html) file.
64
65label(VERSION)
66manpagesection(VERSION)
67
68This man page is correct for version 2.0 of the Samba suite.
69
70label(SEEALSO)
71manpageseealso()
72
73url(bf(smb.conf (5)))(smb.conf.5.html#nameresolveorder),
74url(bf(smbclient (1)))(smbclient.1.html#minusR),
75url(bf(smbpasswd (8)))(smbpasswd.8.html#minusR), url(bf(samba (7)))(samba.7.html).
76
77label(AUTHOR)
78manpageauthor()
79
80The original Samba software and related utilities were created by
81Andrew Tridgell email(samba@samba.org). Samba is now developed
82by the Samba Team as an Open Source project similar to the way the
83Linux kernel is developed.
84
85The original Samba man pages were written by Karl Auer. The man page
86sources were converted to YODL format (another excellent piece of Open
87Source software, available at
88url(bf(ftp://ftp.icce.rug.nl/pub/unix/))(ftp://ftp.icce.rug.nl/pub/unix/))
89and updated for the Samba2.0 release by Jeremy Allison.
90email(samba@samba.org).
91
92See url(bf(samba (7)))(samba.7.html) to find out how to get a full
93list of contributors and details on how to submit bug reports,
94comments etc.
95