4d7f11e64b00f40a2535205740775c13525dd1d0
[ira/wip.git] / docs / htmldocs / lmhosts.5.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <HTML
3 ><HEAD
4 ><TITLE
5 >lmhosts</TITLE
6 ><META
7 NAME="GENERATOR"
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.77"></HEAD
9 ><BODY
10 CLASS="REFENTRY"
11 BGCOLOR="#FFFFFF"
12 TEXT="#000000"
13 LINK="#0000FF"
14 VLINK="#840084"
15 ALINK="#0000FF"
16 ><H1
17 ><A
18 NAME="LMHOSTS"
19 ></A
20 >lmhosts</H1
21 ><DIV
22 CLASS="REFNAMEDIV"
23 ><A
24 NAME="AEN5"
25 ></A
26 ><H2
27 >Name</H2
28 >lmhosts&nbsp;--&nbsp;The Samba NetBIOS hosts file</DIV
29 ><DIV
30 CLASS="REFSYNOPSISDIV"
31 ><A
32 NAME="AEN8"
33 ></A
34 ><H2
35 >Synopsis</H2
36 ><P
37 ><TT
38 CLASS="FILENAME"
39 >lmhosts</TT
40 > is the <A
41 HREF="samba.7.html"
42 TARGET="_top"
43 >       Samba</A
44 > NetBIOS name to IP address mapping file.</P
45 ></DIV
46 ><DIV
47 CLASS="REFSECT1"
48 ><A
49 NAME="AEN12"
50 ></A
51 ><H2
52 >DESCRIPTION</H2
53 ><P
54 >This file is part of the <A
55 HREF="samba.7.html"
56 TARGET="_top"
57 >       Samba</A
58 > suite.</P
59 ><P
60 ><TT
61 CLASS="FILENAME"
62 >lmhosts</TT
63 > is the <SPAN
64 CLASS="emphasis"
65 ><I
66 CLASS="EMPHASIS"
67 >Samba
68         </I
69 ></SPAN
70 > NetBIOS name to IP address mapping file.  It 
71         is very similar to the <TT
72 CLASS="FILENAME"
73 >/etc/hosts</TT
74 > file 
75         format, except that the hostname component must correspond 
76         to the NetBIOS naming format.</P
77 ></DIV
78 ><DIV
79 CLASS="REFSECT1"
80 ><A
81 NAME="AEN20"
82 ></A
83 ><H2
84 >FILE FORMAT</H2
85 ><P
86 >It is an ASCII file containing one line for NetBIOS name. 
87         The two fields on each line are separated from each other by 
88         white space. Any entry beginning with '#' is ignored. Each line 
89         in the lmhosts file contains the following information :</P
90 ><P
91 ></P
92 ><UL
93 ><LI
94 ><P
95 >IP Address - in dotted decimal format.</P
96 ></LI
97 ><LI
98 ><P
99 >NetBIOS Name - This name format is a 
100                 maximum fifteen character host name, with an optional 
101                 trailing '#' character followed by the NetBIOS name type 
102                 as two hexadecimal digits.</P
103 ><P
104 >If the trailing '#' is omitted then the given IP 
105                 address will be returned for all names that match the given 
106                 name, whatever the NetBIOS name type in the lookup.</P
107 ></LI
108 ></UL
109 ><P
110 >An example follows :</P
111 ><P
112 ><PRE
113 CLASS="PROGRAMLISTING"
114 >#
115 # Sample Samba lmhosts file.
116 #
117 192.9.200.1     TESTPC
118 192.9.200.20    NTSERVER#20
119 192.9.200.21    SAMBASERVER
120         </PRE
121 ></P
122 ><P
123 >Contains three IP to NetBIOS name mappings. The first 
124         and third will be returned for any queries for the names "TESTPC" 
125         and "SAMBASERVER" respectively, whatever the type component of 
126         the NetBIOS name requested.</P
127 ><P
128 >The second mapping will be returned only when the "0x20" name 
129         type for a name "NTSERVER" is queried. Any other name type will not 
130         be resolved.</P
131 ><P
132 >The default location of the <TT
133 CLASS="FILENAME"
134 >lmhosts</TT
135 > file 
136         is in the same directory as the <A
137 HREF="smb.conf.5.html"
138 TARGET="_top"
139 >               
140         smb.conf(5)&#62;</A
141 > file.</P
142 ></DIV
143 ><DIV
144 CLASS="REFSECT1"
145 ><A
146 NAME="AEN37"
147 ></A
148 ><H2
149 >VERSION</H2
150 ><P
151 >This man page is correct for version 2.2 of 
152         the Samba suite.</P
153 ></DIV
154 ><DIV
155 CLASS="REFSECT1"
156 ><A
157 NAME="AEN40"
158 ></A
159 ><H2
160 >SEE ALSO</H2
161 ><P
162 ><A
163 HREF="smbclient.1.html"
164 TARGET="_top"
165 ><B
166 CLASS="COMMAND"
167 >smbclient(1)
168         </B
169 ></A
170 >, <A
171 HREF="smb.conf.5.html#NAMERESOLVEORDER"
172 TARGET="_top"
173 >       smb.conf(5)</A
174 >, and <A
175 HREF="smbpasswd.8.html"
176 TARGET="_top"
177 ><B
178 CLASS="COMMAND"
179 >       smbpasswd(8)</B
180 ></A
181 >
182         </P
183 ></DIV
184 ><DIV
185 CLASS="REFSECT1"
186 ><A
187 NAME="AEN48"
188 ></A
189 ><H2
190 >AUTHOR</H2
191 ><P
192 >The original Samba software and related utilities 
193         were created by Andrew Tridgell. Samba is now developed
194         by the Samba Team as an Open Source project similar 
195         to the way the Linux kernel is developed.</P
196 ><P
197 >The original Samba man pages were written by Karl Auer. 
198         The man page sources were converted to YODL format (another 
199         excellent piece of Open Source software, available at
200         <A
201 HREF="ftp://ftp.icce.rug.nl/pub/unix/"
202 TARGET="_top"
203 >       ftp://ftp.icce.rug.nl/pub/unix/</A
204 >) and updated for the Samba 2.0 
205         release by Jeremy Allison.  The conversion to DocBook for 
206         Samba 2.2 was done by Gerald Carter</P
207 ></DIV
208 ></BODY
209 ></HTML
210 >