Appendix A. Generic Encoding Layer Rules

Let:

• an object obj_i be defined as {content_i, attrs_i, endsets_i};
  
• content_i be an arbitrary byte block of known size sizeof (content_i);
  
• attrs_i be an array of known size sizeof (attrs_i);
  
• each element of attrs_i, say attrs_i,j, be defined as {attr_name_i,j, values_i,j};
  
• values_i,j be an array of known size sizeof (values_i,j);
  
• attr_name_i,j and each member of values_i,j, say values_i,j,k, be a NULL-terminated string;
  
• endset_i be an array of known size sizeof (endset_i);
  
• each element of endset_i, say endset_i,j, be defined as {endset_name_i,j, endpoints_i,j};
  
• endpoints_i,j be an array of known size sizeof (endpoints_i,j);
  
• endset_name_i,j be a NULL-terminated string;
  
• each member of endpoints_i,j, say endpoints_i,j,k, be an arbitrary byte block of known size sizeof (endpoints_i,j,k;
  
• sizeof (x), where x is a NULL-terminated string, return the number of bytes (including the NULL termination byte) in the string; and,
  
• sizeof (x) return an 8 byte integer.
  

Also, in the algorithm, let:

• size and offset be 8 byte integers;
  
• block be a block of memory that may be indexed by offset; and,
  
• append (block, offset, param, param_size) be an operation that copies param_size bytes from param into the memory starting offset bytes into block, and that increments offset by param_size.
  

Given {obj_i}, do:

1. Set size and offset to 0.
2. For each object obj_i,j, do:

2.1 append (block, offset, sizeof (content_i), 8)
2.2 append (block, offset, content_i, sizeof (content_i))
2.3 For each attribute attr_i,j, do:

2.3.1 append (block, offset, attr_name_i,j, sizeof (attr_name_i,j))
2.3.2 append (block, offset, sizeof (attr_i,j), 8)
2.3.3 For each attribute value values_i,j,k, do:

2.3.3.1 append (block, offset, values_i,j,k, sizeof (values_i,j,k)

2.4 For each endset endset_i,j, do:

2.4.1 append (block, offset, endset_name_i,j, sizeof (endset_name_i,j))
2.4.2 append (block, offset, sizeof (endset_i,j), 8)
2.4.3 For each endpoint endpoints_i,j,k, do:

2.4.3.1 append (block, offset, sizeof (endpoints_i,j,k), 8)
2.4.3.2 append (block, offset, endpoints_i,j,k, sizeof (endpoints_i,j,k))

The byte stream that is written to the Transport Layer is the 8 byte integer size followed by the size byte block block.

Ignored here are issues about integer representation (e.g., 1's complement, 2's complement, etc.) and byte-order. These issues must be addressed by the OHSWG.

Contents

Top
1. Introduction
2. Scope of the OHSWG...
3. Scenarios...
4. An OHS Reference Architecture Proposal...
5. An OHP Proposal...
6. Metacommentary
7. Conclusions
References
Appendix A. Generic Encoding Layer Rules
Appendix B. Sproc Generic Layer Rules
Appendix C. Sproc Specific Layer Rules
Appendix D. Sproc Interface Format
Appendix E. Current Protocol Proposal in Sproc Interface Format