NBVIEW SCRIPT UTILITY
=====================

  NetBEUI supports Linux PROC file systems and provides useful
information about kernel activities to user space programs. The
entry point /proc/sys/netbeui is chosen for this purpose with which
one can view kernel internals of NetBEUI from filesystem, however
NBVIEW utility is a better alternative than directly accessing
/proc entry.

  NBVIEW is a UNIX shell script that integrates NetBEUI proc support
with a couple of Linux utilities to provide an efficient monitoring
utility for in-kernel activities. The main menu 
command lets the administrator access to NetBEUI name table, link
table, session table and also list of adapters currently bound
to. Description of these tables are as follows:


 NAME TABLE
------------

	- No: The index of name in NetBIOS name table.

	- Name: A 16-byte NetBIOS name.

	- Users: Number of owners that in some way point to this
	  name. A registered name by an owner may be owned by other 
	  owners.

	- Status: The return value of raising an event on a name.

	- State: Holds different states of name including:
		. Initail state (0): name is not entered into the
		  name table, yet.  
		. Wait for add (1): name is in progress of registration 
		  on network.  
		. Collision (2): At least one node is found that owns 
		  this NetBIOS name. It is waiting to detect responses 
		  from other nodes to detect conflicts.
		. Registered (3): name is registered.

	- Conflicted: A flag that indicates name conflict is detected
	  on this name. Zero indicates no conflict and a non-zero value 
	  indicates conflict.


 LINK TABLE
------------

	- No: The index of link in NetBIOS link table.

	- Remote MAC Addr: The 6 byte buffer that holds MAC address
	  of peer node.

	- Device: Device that node is connected to.

	- Status: The return value of raising an event on a link.

	- State: Holds different state of link including:
		. Initail (0): link is not entered into the link
		  table, yet.
		. Wait (1): The link is in progress of connection
		  establishment with other node via LLC services. If
		  connection is established by the node itself,
		  it waits for confirmation of LLC connection
		  request. If connection is established by remote
		  node, it waits for indication of connection
		  from LLC.
		. Up (2): The link is in a stable state and has
		  session(s) in its  local session table which
		  transfer data over link to other node.

	- LLC Handler: The LLC pointer to connection structure of
	  LLC, interpreted as a unique integer value in NetBEUI. It
	  used in every operation NetBEUI requests from LLC.

	- LLC Busy: The flag that determines if LLC accepts  outgoing
	frames. A zero value indicates LLC is ready to accept frames
	on link and a non-zero value indicates LLC does not accept
	frames. This value is used for making a decision on queuing
	frames or delivering directly to LLC.  If set to a non-zero
	the NetBIOS link should queue frames, until LLC raises the
	confirm primitive of data service on link.

	- Frames: The count of I-frames the link has transmitted
	  or received from the last session alive on link. The
	  value of this field is reset on every session alive from
	  either side of connection and incremented on every I-frame
	  transmitted. The value is used when session alive timer
	  timeouts, and determines if the node should send a session
	  alive to peer or not.


 SESSION TABLE
---------------

	- Link: Link number that this session belongs to it.

	- LSN: Session number in the local node.

	- RSN: Session number in the peer node.

	- Local Name: Name of local node.

	- Remote Name: Name of peer node.

	- Total Output: Total send data on this session.

	- Total Input: Total recieved date on this session.


 ADAPTERS TABLE
----------------

	- No: Adapter number.

	- Name: Adapter name.

	- MTU: Adapter's  maximum transfer unit.

	- MAC Address: Adapter's MAC address.
