Added link to YODL url.
[kai/samba.git] / docs / yodldocs / lmhosts.5.yo
1 mailto(samba-bugs@samba.anu.edu.au)
2
3 manpage(lmhosts)(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 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 verb(
47
48 #
49 # Sample Samba lmhosts file.
50 #
51 192.9.200.1     TESTPC
52 192.9.200.20    NTSERVER#20
53 192.9.200.21    SAMBASERVER
54 )
55
56 Contains three IP to NetBIOS name mappings. The first and third will
57 be returned for any queries for the names tt("TESTPC") and
58 tt("SAMBASERVER") respectively, whatever the type component of the
59 NetBIOS name requested.
60
61 The second mapping will be returned only when the tt("0x20") name type
62 for a name tt("NTSERVER") is queried. Any other name type will not be
63 resolved.
64
65 The default location of the bf(lmhosts) file is in the same directory
66 as the url(bf(smb.conf))(smb.conf.html) file.
67
68 label(VERSION)
69 manpagesection(VERSION)
70
71 This man page is correct for version 2.0 of the Samba suite.
72
73 label(SEEALSO)
74 manpageseealso()
75
76 url(bf(smb.conf (5)))(smb.conf.5.html#nameresolveorder),
77 url(bf(smbclient (1)))(smbclient.1.html#minusR),
78 url(bf(smbpasswd (8)))(smbpasswd.8.html#minusR), url(bf(samba (7)))(samba.7.html).
79
80 label(AUTHOR)
81 manpageauthor()
82
83 The original Samba software and related utilities were created by
84 Andrew Tridgell (samba-bugs@samba.anu.edu.au). Samba is now developed
85 by the Samba Team as an Open Source project similar to the way the
86 Linux kernel is developed.
87
88 The original Samba man pages were written by Karl Auer. The man page
89 sources were converted to YODL format (another excellent piece of Open
90 Source software, available at
91 url(bf(ftp://ftp.icce.rug.nl/pub/unix/))(ftp://ftp.icce.rug.nl/pub/unix/))
92 and updated for the Samba2.0 release by Jeremy Allison.
93 email(samba-bugs@samba.anu.edu.au).
94
95 See url(bf(samba (7)))(samba.7.html) to find out how to get a full
96 list of contributors and details on how to submit bug reports,
97 comments etc.