Editing NetBIOS

{{Short description|API allowing applications on separate computers to communicate over LAN via the session layer}}
{{Redirect2|NetBEUI|NetBIOS Enhanced User Interface|specifically the protocol available in Microsoft Windows|NetBIOS Frames|details|#NetBEUI}}
{{Redirect|Network Basic Input/Output System|the Network I/O System|NIOS (Digital Research)}}
<!-- The term "NetBEUI" is unusually problematic and actually does redirect here. Please, do not remove the hatnote without discussion. -->
{{Multiple issues|
{{more footnotes|date=August 2012}}
{{Technical|date=September 2010}}
}}

{{Use dmy dates|date=July 2020}}

'''NetBIOS''' ({{IPAc-en|ˈ|n|ɛ|t|b|aɪ|ɒ|s}}) is an acronym for '''Network Basic Input/Output System'''. It provides services related to the [[session layer]] of the [[OSI model]] allowing applications on separate computers to communicate over a [[local area network]]. As strictly an [[API]], NetBIOS is not a [[networking protocol]]. [[Operating system]]s of the 1980s (DOS and Novell Netware primarily) ran NetBIOS over [[IEEE 802.2]] and [[IPX/SPX]] using the [[NetBIOS Frames]] (NBF) and [[NetBIOS over IPX/SPX]] (NBX) protocols, respectively. In modern networks, NetBIOS normally runs over [[TCP/IP]] via the [[NetBIOS over TCP/IP]] (NBT) protocol. NetBIOS is also used for identifying system names in TCP/IP (Windows).

==History and terminology==
NetBIOS is an operating system-level API that allows applications on computers to communicate with one another over a [[local area network]] (LAN). The API was created in 1983 by [[Sytek Inc]]. for software communication over [[IBM PC Network]] LAN technology.<ref name="barrie"/> On [[IBM PC Network]], as an API alone, NetBIOS relied on proprietary Sytek networking protocols for communication over the wire.<ref>{{Cite web |title=10. Assessing Windows Networking Services - Network Security Assessment, 2nd Edition [Book] |url=https://www.oreilly.com/library/view/network-security-assessment/9780596510305/ch10.html |access-date=2023-04-20 |website=www.oreilly.com |language=en |archive-date=20 April 2023 |archive-url=https://web.archive.org/web/20230420121049/https://www.oreilly.com/library/view/network-security-assessment/9780596510305/ch10.html |url-status=live }}</ref>

{{anchor|NetBEUI}}In 1985, IBM went forward with the [[Token Ring]] network scheme and produced an [[emulator]] of Sytek's NetBIOS API to allow NetBIOS-aware applications from the PC-Network era to work over IBM's new Token Ring hardware. This IBM emulator, named NetBIOS Extended User Interface (NetBEUI), expanded the base NetBIOS API created by Sytek with, among other things, the ability to deal with the greater node capacity of Token Ring. A new networking protocol, [[NetBIOS Frames|NBF]], was simultaneously produced by IBM to allow its NetBEUI API (their enhanced NetBIOS API) to provide its services over Token Ring – specifically, at the [[IEEE 802.2]] [[Logical Link Control]] layer.

In 1985, [[Microsoft]] created its own implementation of the NetBIOS API for its [[MS-Net]] networking technology. As in the case of IBM's Token Ring, the services of Microsoft's NetBIOS implementation were provided over the IEEE 802.2 Logical Link Control layer by the NBF protocol.<ref>{{Cite web |title=Getaway hardware for protocols |url=https://www.networking-hardware.com/juniper/service-gateway |access-date=2023-04-20 |website=www.networking-hardware.com |archive-date=26 March 2023 |archive-url=https://web.archive.org/web/20230326062716/https://www.networking-hardware.com/juniper/service-gateway |url-status=live }}</ref> However, the MS-Net was only delivered to [[Original equipment manufacturer|OEM]]s, and it was actually not a complete product, nor was it ready to communicate on the network in the form it was distributed. It lacked any implementation of [[OSI model|OSI]] Layers 1 to 4 ([[Physical layer|Physical]], [[Data link layer|Data link]], [[Network layer|Network]] and [[Transport layer|Transport]] Layers) and an OEM was expected to provide these implementations (in the form of a NetBIOS part) to make its version of MS-Net a complete and ready to use product. MS-Net accessed the network through the Microsoft's own variant of NetBIOS, which was split into two parts - the lower level part that OEMs had to provide implemented the NetBIOS calls that depended on layers 1-4, while the higher level part, provided by Microsoft, was hardware- and protocol-independent. This NetBIOS implementation supported the full NetBIOS API, but was called by invoking [[x86]] interrupt 0x2A, instead of IBM's standard interrupt 0x5C. The reliance on OEMs to implement parts of NetBIOS had the unfortunate side effect that different OEM versions of MS-Net and NetBIOS generally weren't able to communicate with one another. <ref>{{Cite web |title=Early Microsoft Networks {{!}} OS/2 Museum |url=http://www.os2museum.com/wp/early-microsoft-networks/ |access-date=2024-09-04 |language=en-US}}</ref> 

In 1986, [[Novell]] released Advanced [[Novell NetWare]] 2.0 featuring the company's own emulation of the NetBIOS API. Its services were encapsulated within NetWare's [[IPX/SPX]] protocol using the [[NetBIOS over IPX/SPX]] (NBX) protocol.

In 1987, a method of encapsulating NetBIOS in [[Transmission Control Protocol|TCP]] and [[User Datagram Protocol|UDP]] packets, [[NetBIOS over TCP/IP]] (NBT), was published. It was described in RFC 1001 ("Protocol Standard for a NetBIOS Service on a TCP/UDP Transport: Concepts and Methods") and RFC 1002 ("Protocol Standard for a NetBIOS Service on a TCP/UDP Transport: Detailed Specifications"). The NBT protocol was developed in order to "allow an implementation [of NetBIOS applications] to be built on virtually any type of system where the TCP/IP protocol suite is available," and to "allow NetBIOS interoperation in the Internet."

After the [[IBM PS/2|PS/2]] computer hit the market in 1987, IBM released the PC LAN Support Program, which included a driver offering the NetBIOS API.

There is some confusion between the names NetBIOS and NetBEUI. NetBEUI originated strictly as the [[moniker]] for IBM's enhanced 1985 NetBIOS emulator for Token Ring. The name NetBEUI should have died there, considering that at the time, the NetBIOS implementations by other companies were known simply as NetBIOS regardless of whether they incorporated the API extensions found in Token Ring's emulator. For MS-Net, however, Microsoft elected to name its implementation of the NBF protocol "NetBEUI" – naming its implementation of the transport protocol after IBM's enhanced version of the API.{{cn|date=June 2023|reason=A source needed to support the alleged controversy that the protocol implemented by NetBIOS emulator over 802.2 would be different between Token Ring and Ethernet networks.}} Consequently Microsoft file and printer sharing over [[Ethernet]] often continues to be called NetBEUI, with the name NetBIOS commonly used only in reference to file and printer sharing over [[TCP/IP]]. More accurately, the former is [[NetBIOS Frames]] (NBF), and the latter is [[NetBIOS over TCP/IP]] (NBT).

Since its original publication in a technical reference book from IBM, the NetBIOS API specification has become a [[de facto standard|''de facto'' standard]] in the industry despite originally supporting a maximum of only 80 PCs in a LAN.  This limitation was generally overcome industry-wide through the transition from NBF to NBT, under which, for example, Microsoft was able to switch to [[Domain Name System]] (DNS) for resolution of NetBIOS [[hostname]]s, having formerly used the LAN segment-compartmentalized NBF protocol itself to resolve such names in Windows [[Client–server model|client-server networks]].<ref name="barrie"/>

==Services==
NetBIOS provides three distinct services:
*Name service (NetBIOS-NS) for name registration and [[Name resolution (computer systems)|resolution]].
*[[Datagram]] distribution service (NetBIOS-DGM) for connectionless communication.
*[[Session (computer science)|Session]] service (NetBIOS-SSN) for [[connection-oriented communication]].

(Note: [[Server Message Block|SMB]], an upper layer, is a service that runs on top of the Session Service and the Datagram service, and is not to be confused as a necessary and integral part of NetBIOS itself. It can now run atop TCP with a small adaptation layer that adds a length field to each SMB message; this is necessary because TCP only provides a byte-stream service with no notion of message boundaries.)

===Name service===
In order to start sessions or distribute datagrams, an application must register its NetBIOS name using the name service. NetBIOS names are 16 octets in length and vary based on the particular implementation. Frequently, the 16th octet, called the NetBIOS Suffix, designates the type of resource, and can be used to tell other applications what type of services the system offers.{{cn|date=June 2023|reason=Unclear from text what is meant by "octets". Possibly confuses octets with bytes.}} In [[NetBIOS over TCP/IP|NBT]], the name service operates on UDP port 137 (TCP port 137 can also be used, but rarely is).

The name service primitives offered by NetBIOS are:
*Add name – registers a NetBIOS name.
*Add group name – registers a NetBIOS "group" name.
*Delete name – un-registers a NetBIOS name or group name.
*Find name – looks up a NetBIOS name on the network.

[[IPv6|Internet Protocol Version 6 (IPv6)]] are not supported by the NetBIOS name resolution protocol.<ref>{{cite web |title=[MS-WPO]: WINS Management Protocol |url=https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wpo/26b6d27b-7470-4a0d-bcfc-88670c6c50d4 |website=learn.microsoft.com |language=en-us |date=14 February 2019 |quote=Because the NetBIOS protocol, defined in [RFC1002], does not support the mapping between NetBIOS names and IPv6 addresses, the Remote Administrative Interface: WINS protocol applies only to IPv4 addresses. It does not apply to IPv6 addresses. |access-date=17 June 2023 |archive-date=17 June 2023 |archive-url=https://web.archive.org/web/20230617123311/https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wpo/26b6d27b-7470-4a0d-bcfc-88670c6c50d4 |url-status=live }}</ref>

===Datagram distribution service===
Datagram mode is [[connectionless]]; the application is responsible for error detection and recovery. In [[NetBIOS over TCP/IP|NBT]], the datagram service runs on UDP port 138.

The datagram service primitives offered by NetBIOS are:
*Send Datagram – send a datagram to a remote NetBIOS name.
*Send Broadcast Datagram – send a datagram to all NetBIOS names on the network.
*Receive Datagram – wait for a packet to arrive from a Send Datagram operation.
*Receive Broadcast Datagram – wait for a packet to arrive from a Send Broadcast Datagram operation.

===Session service===
Session mode lets two computers establish a connection, allows messages to span multiple packets, and provides error detection and recovery. In [[NetBIOS over TCP/IP|NBT]], the session service runs on TCP port 139.

The session service primitives offered by NetBIOS are:
*Call – opens a session to a remote NetBIOS name.
*Listen – listen for attempts to open a session to a NetBIOS name.
*Hang Up – close a session.
*Send – sends a packet to the computer on the other end of a session.
*Send No Ack – like Send, but doesn't require an acknowledgment.
*Receive – wait for a packet to arrive from a Send on the other end of a session.

In the original protocol used to implement NetBIOS services on PC-Network, to establish a session, the initiating computer sends an Open request which is answered by an Open acknowledgment. The computer that started the session will then send a Session Request packet which will prompt either a Session Accept or Session Reject packet.

During an established session, each transmitted packet is answered by either a positive-acknowledgment (ACK) or negative-acknowledgment (NAK) response. A NAK will prompt retransmission of the data. Sessions are closed by the non-initiating computer by sending a close request. The computer that started the session will reply with a close response which prompts the final session closed packet.

==NetBIOS name vs Internet host name==
When NetBIOS is run in conjunction with [[Internet protocol suite|Internet protocol]]s (e.g., NBT), each computer may have multiple names: one or more NetBIOS name service names and one or more Internet host names.

===NetBIOS name===
The NetBIOS name is 16 ASCII characters, however Microsoft limits the host name to 15 characters and reserves the 16th character as a NetBIOS Suffix.<ref name="MS"/> This suffix describes the service or name record type such as host record, master browser record, or domain controller record or other services. The host name (or short host name) is specified when Windows networking is installed/configured, the suffixes registered are determined by the individual services supplied by the host. In order to connect to a computer running TCP/IP via its NetBIOS name, the name must be resolved to a [[network address]]. Today this is usually an [[IP address]] (the NetBIOS name to IP address resolution is often done by either broadcasts or a [[Windows Internet Name Service|WINS]] Server – NetBIOS Name Server). A computer's NetBIOS name is often the same as that computer's host name (see below), although truncated to 15 characters, but it may also be completely different.

NetBIOS names are a sequence of alphanumeric characters. The following characters are explicitly not permitted: <samp>\/:*?"<>|</samp>. Since Windows 2000, NetBIOS names also had to comply with restrictions on DNS names: they cannot consist entirely of digits, and the hyphen ("-") or full-stop (".") characters may not appear as the first or last character. Since Windows 2000, Microsoft has advised against including any full-stop (".") characters in NetBIOS names, such that applications can use the presence of a full-stop to distinguish domain names from NetBIOS names.<ref name="MS"/>

The Windows [[LMHOSTS]] file provides a NetBIOS name resolution method that can be used for small networks that do not use a WINS server.

===Internet host name===
A Windows machine's NetBIOS name is not to be confused with the computer's Internet host name (assuming that the computer is also an Internet host in addition to being a NetBIOS node, which need not necessarily be the case). Generally a computer running Internet protocols (whether it is a Windows machine or not) usually has a host name (also sometimes called a machine name). Originally these names were stored in and provided by a [[hosts (file)|hosts file]] but today most such names are part of the hierarchical [[Domain Name System]] (DNS).

Generally the host name of a Windows computer is based on the NetBIOS name plus the Primary DNS Suffix, which are both set in the System Properties dialog box. There may also be connection-specific suffixes which can be viewed or changed on the DNS tab in Control Panel → Network → TCP/IP → Advanced Properties. Host names are used by [[Application layer|applications]] such as [[telnet]], [[ftp]], [[web browser]]s, etc. To connect to a computer running the TCP/IP protocol using its name, the host name must be resolved into an [[IP address]], typically by a DNS server. (It is also possible to operate many TCP/IP-based applications, including the three listed above, using only IP addresses, but this is not the norm.)

==Node types==
Under Windows, the '''node type''' of a networked [[computer]] relates to the way it resolves NetBIOS names to [[IP address]]es. This assumes that there are any IP addresses for the NetBIOS nodes, which is assured only when NetBIOS operates over NBT; thus, node types are not a property of NetBIOS per se but of interaction between NetBIOS and TCP/IP in the Windows OS environment. There are four node types.
*B-node: 0x01 Broadcast
*P-node: 0x02 Peer (WINS only)
*M-node: 0x04 Mixed (broadcast, then WINS)
*H-node: 0x08 Hybrid (WINS, then broadcast)

The node type in use is displayed by opening a [[command line]] and typing ''ipconfig /all''.
A [[Microsoft Windows|Windows]] computer registry may also be configured in such a way as to display "unknown" for the node type.

==NetBIOS Suffixes==
The NetBIOS Suffix, alternately called the NetBIOS End Character (endchar), is the 16th character of a NetBIOS name and indicates service type for the registered name. The number of record types is limited to 255; some commonly used values are:

For unique names:
*00: Workstation Service (workstation name)
*03: [[Windows Messenger service]]
*06: [[Remote Access Service]]
*20: [[File server|File Service]] (also called Host Record)
*21: [[Remote Access Service]] client
*1B: [[Windows Server domain|Domain]] Master [[Browser service|Browser]] – Primary Domain Controller for a domain
*1D: Master Browser

For group names:
*00: Workstation Service (workgroup/domain name)
*1C: [[Domain controller|Domain Controllers]] for a domain (group record with up to 25 IP addresses)
*1E: Browser Service Elections

== Protocol stack ==
The following table shows a brief history of NetBIOS and its related protocols. [[Server Message Block|SMB]] was the main protocol that used NetBIOS. SMB enables Windows File and Printer Sharing.
{| class="wikitable"
|+
|7
|[[Application layer]]
| rowspan="2" |
|[[Windows Chat]], [[ClipBook Viewer]], [[Microsoft Hearts]]
| rowspan="2" |SMB
| rowspan="2" |SMB
| rowspan="2" |SMB
| rowspan="3" |SMB
| rowspan="3" |SMB
|-
|6
|[[Presentation layer]]
|[[NetDDE]]
|-
|5
|[[Session layer]]
| rowspan="4" |NetBIOS (The original "Network Basic Input/Output System")
| colspan="2" rowspan="3" |NetBIOS ([[NetBIOS Frames]], incorrectly labeled as "NetBEUI" in Windows)
|NetBIOS (NetBIOS over IPX/SPX)
|NetBIOS ([[NetBIOS over TCP/IP]])
|-
|4
|[[Transport layer]]
|[[IPX/SPX]]
|[[Transmission Control Protocol|TCP]]/[[User Datagram Protocol|UDP]]
|[[Transmission Control Protocol|TCP]]/[[User Datagram Protocol|UDP]]
|[[QUIC]] (over [[User Datagram Protocol|UDP]])
|-
|3
|[[Network layer]]
|[[Internetwork Packet Exchange|IPX]]
|[[Internet Protocol|IP]]
|[[Internet Protocol|IP]]
|[[Internet Protocol|IP]]
|-
|2
|[[Data link layer]]
| colspan="2" |[[IEEE 802.2]] on [[Ethernet]], [[Token Ring]]
|Any link that carries IPX
|Any link that carries IP
|Any link that carries IP
|Any link that carries IP
|-
|1
|[[Physical layer]]
|[[IBM PC Network]]
| colspan="2" |[[Ethernet]], [[Token Ring]]
|
|
|
|
|-
| colspan="2" |First supported
|
| colspan="2" |Windows for Workgroups 3.1
|Windows for Workgroups 3.1
|Windows NT 3.5
|Windows 2000
|Windows 11 (Server side requires Windows Server 2022 Datacenter: Azure Edition)
|-
| colspan="2" |Last supported
|
| colspan="2" |Windows XP (requires manual install)
|Windows XP
|
|
|
|}

==See also==
*[[NetBIOS over TCP/IP]] (NBT)
*[[NetBIOS Frames]] (NBF)
*[[Server Message Block]] (SMB)

==References==
{{Reflist|refs=
<ref name="barrie">{{Cite book |title=Networking Bible |url=https://archive.org/details/networkingbible0000sosi |url-access=limited |author-last=Sosinsky |author-first=Barrie |publisher=[[John Wiley & Sons]] |date=2009 |isbn=9780470543429 |pages=[https://archive.org/details/networkingbible0000sosi/page/528/mode/2up 528]}}</ref>
<ref name="MS">{{cite web |title=Naming conventions in Active Directory for computers, domains, sites, and OUs |publisher=[[Microsoft]] |url=https://support.microsoft.com/en-us/help/909264/naming-conventions-in-active-directory-for-computers-domains-sites-and |access-date=2017-12-19 |archive-date=22 December 2017 |archive-url=https://web.archive.org/web/20171222054350/https://support.microsoft.com/en-us/help/909264/naming-conventions-in-active-directory-for-computers-domains-sites-and |url-status=live }}</ref>
}}

==Further reading==
* Haugdahl, J. Scott (1990). ''Inside NetBIOS''. Architecture Technology Corp. {{ISBN|99914-57-34-8}}
* Silberschatz, Abraham; Galvin, Peter Baer; Gagne, Greg (2004). ''Operating System Concepts''. (7th Ed.). John Wiley & Sons. {{ISBN|0-471-69466-5}}
* Meyers, Michael (2004). "Managing and Troubleshooting Networks". McGraw-Hill. {{ISBN|978-0-07-225665-9}}
* Tamara Dean. ''Network+ Guide to Networks'', pg. 206 (NetBEUI)

==External links==
* [//publib.boulder.ibm.com/cgi-bin/bookmgr_OS390/BOOKS/BK8P7001/CCONTENTS LAN Technical Reference: 802.2 and NetBIOS APIs]
* [http://ubiqx.org/cifs Implementing CIFS] (from the [[Samba software|Samba]] team, published under the [[Open Publication License]])
* [http://timothydevans.me.uk/n2c.html NetBIOS, NetBEUI, NBF, SMB, CIFS Networking]
* [https://web.archive.org/web/20090503083915/http://ourworld.compuserve.com/homepages/timothydevans/osi.htm Open Systems Interconnection (OSI) Reference Model for NBF, NBT, and NBX]
*[https://web.archive.org/web/20081207101027/http://www.microsoft.com/technet/prodtechnol/windows2000serv/reskit/cnet/cnfd_lmh_qxqq.mspx?mfr=true LMHOSTS File]
* [https://www.betaarchive.com/wiki/index.php/Microsoft_KB_Archive/163409 NETBIOS End Characters / Suffixes] – Microsoft Knowledge Base article describing list of NetBIOS Suffixes.
* [https://web.archive.org/web/20141025202805/http://www.coderbliss.com/2014/10/24/windows-7-netbios-library-in-visual-basic/ Windows 7 NetBIOS Library in Visual Basic - Coder Bliss – Jon Reedholm].
* {{cite web |url=http://samba.anu.edu.au/cifs/docs/what-is-smb.html |title=Just what is SMB? |author=Richard Sharpe |date=8 October 2002 |access-date=1 January 2012 |archive-url=https://web.archive.org/web/20091202045224/http://samba.anu.edu.au/cifs/docs/what-is-smb.html |archive-date=2 December 2009 |url-status=dead }}

{{Authority control}}

{{DEFAULTSORT:Netbios}}
[[Category:Network protocols]]