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