summaryrefslogtreecommitdiff
path: root/docs/manpages/lmhosts.5
blob: aa053a447f25d6610d4c896830f50c0993f445d4 (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
.TH LMHOSTS 5 "28 Feb 2000" "lmhosts TNG-prealpha"
.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 
\fBlmhosts\fP 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 
# 
.br 
# Sample Samba lmhosts file\&. 
.br 
# 
.br 
192\&.9\&.200\&.1	TESTPC 
.br 
192\&.9\&.200\&.20	NTSERVER#20 
.br 
192\&.9\&.200\&.21	SAMBASERVER 
.br 
.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 \fIsamba-bugs@samba\&.org\fP\&. 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\&.org\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\&.