Initial import

[samba] / docs / manpages / lmhosts.5

diff --git a/docs/manpages/lmhosts.5 b/docs/manpages/lmhosts.5
new file mode 100644 (file)
index 0000000..1bd108f
--- /dev/null
+++ b/docs/manpages/lmhosts.5
@@ -0,0 +1,95 @@
+.\"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\&.
+