Replace entities with xi:include
[Samba.git] / docs / devel / NetBIOS.xml
blob6bfe0c864722a4ebccdb701526afc2944aa8700a
1 <?xml version="1.0" encoding="iso-8859-1"?>
2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3                 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
4   <!ENTITY % global_entities SYSTEM '../entities/global.entities'>
5   %global_entities;
6 ]>
7 <chapter id="netbios">
8 <chapterinfo>
9         <author>
10                 <firstname>Luke</firstname><surname>Leighton</surname>
11         </author>
12         <pubdate>12 June 1997</pubdate>
13 </chapterinfo>
15 <title>Definition of NetBIOS Protocol and Name Resolution Modes</title>
17 <sect1>
18 <title>NETBIOS</title>
20 <para>
21 NetBIOS runs over the following tranports: TCP/IP; NetBEUI and IPX/SPX.
22 Samba only uses NetBIOS over TCP/IP.  For details on the TCP/IP NetBIOS 
23 Session Service NetBIOS Datagram Service, and NetBIOS Names, see
24 rfc1001.txt and rfc1002.txt.
25 </para>
27 <para> 
28 NetBEUI is a raw NetBIOS frame protocol implementation that allows NetBIOS
29 datagrams to be sent out over the 'wire' embedded within LLC frames.
30 NetBEUI is not required when using NetBIOS over TCP/IP protocols and it
31 is preferable NOT to install NetBEUI if it can be avoided.
32 </para>
34 <para> 
35 IPX/SPX is also not required when using NetBIOS over TCP/IP, and it is
36 preferable NOT to install the IPX/SPX transport unless you are using Novell
37 servers.  At the very least, it is recommended that you do not install
38 'NetBIOS over IPX/SPX'.
39 </para>
41 <para>
42 [When installing Windows 95, you will find that NetBEUI and IPX/SPX are
43 installed as the default protocols.  This is because they are the simplest
44 to manage: no Windows 95 user-configuration is required].
45 </para>
47 <para> 
48 NetBIOS applications (such as samba) offer their services (for example,
49 SMB file and print sharing) on a NetBIOS name.  They must claim this name
50 on the network before doing so.  The NetBIOS session service will then
51 accept connections on the application's behalf (on the NetBIOS name
52 claimed by the application).  A NetBIOS session between the application
53 and the client can then commence.
54 </para>
56 <para> 
57 NetBIOS names consist of 15 characters plus a 'type' character.  This is
58 similar, in concept, to an IP address and a TCP port number, respectively.
59 A NetBIOS-aware application on a host will offer different services under
60 different NetBIOS name types, just as a host will offer different TCP/IP
61 services on different port numbers.
62 </para>
64 <para> 
65 NetBIOS names must be claimed on a network, and must be defended.  The use
66 of NetBIOS names is most suitable on a single subnet; a Local Area Network
67 or a Wide Area Network.
68 </para>
70 <para> 
71 NetBIOS names are either UNIQUE or GROUP.  Only one application can claim a
72 UNIQUE NetBIOS name on a network.
73 </para>
75 <para>
76 There are two kinds of NetBIOS Name resolution: Broadcast and Point-to-Point.
77 </para>
79 </sect1>
81 <sect1>
82 <title>BROADCAST NetBIOS</title>
84 <para> 
85 Clients can claim names, and therefore offer services on successfully claimed
86 names, on their broadcast-isolated subnet.  One way to get NetBIOS services
87 (such as browsing: see ftp.microsoft.com/drg/developr/CIFS/browdiff.txt; and
88 SMB file/print sharing: see cifs4.txt) working on a LAN or WAN is to make
89 your routers forward all broadcast packets from TCP/IP ports 137, 138 and 139.
90 </para>
92 <para> 
93 This, however, is not recommended.  If you have a large LAN or WAN, you will
94 find that some of your hosts spend 95 percent of their time dealing with
95 broadcast traffic.  [If you have IPX/SPX on your LAN or WAN, you will find
96 that this is already happening: a packet analyzer will show, roughly
97 every twelve minutes, great swathes of broadcast traffic!].
98 </para>
100 </sect1>
102 <sect1>
103 <title>NBNS NetBIOS</title>
105 <para>
106 rfc1001.txt describes, amongst other things, the implementation and use
107 of, a 'NetBIOS Name Service'.  NT/AS offers 'Windows Internet Name Service'
108 which is fully rfc1001/2 compliant, but has had to take specific action
109 with certain NetBIOS names in order to make it useful.  (for example, it
110 deals with the registration of &lt;1c&gt; &lt;1d&gt; &lt;1e&gt; names all in different ways.
111 I recommend the reading of the Microsoft WINS Server Help files for full
112 details).
113 </para>
115 <para> 
116 The use of a WINS server cuts down on broadcast network traffic for
117 NetBIOS name resolution.  It has the effect of pulling all the broadcast
118 isolated subnets together into a single NetBIOS scope, across your LAN
119 or WAN, while avoiding the use of TCP/IP broadcast packets.
120 </para>
122 <para>
123 When you have a WINS server on your LAN, WINS clients will be able to
124 contact the WINS server to resolve NetBIOS names.  Note that only those
125 WINS clients that have registered with the same WINS server will be
126 visible.  The WINS server _can_ have static NetBIOS entries added to its
127 database (usually for security reasons you might want to consider putting
128 your domain controllers or other important servers as static entries,
129 but you should not rely on this as your sole means of security), but for
130 the most part, NetBIOS names are registered dynamically.
131 </para>
133 <para>
134 This provides some confusion for lots of people, and is worth mentioning
135 here:  a Browse Server is NOT a WINS Server, even if these services are
136 implemented in the same application.  A Browse Server _needs_ a WINS server
137 because a Browse Server is a WINS client, which is _not_ the same thing].
138 </para>
140 <para>
141 Clients can claim names, and therefore offer services on successfully claimed
142 names, on their broadcast-isolated subnet.  One way to get NetBIOS services
143 (such as browsing: see ftp.microsoft.com/drg/developr/CIFS/browdiff.txt; and
144 SMB file/print sharing: see cifs6.txt) working on a LAN or WAN is to make
145 your routers forward all broadcast packets from TCP/IP ports 137, 138 and 139.
146 You will find, however, if you do this on a large LAN or a WAN, that your
147 network is completely swamped by NetBIOS and browsing packets, which is why
148 WINS was developed to minimise the necessity of broadcast traffic.
149 </para>
151 <para> 
152 WINS Clients therefore claim names from the WINS server.  If the WINS
153 server allows them to register a name, the client's NetBIOS session service
154 can then offer services on this name.  Other WINS clients will then
155 contact the WINS server to resolve a NetBIOS name.
156 </para>
158 </sect1>
160 </chapter>