lmhosts.5   [plain text]


.\"Generated by db2man.xsl. Don't modify this, modify the source.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "LMHOSTS" 5 "" "" ""
.SH NAME
lmhosts \- The Samba NetBIOS hosts file
.SH "SYNOPSIS"

.PP
\fIlmhosts\fR is the \fBsamba\fR(7) NetBIOS name to IP address mapping file\&.

.SH "DESCRIPTION"

.PP
This file is part of the \fBsamba\fR(7) suite\&.

.PP
\fIlmhosts\fR is the \fBSamba \fR NetBIOS name to IP address mapping file\&. It is very similar to the \fI/etc/hosts\fR file format, except that the hostname component must correspond to the NetBIOS naming format\&.

.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:

.TP 3
\(bu
IP Address \- in dotted decimal format\&.
.TP
\(bu
NetBIOS Name \- This name format is a maximum fifteen character host name, with an optional trailing '#' character followed by the NetBIOS name type as two hexadecimal digits\&.

If the trailing '#' 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\&.
.LP

.PP
An example follows:
.nf

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

.PP
Contains three IP to NetBIOS name mappings\&. The first and third will be returned for any queries for the names "TESTPC" and "SAMBASERVER" respectively, whatever the type component of the NetBIOS name requested\&.

.PP
The second mapping will be returned only when the "0x20" name type for a name "NTSERVER" is queried\&. Any other name type will not be resolved\&.

.PP
The default location of the \fIlmhosts\fR file is in the same directory as the \fBsmb\&.conf\fR(5) file\&.

.SH "FILES"

.PP
lmhosts is loaded from the configuration directory\&. This is usually \fI/etc/samba\fR or \fI/usr/local/samba/lib\fR\&.

.SH "VERSION"

.PP
This man page is correct for version 3\&.0 of the Samba suite\&.

.SH "SEE ALSO"

.PP
\fBsmbclient\fR(1), \fBsmb\&.conf\fR(5), and \fBsmbpasswd\fR(8) 

.SH "AUTHOR"

.PP
The original Samba software and related utilities were created by Andrew Tridgell\&. 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 atftp://ftp\&.icce\&.rug\&.nl/pub/unix/) and updated for the Samba 2\&.0 release by Jeremy Allison\&. The conversion to DocBook for Samba 2\&.2 was done by Gerald Carter\&. The conversion to DocBook XML 4\&.2 was done by Alexander Bokovoy\&.