Sieci Komputerowe  Laboratorium (2013)
Maksymalne dopuszczalne rozmiary pakietów danych w NetBIOS:
- Komunikacja za pomocą sesji umożliwia przesłanie w pakiecie do 64kb danych
- Komunikacja za pomocą datagramów umożliwia przesłanie w pakiecie do 512 bajtów danych
Budowa struktury NCB:
Pole struktury Typ danych Opis
ncb_command (COMMAND) byte Określa rodzaj używanej funkcji (reset, addname, deletename, itd.) w
postaci stałej (język C) lub liczby (Pascal)
byte Zwraca wynik działania określonej funkcji. Zwraca 0 w przypadku
ncb_retcode (RETCODE)
poprawnego wywołania, w razie błędu zwraca pewną wartość, która
określa konkretny typ błędu
ncb_lsn (LSN) byte Określa numer lokalnej sesji przydzielonej przez NetBIOS przy
ustanowieniu sesji. Wartość ta zwracana jest przez CALL i LISTEN i musi
być podana w funkcjach SEND i RECEIVE. Wartością tego pola mogą być
liczby z przedziału 1-254
ncb_num (NUM) byte Pole określające numer węzła NetBIOS. Zwracane jest przez funkcję
ADDNAME i wykorzystywane jest we wszystkich funkcjach odbierających
datagramy (RECEIVE). Wartością tego pola mogą być liczby z przedziału
1-254
ncb_buffer (BUFADR) pointer Wskaz
nik (adres) na wiadomość, która ma zostać wysłana lub odebrana
ncb_length (BUFLEN) word Określa długość bufora wiadomości (w bajtach). W funkcjach odbioru
(RECEIVE) ustawia się to pole na maksymalną wartość (z reguły nie
wiemy jak długą wiadomość nadawca chce nam dostarczyć), a po
wykonaniu funkcji pole to określa dokładny rozmiar odebranej
wiadomości w bajtach
ncb_callname (CALLNAME) array [1..16] of byte Pole określające nazwę węzła komputera z którym chcemy się połączyć
(zwykle jest to nazwa nadawcy) wykorzystywane w funkcjach CALL,
LISTEN oraz w datagramach (RECEIVE). W przypadku użycia funkcji CHAIN
SEND pierwsza połowa pola określa rozmiar bufora odbioru, a druga
połowa jego adres. Wszystkie bajty muszą być wykorzystane.
ncb_name (NAME) array [1..16] of byte Określa nazwę węzła NetBIOS wykorzystywanego np. w funkcji ADD
NAME, DELETE NAME lub innych funkcjach.
ncb_rto (RTO) byte Określa czas na odbiór wiadomości (Receive Time-Out). Jednostką jest
pół sekundy czyli np. ustawienie tego pola na 1 bajt powoduje określenie
czasu odbioru na 0.5 sekundy. Po upłynięciu czasu funkcja odbioru
zwraca odpowiedni błąd. W ramach trwania sesji wartość ta pozostaje
stała. Pola te muszą być użyte w funkcjach CALL i LISTEN (jeśli nie chcemy
ustawiać czasu na odbiór, ustawiamy te pola na wartość 0)
ncb_sto (STO) byte Określa czas na wysłanie wiadomości (Send Time-Out). Jednostką jest pół
sekundy czyli np. ustawienie tego pola na 1 bajt powoduje określenie
czasu wysłania na 0.5 sekundy. Po upłynięciu czasu funkcja wysyłająca
zwraca odpowiedni błąd i sesja zostaje zerwana. W ramach trwania sesji
wartość ta pozostaje stała. Pola te muszą być użyte w funkcjach CALL i
LISTEN (jeśli nie chcemy ustawiać czasu na wysłanie, ustawiamy te pola
na wartość 0)
ncb_post (POST) pointer Pole wykorzystywane jedynie w trybie asynchronicznym (no-wait mode).
Przechowuje adres przerwania funkcji po jej poprawnym wykonaniu.
ncb_lana_num (LANA_NUM) byte Pole określające numer karty sieciowej komputera. W zależności od ilości
kart sieciowych danego komputera pole to przyjmuje różne wartości.
Zwykle pole to ma wartość 0 (jedna lokalna karta sieciowa). Pole
wykorzystywane w niemal każdej funkcji (RESET, ADDNAME,
DELETENAME itd.)
ncb_cmd_cplt (CMD_DONE) byte Pole to jest ustawiane w momencie wywołania funkcji. Wartość FF
określa, że dana funkcja się nie wykonała. W przypadku wykonania
funkcji pole to przyjmuje identyczną wartość jak RET_CODE czyli 0 jeśli
pomyślnie lub nr błędu w pozostałych przypadkach.
ncb_reserved (RES) array [1..14] of byte Pole zarezerwowane. Nie powinno być używane.
Wait mode  tryb synchroniczny (z odczekiwaniem)  tryb używany na laboratorium
No-wait mode  tryb asynchroniczny (bez odczekiwania)
Sieci Komputerowe  Laboratorium (2013)
DODAWANIE W
ZA
A  schemat ogólny (Lab2)
1. Reset węzła Netbios (RESET).
2. Pobranie łańcucha tekstowego od użytkownika (nazwa dla węzła).
3. Dodanie nazwy jako unikatowej (ADDNAME).
4. Wstrzymanie działania programu do momentu naciśnięcia dowolnego klawisza przez użytkownika (w tym momencie
polecenie  nbtstat -n wydane w wierszu poleceń powinno wyświetlić dodaną nazwę)
5. Usunięcie dodanej nazwy (DELETENAME)
BROADCAST (DATAGRAM)  schemat ogólny (Lab 2)
1. Reset węzła Netbios (RESET)  nadawca i odbiorca.
2. Pobranie łańcucha tekstowego od użytkownika (nazwa dla węzła)  nadawca i odbiorca.
3. Dodanie nazwy jako unikatowej (ADDNAME)  nadawca i odbiorca.
4. Pobranie łańcucha tekstowego od użytkownika (komunikat do wysłania)  nadawca.
5. Wysłanie datagramu (SENDBROADCASTDATAGRAM)  nadawca, odbiór datagramu (RECEIVEBROADCASTDATAGRAM) 
odbiorca.
6. Wyświetlenie odebranego komunikatu  odbiorca.
7. Usunięcie dodanej nazwy (DELETENAME)  nadawca i odbiorca.
MULTICAST i UNICAST (DATAGRAM)  schemat ogólny (Lab 4)
1. Reset węzła Netbios (RESET)  nadawca i odbiorca.
2. Pobranie łańcucha tekstowego od użytkownika (nazwa dla węzła)  nadawca i odbiorca.
3. Dodanie nazwy:
a) jako unikatowej (ADDNAME)  nadawca i odbiorca - transmisja unicast.
b) jako unikatowej (ADDNAME  nadawca) i jako grupowej (ADDGROUPNAME  odbiorca)  transmisja multicast.
4. Pobranie łańcucha tekstowego od użytkownika (komunikat do wysłania) oraz nazwy odbiorcy (adresata wysyłki, patrz pkt.3) 
nadawca.
5. Wysłanie datagramu (SENDDATAGRAM)  nadawca, odbiór datagramu (RECEIVEDATAGRAM)  odbiorca.
6. Wyświetlenie odebranego komunikatu  odbiorca.
7. Usunięcie dodanej nazwy (DELETENAME)  nadawca i odbiorca.
SESJA  schemat ogólny (Lab 5)
1.Dodanie unikalnych nazw nadawcy i odbiorcy do lokalnej tabeli nazw NetBIOSu - ADD NAME.
2.Nawiązanie logicznego połączenia (sesji) - CALL (nadawca) i LISTEN (odbiorca).
3.Transfer komunikatów/danych - SEND (nadawca) i RECEIVE (odbiorca).
4.Zakończenie/rozwiązanie sesji - HANG UP (nadawca lub odbiorca).
5.Usunięcie nazw nadawcy i odbiorcy z lokalnej tabeli nazw NetBIOSu - DELETE NAME.
Opis poszczególnych funkcji NetBIOS:
RESET COMMAND
Przyjmuje Zwraca
ncb_command := $32; ResetAdapter := ncb_retcode;
ncb_lana_num := NCBLANANUM; CMD_Done := ncb_cmd_cplt;
ncb_lsn := 1; (dot. tylko sesji, max. 32)
ncb_num := NCBNUM; (liczba poleceń do obsługi w danym
czasie  zwykle 1, max. 32)
Implementacja: Uwagi:
Po wywołaniu tej funkcji wszystkie dotychczas
istniejące nazwy węzłów oraz sesje NetBIOS
zostaną zlikwidowane.
Funkcja ta powinna być wywoływana przed
rozpoczęciem nawiązywania komunikacji za
pomocą pseudoprotokołu NetBIOS.
Za pomocą tej funkcji możemy ponadto
skonfigurować parametry naszego połączenia
(liczba wspieranych sesji 1-32, ilość funkcji
obsługiwanych w jednym czasie 1-32).
Sieci Komputerowe  Laboratorium (2013)
ADD NAME COMMAND
Przyjmuje Zwraca
ncb_command := $30; NCBNUM := ncb_num; {numer węzła pomiędzy 1-254}
ncb_lana_num := NCBLANANUM; AddName := ncb_retcode;
move(nazwa, ncb_name, 16); {nazwa węzła max. 16 znaków} CMD_Done := ncb_cmd_cplt;
ncb_post := $seg:$ofs (dot. tylko no-wait mode)
Implementacja: Uwagi:
Funkcja ta służy do nadawania
nazwy węzła w protokole
NetBIOS. Nazwa węzła musi być
unikalna dla całej sieci.
ADD GROUP NAME COMMAND
Przyjmuje Zwraca
ncb_command := $36; NCBNUM := ncb_num; {numer węzła pomiędzy 1-254}
ncb_lana_num := NCBLANANUM; AddGroupName := ncb_retcode;
move(nazwa, ncb_name, 16); {nazwa węzła max. 16 znaków} CMD_Done := ncb_cmd_cplt;
ncb_post := $seg:$ofs (dot. tylko no-wait mode)
Implementacja: Uwagi:
Funkcja ta służy do nadawania
grupowej nazwy węzła
NetBIOS  w tym przypadku
nie jest to nazwa unikalna.
Jeśli w sieci istnieje unikalna
nazwa węzła używana przez
inny proces o takiej samej
nazwie jaką chcemy nadać, to
funkcja zwraca błąd w polu
RETCODE.
Funkcji tej używa się w
transmisji typu BROADCAST.
Wszystkie komputery w sieci
nasłuchujące spod nazwy
grupowej otrzymają
komunikat wysłany poprzez
SEND DATAGRAM.
Sieci Komputerowe  Laboratorium (2013)
DELETE NAME COMMAND
Przyjmuje Zwraca
ncb_command := $31; NCBNUM := ncb_num; {numer węzła pomiędzy 1-254}
ncb_lana_num := NCBLANANUM; DeleteName := ncb_retcode;
move(nazwa, ncb_name, 16); {nazwa węzła max. 16 znaków} CMD_Done := ncb_cmd_cplt;
ncb_post := $seg:$ofs (dot. tylko no-wait mode)
Implementacja: Uwagi:
Za pomocą tej funkcji usuwane są
nazwy węzłów z lokalnej tabeli
NetBIOS. Jeśli pod daną nazwą
istnieją jakieś aktywne sesje, to
taka nazwa nie zostanie usunięta
do momentu rozwiązania sesji.
Każda z poniższych funkcji
związanych z funkcją usuwania
spowoduje zwrócenie błędu nr 17
(Name was deleted) w polu
RETCODE funkcji DELETE NAME:
- LISTEN
- RECEIVE
- RECEIVE ANY
- RECEIVE DATAGRAM
CALL COMMAND
Przyjmuje Zwraca
ncb_command := $10; NCBLSN := ncb_lsn; (Numer sesji pomiędzy 1, a 254)
ncb_lana_num := NCBLANANUM; Call := ncb_retcode;
move(odbiorca, ncb_callname, 16); (nazwa węzła odbiorcy) CMD_Done := ncb_cmd_cplt;
move(nazwa, ncb_name, 16); (nazwa węzła nadawcy)
ncb_rto := 0; {Receive Timeout}
ncb_sto := 0; {Send Timeout}
ncb_post := $seg:$ofs (dot. tylko no-wait mode)
Implementacja: Uwagi:
Funkcja ta służy do nawiązania sesji z innym
komputerem w sieci lub z innym procesem.
Pokrewna funkcja LISTEN musi przyjąć tą samą
nazwę w polu NCB_NAME, aby udało się
nawiązać połączenie sesyjne.
Zwracany numer sesji (NCB_LSN)
wykorzystywany jest podczas wysyłania i
odbierania danych oraz dla funkcji HANG UP
(rozwiązywanie sesji po numerze).
Czasy oczekiwania programów: nadawcy na
wysyłkę i odbiorcy na nadejście
komunikatu można ustawić na bezlimitowe za
pomocą przypisania do pól NCB_RTO i NCB_STO
wartości 0.
Sieci Komputerowe  Laboratorium (2013)
LISTEN COMMAND
Przyjmuje Zwraca
ncb_command := $11; NCBLSN := ncb_lsn; (Numer sesji pomiędzy 1, a 254)
ncb_lana_num := NCBLANANUM; Listen := ncb_retcode;
move(odbiorca, ncb_callname, 16); (nazwa węzła odbiorcy) CMD_Done := ncb_cmd_cplt;
move(nazwa, ncb_name, 16); (nazwa węzła nadawcy) move(ncb_callname, nadawca, 16);
ncb_rto := 0; {Receive Timeout}
ncb_sto := 0; {Send Timeout}
ncb_post := $seg:$ofs (dot. tylko no-wait mode)
Implementacja: Uwagi:
Funkcja używana do nawiązywania sesji (po
stronie odbiorcy). Sesja zostanie nawiązana jeśli
nadawca w funkcji CALL podał tą samą nazwę
węzła co odbiorca w funkcji LISTEN.
Pod jedną nazwą lub jedną parą nazw można
zainicjować więcej niż jedną sesję.
Jeśli na pierwszej pozycji pola NCB_CALLNAME
znajduje się symbol  * (gwiazdka) to funkcja
LISTEN będzie nasłuchiwać ze wszystkimi
nadawcami w sieci, którzy wywołali funkcje CALL.
Pierwszeństwo w nawiązywaniu sesji przez
funkcje LISTEN ma ta, która w polu
NCB_CALLNAME zawiera konkretną nazwę
nadawcy, a nie symbol gwiazdki  * .
Jeżeli użyto symbolu  * w NCB_CALLNAME, to po
wywołaniu funkcji LISTEN w tym polu będzie
znajdować się nazwa węzła nadawcy.
HANG UP COMMAND
Przyjmuje Zwraca
ncb_command := $12; HangUp := ncb_retcode;
ncb_lana_num := NCBLANANUM; CMD_Done := ncb_cmd_cplt;
ncb_lsn := 1;
ncb_post := $seg:$ofs (dot. tylko no-wait mode)
Implementacja: Uwagi:
Funkcja ta przerywa lub zamyka sesję. Może być użyta
zarówno po funkcji CALL (u nadawcy) jak i LISTEN (u
odbiorcy).
Jeśli funkcja ta zostanie wywołana podczas gdy w sesji
 wisi jeszcze:
