summaryrefslogtreecommitdiff
path: root/docs/manpages/lmhosts.5
blob: f9bc2b065980c346d2966d71192ba4db419ada82 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
.TH "lmhosts" "5" "23 Oct 1998" "Samba" "SAMBA" 
.PP 
.SH "NAME" 
lmhosts \- The Samba NetBIOS hosts file
.PP 
.SH "SYNOPSIS" 
.PP 
lmhosts is the \fBSamba\fP NetBIOS name to IP address mapping file\&.
.PP 
.SH "DESCRIPTION" 
.PP 
This file is part of the \fBSamba\fP suite\&.
.PP 
lmhosts is the \fBSamba\fP NetBIOS name to IP address mapping file\&.  It
is very similar to the \fB/etc/hosts\fP file format, except that the
hostname component must correspond to the NetBIOS naming format\&.
.PP 
.SH "FILE FORMAT" 
.PP 
It is an ASCII file containing one line for NetBIOS name\&. The two
fields on each line are separated from each other by white space\&. Any
entry beginning with # is ignored\&. Each line in the lmhosts file
contains the following information :
.PP 
.IP 
.IP o 
\fBIP Address\fP - in dotted decimal format\&.
.IP 
.IP o 
\fBNetBIOS Name\fP - This name format is a maximum fifteen
character host name, with an optional trailing \f(CW\'#\'\fP character
followed by the NetBIOS name type as two hexadecimal digits\&.
.IP 
If the trailing \f(CW\'#\'\fP is omitted then the given IP address will be
returned for all names that match the given name, whatever the NetBIOS
name type in the lookup\&.
.IP 
.PP 
An example follows :
.PP 

.DS 
 


#
# Sample Samba lmhosts file\&.
#
192\&.9\&.200\&.1	TESTPC
192\&.9\&.200\&.20	NTSERVER#20
192\&.9\&.200\&.21	SAMBASERVER

.DE 
 

.PP 
Contains three IP to NetBIOS name mappings\&. The first and third will
be returned for any queries for the names \f(CW"TESTPC"\fP and
\f(CW"SAMBASERVER"\fP respectively, whatever the type component of the
NetBIOS name requested\&.
.PP 
The second mapping will be returned only when the \f(CW"0x20"\fP name type
for a name \f(CW"NTSERVER"\fP is queried\&. Any other name type will not be
resolved\&.
.PP 
The default location of the \fBlmhosts\fP file is in the same directory
as the \fBsmb\&.conf\fP file\&.
.PP 
.SH "VERSION" 
.PP 
This man page is correct for version 2\&.0 of the Samba suite\&.
.PP 
.SH "SEE ALSO" 
.PP 
\fBsmb\&.conf (5)\fP,
\fBsmbclient (1)\fP,
\fBsmbpasswd (8)\fP, \fBsamba (7)\fP\&.
.PP 
.SH "AUTHOR" 
.PP 
The original Samba software and related utilities were created by
Andrew Tridgell (samba-bugs@samba\&.anu\&.edu\&.au)\&. Samba is now developed
by the Samba Team as an Open Source project similar to the way the
Linux kernel is developed\&.
.PP 
The original Samba man pages were written by Karl Auer\&. The man page
sources were converted to YODL format (another excellent piece of Open
Source software, available at
\fBftp://ftp\&.icce\&.rug\&.nl/pub/unix/\fP)
and updated for the Samba2\&.0 release by Jeremy Allison\&.
\fIsamba-bugs@samba\&.anu\&.edu\&.au\fP\&.
.PP 
See \fBsamba (7)\fP to find out how to get a full
list of contributors and details on how to submit bug reports,
comments etc\&.