doc/orb/marshalling

   1 Segment 0, byte 0 is a request code.  Currently defined codes are:
   2  0: Invoke Method
   3  1: Get Interface List
   4  2: Return Interface List
   5
   6 Bytes 1-3 (32-bit) and 1-7 (64-bit) are reserved, and must be zero.
   7 All offsets described in the rest of this file are relative to the
   8 first non-reserved byte (a.k.a. the message payload); however,
   9 offsets encoded in the message are relative to the beginning of the
  10 segment, not the payload.  The reserved bytes do not need to be
  11 included in the message if the payload is empty.
  12
  13 Op0: Invoke Method
  14 ------------------
  15
  16 The payload begins with the index of the interface being used,
  17 followed by the index of the method.  Both are 32-bit integers.
  18
  19 After that, the payload contains the method's arguments as if they
  20 were a struct.
  21
  22 Non-inline structs and arrays (hereafter referred to as data chunks)
  23 which contain object ids and/or references to other data chunks are
  24 stored at arbitrary locations in segment 0, and are referenced as an
  25 offset into the segment.
  26
  27 Data chunks which do not contain object id or references to other
  28 data chunks (i.e. they are pure data, and do not need to be altered
  29 for marshalling) are stored at arbitrary locations in arbitrary
  30 segments.  References to these pure data chunks are encoded as a
  31 pointer-sized integer, with the upper N bits holding the segment and
  32 the remaining bits holding the offset into that segment.  The value
  33 of N is architecture-defined, but should generally be 6 (this may
  34 change once enough of the system is in place to do some benchmarks)
  35 for 32-bit architectures and 32 for 64-bit architectures.
  36
  37 Object references are encoded as pointer-sized offsets into the
  38 objlist array.
  39
  40 Op1: Get Interface List
  41 -----------------------
  42
  43 Return a "Return Interface List" message corresponding to the object
  44 in objlist[0].  For async requests, objlist[1] is the destination for
  45 the return message.
  46
  47 Op2: Return Interface List
  48 --------------------------
  49
  50 For async requests, objlist[1] is the object whose interfaces were
  51 requested.
  52
  53 Segment 1 consists of a list of GUIDs of interfaces that the object
  54 supports.