a) któraś z funkcji odbioru RECEIVE, to funkcje te zwrócą
błąd 0A (Session closed).
b) funkcja SEND, to HANG UP odczeka na jej wykonanie i
dopiero zadziała.
W przypadku wywołania funkcji HANG UP dla sesji, która
nie istnieje, zostanie zwrócony błąd 08 (Invalid session)
lub 0A (Session closed).
Sieci Komputerowe  Laboratorium (2013)
SEND COMMAND
Przyjmuje Zwraca
ncb_command := $14; Send := ncb_retcode;
ncb_lana_num := NCBLANANUM; CMD_Done := ncb_cmd_cplt;
ncb_lsn := 1;
ncb_buffer:=@komunikat[1];
ncb_length:=length(komunikat);
ncb_post := $seg:$ofs (dot. tylko no-wait mode)
Implementacja: Uwagi:
Funkcja ta służy do wysyłania danych do urządzeń lub
procesów w sieci w ramach nawiązanej sesji.
W sesji musi zostać wywołana funkcja RECEIVE lub
RECEIVE ANY, aby dane zostały przesłane.
Dane wysyłane są z opóz
nieniem zgodnym z polem
NCB_STO w funkcji CALL.
Jeśli funkcja SEND zakończy się błędem, sesja zostaje
przerwana.
RECEIVE COMMAND
Przyjmuje Zwraca
ncb_command := $15; Receive := ncb_retcode;
ncb_lana_num := NCBLANANUM; CMD_Done := ncb_cmd_cplt;
ncb_lsn := 1; move(ncb_length, dlugosc, NCBNAMSZ);
ncb_buffer:=@komunikat[1];
ncb_length:=250;
ncb_post := $seg:$ofs (dot. tylko no-wait mode)
Implementacja: Uwagi:
Funkcja ta służy do odbierania danych od urządzeń lub
procesów w sieci w ramach nawiązanej sesji.
Jeśli upłynął czas ustawiony w polu NCB_RTO w funkcji
LISTEN i nie wywołano w tym czasie funkcji SEND, to
funkcja RECEIVE zwróci błąd o numerze 05 (Timeout
error).
Jeśli maksymalny rozmiar bufora odbioru jest mniejszy
od rozmiaru przesyłanej wiadomości, to odbiorca
otrzyma wiadomość skróconą do ilości miejsca w
buforze. Pozostała (ucięta) część wiadomości nie
przepada, a zostaje dosłana w kolejnym wywołaniu
funkcji RECEIVE. Ponadto w polu RETCODE znajdzie się
błąd o numerze 06 (Przepełniony bufor).
Po wywołaniu funkcji w polu NCB_LENGTH znajdzie się
długość otrzymanej wiadomości, natomiast przypisanie
do pomocniczej zmiennej zawartości bufora pozwoli
nam na odczytanie odebranego komunikatu.
Sieci Komputerowe  Laboratorium (2013)
SEND DATAGRAM COMMAND
Przyjmuje Zwraca
ncb_command := $20; SendDatagram := ncb_retcode;
ncb_lana_num := NCBLANANUM; CMD_Done := ncb_cmd_cplt;
ncb_num := NCBNUM;
move(odbiorca, ncb_callname, NCBNAMSZ);
ncb_buffer := @wiadomosc[1];
ncb_length := length(wiadomosc);
ncb_post := $seg:$ofs (dot. tylko no-wait mode)
Implementacja: Uwagi:
Funkcja ta służy do wysyłania datagramów.
Datagram pozwala na transfer komunikatów
pomiędzy stacjami lub procesami w sieci, bez
konieczności nawiązywania sesji. Transfer odbywa
się na podstawie nazw węzłów NetBIOS
unikalnych, bądz
grupowych lub też do wszystkich
stacji w sieci (w przypadku BROADCAST).
Protokół NetBIOS nie sprawdza, czy datagram
został wysłany czy nie, przez co nadawca
komunikatu nie dowie się, czy wiadomość dotarła
do odbiorcy/odbiorców, czy też nie, a co za tym
idzie sposób ten nie jest doskonały na tyle co sesja.
Komunikacja za pomocą datagramów umożliwia
przesłanie w pakiecie do 512 bajtów danych
(ncb_length).
RECEIVE DATAGRAM COMMAND
Przyjmuje Zwraca
ncb_command := $21; ReceiveDatagram := ncb_retcode;
ncb_lana_num := NCBLANANUM; CMD_Done := ncb_cmd_cplt;
ncb_buffer:=@s[1]; move(ncb_length, dlugosc, NCBNAMSZ);
ncb_length:=250; move(ncb_callname, odb, NCBNAMSZ);
ncb_num:=NCBNUM;
ncb_post := $seg:$ofs (dot. tylko no-wait mode)
Uwagi:
Funkcja ta służy do odbierania datagramów. Jej
wywołanie powinno nastąpić przed wywołaniem
funkcji SENDDATAGRAM. Funkcja ta nie posiada
żadnego timeout u jak w przypadku sesji.
Jeśli maksymalny rozmiar bufora odbioru jest
mniejszy od rozmiaru przesyłanej wiadomości, to
odbiorca otrzyma wiadomość skróconą do ilości
miejsca w buforze. Pozostała (ucięta) część
wiadomości przepada (kolejna wada datagramów w
stosunku do sesji). Ponadto w polu RETCODE
znajdzie się błąd o numerze 06 (Przepełniony bufor).
Jeśli pole NCB_NUM zostanie wypełnione wartością
FF to funkcja będzie odbierać wszystkie datagramy
wysłane w sieci.
Funkcja ta zwraca długość komunikatu, nazwę
nadawcy, status wykonania i kod błędu.
Sieci Komputerowe  Laboratorium (2013)
SEND BROADCAST COMMAND
Przyjmuje Zwraca
ncb_command := $22; SendBroadcastDatagram := ncb_retcode;
ncb_lana_num := NCBLANANUM; CMD_Done := ncb_cmd_cplt;
ncb_num := NCBNUM;
move(odbiorca, ncb_callname, NCBNAMSZ);
ncb_buffer := @wiadomosc[1];
ncb_length := length(wiadomosc);
ncb_post := $seg:$ofs (dot. tylko no-wait mode)
Implementacja: Uwagi:
Funkcja ta służy do wysyłania wiadomości
typu BROADCAST (do wszystkich
nasłuchujących).
Aby wiadomość dotarła do odbiorców muszą
oni wywołać funkcję RECEIVE BROADCAST.
RECEIVE BROADCAST COMMAND
Przyjmuje Zwraca
ncb_command := $23; ReceiveBroadcastDatagram := ncb_retcode;
ncb_lana_num := NCBLANANUM; CMD_Done := ncb_cmd_cplt;
ncb_num := NCBNUM; move(ncb_length, dlugosc, NCBNAMSZ);
ncb_buffer := @wiadomosc[1]; move(ncb_callname, odb, NCBNAMSZ);
ncb_length := length(wiadomosc);
ncb_post := $seg:$ofs (dot. tylko no-wait mode)
Implementacja: Uwagi:
Funkcja ta służy do odbierania
wiadomości typu BROADCAST. Jej
wywołanie powinno nastąpić przed
wywołaniem funkcji SENDBROADCAST.
Funkcja ta nie posiada żadnego
timeout u jak w przypadku sesji.
Jeśli maksymalny rozmiar bufora odbioru
jest mniejszy od rozmiaru przesyłanej
wiadomości, to odbiorca otrzyma
wiadomość skróconą do ilości miejsca w
buforze. Pozostała (ucięta) część
wiadomości przepada (kolejna wada
datagramów w stosunku do sesji).
Ponadto w polu RETCODE znajdzie się
błąd o numerze 06 (Przepełniony bufor).
Funkcja ta zwraca długość komunikatu,
nazwę nadawcy, status wykonania i kod
błędu.