release/src-rt-6.x.4708/router/samba-3.0.25b/docs/htmldocs/manpages/lmhosts.5.html

   1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>lmhosts</title><link rel="stylesheet" href="samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.71.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="lmhosts.5"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>lmhosts &#8212; The Samba NetBIOS hosts file</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">lmhosts</code> is the <a href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> NetBIOS name to IP address mapping file.</p></div><div class="refsect1" lang="en"><a name="id259295"></a><h2>DESCRIPTION</h2><p>This file is part of the <a href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="filename">lmhosts</code> is the <span class="emphasis"><em>Samba
   2         </em></span> NetBIOS name to IP address mapping file.  It
   3         is very similar to the <code class="filename">/etc/hosts</code> file
   4         format, except that the hostname component must correspond
   5         to the NetBIOS naming format.</p></div><div class="refsect1" lang="en"><a name="id259546"></a><h2>FILE FORMAT</h2><p>It is an ASCII file containing one line for NetBIOS name.
   6         The two fields on each line are separated from each other by
   7         white space. Any entry beginning with '#' is ignored. Each line
   8         in the lmhosts file contains the following information:</p><div class="itemizedlist"><ul type="disc"><li><p>IP Address - in dotted decimal format.</p></li><li><p>NetBIOS Name - This name format is a
   9                 maximum fifteen character host name, with an optional
  10                 trailing '#' character followed by the NetBIOS name type
  11                 as two hexadecimal digits.</p><p>If the trailing '#' is omitted then the given IP
  12                 address will be returned for all names that match the given
  13                 name, whatever the NetBIOS name type in the lookup.</p></li></ul></div><p>An example follows:
  14 </p><pre class="programlisting">
  15 #
  16 # Sample Samba lmhosts file.
  17 #
  18 192.9.200.1     TESTPC
  19 192.9.200.20    NTSERVER#20
  20 192.9.200.21    SAMBASERVER
  21 </pre><p>
  22         </p><p>Contains three IP to NetBIOS name mappings. The first
  23         and third will be returned for any queries for the names "TESTPC"
  24         and "SAMBASERVER" respectively, whatever the type component of
  25         the NetBIOS name requested.</p><p>The second mapping will be returned only when the "0x20" name
  26         type for a name "NTSERVER" is queried. Any other name type will not
  27         be resolved.</p><p>The default location of the <code class="filename">lmhosts</code> file
  28         is in the same directory as the <a href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a> file.</p></div><div class="refsect1" lang="en"><a name="id259366"></a><h2>FILES</h2><p>lmhosts is loaded from the configuration directory. This is
  29                 usually <code class="filename">/etc/samba</code> or <code class="filename">/usr/local/samba/lib</code>.
  30         </p></div><div class="refsect1" lang="en"><a name="id259388"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id259398"></a><h2>SEE ALSO</h2><p><a href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>, <a href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>, and <a href="smbpasswd.8.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(8)</span></a>
  31         </p></div><div class="refsect1" lang="en"><a name="id259432"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
  32         were created by Andrew Tridgell. Samba is now developed
  33         by the Samba Team as an Open Source project similar
  34         to the way the Linux kernel is developed.</p><p>The original Samba man pages were written by Karl Auer.
  35         The man page sources were converted to YODL format (another
  36         excellent piece of Open Source software, available at
  37         <a href="ftp://ftp.icce.rug.nl/pub/unix/" target="_top">
  38         ftp://ftp.icce.rug.nl/pub/unix/</a>) and updated for the Samba 2.0
  39         release by Jeremy Allison.  The conversion to DocBook for
  40         Samba 2.2 was done by Gerald Carter. The conversion to DocBook
  41         XML 4.2 was done by Alexander Bokovoy.</p></div></div></body></html>