Editing GeometryServiceNetworkProtocol

From BRL-CAD

Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 12: Line 12:
 
----
 
----
  
 +
=GSNet Msg (Visual) Breakdown=
 +
[[Image:GSNetMsgBreakdown.png|520x373px]]
  
 +
----
  
 
=GSNet Msg Description=
 
=GSNet Msg Description=
 
==Header==
 
==Header==
The header of the GSNet Msg contains the information necessary for quickly determining authenticity, type and length.  Geometry Service's network library, libNetwork, has a header byte layout that looks like this:
+
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:
 
<br /><br />
 
<br /><br />
 
   
 
   
Line 45: Line 48:
 
|}
 
|}
  
 +
 +
===libPKG Part===
 +
Due to some C and C++ incompatibilities, the libPKG "Type" parameter is used as "Magic2" in the GSNet Protocol.  This is due to libPKG's need for each network connection to have a callback table that maps NetMsg types to pointers to the appropriate NetMsg handler function.  The GSNetwork library uses a publish/subscription scheme to route NetMsg.  LibPKG strips off the libPKG header before calling the appropriate callback function, thus making per class deserialization extremely complex.  To address these issues, the GSNetwork library routes NetMsg based on the "GS Msg Type" parameter rather than the "libPKG Type" parameter.
 +
<br /><br />
 +
Table showing modifications described above:
 +
<br /><br />
 +
{|style="border-collapse: separate; border-spacing: 0; border-width: 1px; border-style: solid; border-color: #666699; padding: 0;"
 +
|style="border: 1px solid #666699; background-color: #666699; color: #FFFFFF; width: 180px;"|'''libPKG element'''
 +
|style="border: 1px solid #666699; background-color: #666699; color: #FFFFFF; width: 180px;"|'''GSNet element'''
 +
|-
 +
|style="border: 1px solid #666699;"|Magic
 +
|style="border: 1px solid #666699;"|Magic01
 +
|-
 +
|style="border: 1px solid #666699;"|Type
 +
|style="border: 1px solid #666699;"|Magic02
 +
|-
 +
|style="border: 1px solid #666699;"|Length
 +
|style="border: 1px solid #666699;"|Length
 +
|}
 +
 +
* '''Magic01:''' 2 bytes of data designed to ensure integrity of data and mark NetMsg starting point.
 +
* '''Magic02:''' 2 bytes of data designed to ensure integrity of data and mark NetMsg starting point.
 +
* '''Length:''' 4 byte integer that represents the number of bytes in the message from the end of this value to the end.
 +
<br /><br />
 +
===GSNet Part===
  
 
* '''MsgType:''' 2 byte integer value that tells what type of message this is.
 
* '''MsgType:''' 2 byte integer value that tells what type of message this is.

Please note that all contributions to BRL-CAD may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see BRL-CAD:Copyrights for details). Do not submit copyrighted work without permission!

To edit this page, please answer the question that appears below (more info):

Cancel Editing help (opens in new window)