[MS-NBTE]:
NetBIOS over TCP (NBT) Extensions
Intellectual Property Rights Notice for Open Specifications Documentation
§ Technical Documentation. Microsoft publishes Open Specifications documentation for protocols, file formats, languages, standards as well as overviews of the interaction among each of these technologies.
§ Copyrights. This documentation is covered by Microsoft copyrights. Regardless of any other terms that are contained in the terms of use for the Microsoft website that hosts this documentation, you may make copies of it in order to develop implementations of the technologies described in the Open Specifications and may distribute portions of it in your implementations using these technologies or your documentation as necessary to properly document the implementation. You may also distribute in your implementation, with or without modification, any schema, IDL's, or code samples that are included in the documentation. This permission also applies to any documents that are referenced in the Open Specifications.
§ No Trade Secrets. Microsoft does not claim any trade secret rights in this documentation.
§ Patents. Microsoft has patents that may cover your implementations of the technologies described in the Open Specifications. Neither this notice nor Microsoft's delivery of the documentation grants any licenses under those or any other Microsoft patents. However, a given Open Specification may be covered by Microsoft Open Specification Promise or the Community Promise. If you would prefer a written license, or if the technologies described in the Open Specifications are not covered by the Open Specifications Promise or Community Promise, as applicable, patent licenses are available by contacting .
§ Trademarks. The names of companies and products contained in this documentation may be covered by trademarks or similar intellectual property rights. This notice does not grant any licenses under those rights. For a list of Microsoft trademarks, visit www.microsoft.com/trademarks.
§ Fictitious Names. The example companies, organizations, products, domain names, e-mail addresses, logos, people, places, and events depicted in this documentation are fictitious. No association with any real company, organization, product, domain name, email address, logo, person, place, or event is intended or should be inferred.
Reservation of Rights. All other rights are reserved, and this notice does not grant any rights other than specifically described above, whether by implication, estoppel, or otherwise.
Tools. The Open Specifications do not require the use of Microsoft programming tools or programming environments in order for you to develop an implementation. If you have access to Microsoft programming tools and environments you are free to take advantage of them. Certain Open Specifications are intended for use in conjunction with publicly available standard specifications and network programming art, and assumes that the reader either is familiar with the aforementioned material or has immediate access to it.
Revision Summary
Date / Revision History / Revision Class / Comments /5/22/2009 / 0.1 / Major / First Release.
7/2/2009 / 0.1.1 / Editorial / Changed language and formatting in the technical content.
8/14/2009 / 1.0 / Major / Updated and revised the technical content.
9/25/2009 / 1.0.1 / Editorial / Changed language and formatting in the technical content.
11/6/2009 / 1.0.2 / Editorial / Changed language and formatting in the technical content.
12/18/2009 / 1.0.3 / Editorial / Changed language and formatting in the technical content.
1/29/2010 / 2.0 / Major / Updated and revised the technical content.
3/12/2010 / 3.0 / Major / Updated and revised the technical content.
4/23/2010 / 4.0 / Major / Updated and revised the technical content.
6/4/2010 / 4.0.1 / Editorial / Changed language and formatting in the technical content.
7/16/2010 / 5.0 / Major / Updated and revised the technical content.
8/27/2010 / 5.0 / None / No changes to the meaning, language, or formatting of the technical content.
10/8/2010 / 6.0 / Major / Updated and revised the technical content.
11/19/2010 / 6.0 / None / No changes to the meaning, language, or formatting of the technical content.
1/7/2011 / 7.0 / Major / Updated and revised the technical content.
2/11/2011 / 7.0 / None / No changes to the meaning, language, or formatting of the technical content.
3/25/2011 / 8.0 / Major / Updated and revised the technical content.
5/6/2011 / 9.0 / Major / Updated and revised the technical content.
6/17/2011 / 9.1 / Minor / Clarified the meaning of the technical content.
9/23/2011 / 9.1 / None / No changes to the meaning, language, or formatting of the technical content.
12/16/2011 / 10.0 / Major / Updated and revised the technical content.
3/30/2012 / 10.0 / None / No changes to the meaning, language, or formatting of the technical content.
7/12/2012 / 11.0 / Major / Updated and revised the technical content.
10/25/2012 / 12.0 / Major / Updated and revised the technical content.
1/31/2013 / 12.0 / None / No changes to the meaning, language, or formatting of the technical content.
8/8/2013 / 13.0 / Major / Updated and revised the technical content.
11/14/2013 / 14.0 / Major / Updated and revised the technical content.
2/13/2014 / 14.0 / None / No changes to the meaning, language, or formatting of the technical content.
5/15/2014 / 15.0 / Major / Updated and revised the technical content.
6/30/2015 / 16.0 / Major / Significantly changed the technical content.
Table of Contents
1 Introduction 6
1.1 Glossary 6
1.2 References 6
1.2.1 Normative References 7
1.2.2 Informative References 7
1.3 Overview 7
1.4 Relationship to Other Protocols 8
1.5 Prerequisites/Preconditions 8
1.6 Applicability Statement 8
1.7 Versioning and Capability Negotiation 8
1.8 Vendor-Extensible Fields 8
1.9 Standards Assignments 8
2 Messages 9
2.1 Transport 9
2.2 Message Syntax 9
2.2.1 NetBIOS Name Syntax 9
2.2.2 MULTIHOMED NAME REGISTRATION REQUEST 9
2.2.3 LMHOSTS File Syntax 9
2.2.3.1 Predefined Keywords in LMHOSTS File 10
2.2.3.2 Creating Lmhosts Entries for Specific NetBIOS Names 10
3 Protocol Details 12
3.1 NetBIOS End Node Details 12
3.1.1 Abstract Data Model 12
3.1.2 Timers 12
3.1.3 Initialization 13
3.1.4 Higher-Layer Triggered Events 13
3.1.4.1 Registering a NetBIOS Name 13
3.1.4.2 Resolving a NetBIOS Name 14
3.1.4.2.1 NBNS Selection 14
3.1.5 Message Processing Events and Sequencing Rules 14
3.1.5.1 Handling a NAME REGISTRATION REQUEST 14
3.1.6 Timer Events 15
3.1.7 Other Local Events 15
3.1.8 Using the LMHOSTS File to Resolve a Name Query 15
3.1.8.1 Using a #include LMHOSTS File 16
3.1.8.2 Alternate Block Processing 16
3.2 NBNS Details 16
3.2.1 Abstract Data Model 16
3.2.2 Timers 16
3.2.3 Initialization 16
3.2.4 Higher-Layer Triggered Events 16
3.2.5 Message Processing Events and Sequencing Rules 16
3.2.5.1 Handling a NAME REGISTRATION REQUEST (GROUP) 17
3.2.5.2 Handling a MULTIHOMED NAME REGISTRATION REQUEST (GROUP) 17
3.2.5.3 Handling a MULTIHOMED NAME REGISTRATION REQUEST (UNIQUE) 17
3.2.6 Timer Events 17
3.2.7 Other Local Events 17
4 Protocol Examples 18
4.1 NetBIOS Registration Example 18
4.2 LMHOSTS File Example 20
5 Security Considerations 21
5.1 Security Considerations for Implementers 21
5.2 Index of Security Parameters 21
6 Appendix A: Product Behavior 22
7 Change Tracking 24
8 Index 26
1 Introduction
The NetBIOS over TCP (NBT, or sometimes NetBT) Extensions specify the extensions to the NetBIOS over TCP (NBT) protocol, as specified in [RFC1001] and [RFC1002]. These extensions modify the syntax of allowable NetBIOS names and the behavior of timers, and add support for multihomed hosts.
Sections 1.8, 2, and 3 of this specification are normative and can contain the terms MAY, SHOULD, MUST, MUST NOT, and SHOULD NOT as defined in [RFC2119]. Sections 1.5 and 1.9 are also normative but do not contain those terms. All other sections and examples in this specification are informative.
1.1 Glossary
The following terms are specific to this document:
code page: An ordered set of characters of a specific script in which a numerical index (code-point value) is associated with each character. Code pages are a means of providing support for character sets (1) and keyboard layouts used in different countries. Devices such as the display and keyboard can be configured to use a specific code page and to switch from one code page (such as the United States) to another (such as Portugal) at the user's request.
group name: A 16-byte, formatted NetBIOS computer name, which can have multiple IP addresses assigned to it; that is, multiple NetBIOS nodes (processor locations) can use this name to register for services, as specified in [RFC1001] and [RFC1002].
Internet host name: The name of a host as defined in [RFC1123] section 2.1, with the extensions described in [MS-HNDS].
LMHOST: A text file that contains entries that individually map a computer name or a NetBIOS service name to an IPv4 address. The LMHOST file is consulted when normal NetBIOS name resolution protocols fail on the wire. This legacy file is no longer installed by default on Windows systems. LM stands for "LAN Manager".
multihomed: Having two or more network interfaces on which NetBIOS over TCP is enabled.
NBT: See NetBIOS over TCP/IP (NBT).
NetBIOS name: A 16-byte address that is used to identify a NetBIOS resource on the network. For more information, see [RFC1001] and [RFC1002].
NetBIOS Name Server (NBNS): A server that stores NetBIOS name-to-IPv4 address mappings and that resolves NetBIOS names for NBT-enabled hosts. A server running the Windows Internet Name Service (WINS) is the Microsoft implementation of an NBNS.
unique name: A 16-byte, formatted NetBIOS computer name that can have only one IP address assigned to it; that is, only a single NetBIOS node (or processing location) can use this name to register for services, as specified in [RFC1001] and [RFC1002].
Universal Naming Convention (UNC): A string format that specifies the location of a resource. For more information, see [MS-DTYP] section 2.2.57.
MAY, SHOULD, MUST, SHOULD NOT, MUST NOT: These terms (in all caps) are used as defined in [RFC2119]. All statements of optional behavior use either MAY, SHOULD, or SHOULD NOT.
1.2 References
Links to a document in the Microsoft Open Specifications library point to the correct section in the most recently published version of the referenced document. However, because individual documents in the library are not updated at the same time, the section numbers in the documents may not match. You can confirm the correct section numbering by checking the Errata.
1.2.1 Normative References
We conduct frequent surveys of the normative references to assure their continued availability. If you have any issue with finding a normative reference, please contact . We will assist you in finding the relevant information.
[HYBRID] Noon, F., "HYBRID NETBIOS END-NODES", April 1993, http://tools.ietf.org/id/draft-noon-hybrid-netbios-01.txt
[MS-DTYP] Microsoft Corporation, "Windows Data Types".
[RFC1001] Network Working Group, "Protocol Standard for a NetBIOS Service on a TCP/UDP Transport: Concepts and Methods", RFC 1001, March 1987, http://www.ietf.org/rfc/rfc1001.txt
[RFC1002] Network Working Group, "Protocol Standard for a NetBIOS Service on a TCP/UDP Transport: Detailed Specifications", STD 19, RFC 1002, March 1987, http://www.rfc-editor.org/rfc/rfc1002.txt
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997, http://www.rfc-editor.org/rfc/rfc2119.txt
[RFC2132] Alexander, S., and Droms, R., "DHCP Options and BOOTP Vendor Extensions", RFC 2132, March 1997, http://www.ietf.org/rfc/rfc2132.txt
1.2.2 Informative References
[MSKB-163409] Microsoft Corporation, "NetBIOS Suffixes (16th Character of the NetBIOS Name)", Version 4.2, February 2007, http://support.microsoft.com/kb/163409
[RFC1035] Mockapetris, P., "Domain Names - Implementation and Specification", STD 13, RFC 1035, November 1987, http://www.ietf.org/rfc/rfc1035.txt
[RFC4795] Aboba, B., Thaler, D., and Esibov, L., "Link-Local Multicast Name Resolution (LLMNR)", RFC 4795, January 2007, http://www.ietf.org/rfc/rfc4795.txt
1.3 Overview
NetBIOS resources are referenced by NetBIOS name. An application, representing a resource, registers one or more NetBIOS names that it uses to communicate with other hosts on the network. This document does the following:
- It discusses NetBIOS name registration and name querying on hosts with more than one interface.
- When a NetBIOS Name Server (NBNS) receives a registration for a group name, [RFC1002] section 5.1.4.1 requires that the NBNS replace any existing entry with the new entry, so that only one IP address can be registered for a group name. However, a group name is one that can be owned by any number of nodes. This document modifies the behavior of group name registrations to allow the NBNS to keep multiple addresses as originally intended.
- Defines the format of the LMHOSTS file and when it is accessed. The LMHOSTS file is read on two separate occasions. At the initialization of the NetBIOS system, LMHOSTS is read to initialize the local name cache with the entries that are labeled "#PRE". During NetBIOS name resolution, if the name cannot be resolved from the local name cache or by using the normal NetBIOS protocol name resolutions, then the NetBIOS name resolution process system can be configured to scan the LMHOSTS file on a per-query basis, looking for entries that resolve the query.
1.4 Relationship to Other Protocols
A NetBIOS name may or may not be derived from an Internet host name. The syntax for an Internet host name is much more constrained than the syntax for an arbitrary NetBIOS name. Therefore, it is possible to derive a NetBIOS name from a given Internet host name, but not necessarily vice versa.
The NetBIOS name service is used to resolve names within a local subnet, and is also used to resolve names within a larger network using an NBNS. However, it is only defined for IPv4. As such, its use for name resolution has largely been superseded by newer protocols, such as the Link-Local Multicast Name Resolution (LLMNR) Protocol [RFC4795] and the Domain Name System (DNS) [RFC1035].
1.5 Prerequisites/Preconditions
The prerequisites and preconditions are unchanged from [RFC1001] and [RFC1002].
1.6 Applicability Statement
This extension is applicable for discovering the IPv4 addresses of resources.
1.7 Versioning and Capability Negotiation
There is no versioning or localization support in this extension.
1.8 Vendor-Extensible Fields
It is important to understand that the choice of name used by a higher-layer protocol or application is up to that protocol or application and not NBT. As such, this section provides a convention for use by higher-layer protocols and applications, but the extensions in this document do not enforce the use of this convention.