Difference between revisions of "GeometryServiceNetworkProtocol"

From BRL-CAD
(Use CSS to make the table purty.)
(Rename title for clarity)
Line 12: Line 12:
 
----
 
----
  
==Visual GSNet Msg Breakdown==
+
==GSNet Msg (Visual) Breakdown==
 
[[Image:GSNetMsgBreakdown.png|520x373px]]
 
[[Image:GSNetMsgBreakdown.png|520x373px]]
  

Revision as of 06:49, 24 January 2011


GSNet
The Geometry Service Network (GSNet) Protocol is a TCP/IP based protocol designed to facilitate socketed communications between Geometry Service Nodes on a network. A Geometry Service Node is defined as any softwares that supports communication via the GSNet Protocol.



GSNet Msg (Visual) Breakdown

GSNetMsgBreakdown.png


GSNet Msg

Header

The header of the GSNet Msg contains the information necessary for quickly determining authenticity, type and length. Geometry Service's network library, libNetwork, is built upon BRL-CAD's networking library: libPKG. This causes the header byte layout to look like this:

Element Length Value
Magic1 int16 (2 Bytes) Always 0x41FE
Magic2 int16 (2 Bytes) Always 0x5309
MessageLength int32 (4 bytes)
MsgType int16 (2 bytes)
MessageUUID String (Variable bytes)
HasRegardingUUID Boolean (1 byte)
RegardingMessageUUID String (Variable bytes)


libPKG Part

Due to some C and C++ incompatabilities, the libPKG "Type" parameter is used as "Magic2" in the GSNet Protocol. NetMsg routing is performed on the "GS Msg Type" parameter

GSNet Part


Data



List of NetMsgTypes.

List of Common NetMsg Exchanges