CBPP 1.0.0

Communication Between Processes Protocol

Communication Between Processes Protocol (hereby abbreviated to CBPP) is a protocol that enables applications to share data between each other. It is built on top of the NT Global Atom Table and allows for an unlimited number of applications to join a 'share'. These facilitate the sharing of data. The protocol has built in trust and verification of all items within a share via a shared-secret. Within the share, any application can get, and delete, an item whilst any application with the shared-secret can add to the share. CBPP integrates a segmentation algorithm that allows for large byte arrays to be pushed to a share without any application-defined programming.

Because of its use of the Global Atom Table, any application running on the system, regardless of integrity or user-level, can facilitate the sharing of data with other applications.

The protocol at V1.0 does not offer any encryption of the items and care must be taken as any application can see the data within a share, even if they cannot add data to it.

Construct a basic byte share

// Create a byte share
BasicByteShare MyByteShare = new BasicByteShare(
    "UNIQUE-NAME", /* A unique identifier for this share */
    "PASSWORD" /* A shared secret to prevent injection from malicious parties */
    );

Creating a simple item

// Create an item
MyByteShare.CreateItem(
    "HelloWorldName", /* Name of this item */
    Encoding.UTF8.GetBytes("Hello world!") /* Value of this item */
    );

Reading a simple item

// Get an item from the share
byte[] item = MyByteShare.GetItem("HelloWorldName");

Deleting an item

// Delete an item from the share
MyByteShare.DeleteItem("HelloWorldName");

Large items

Some items can't be stored in the global atom table because they are larger than 255 characters (actually less as CBPP adds structure to each table entry). In these cases, you can use the "Large item" set of functions. Large items have no character limit and are segmented.

Creating a large item

// Create a large item
MyByteShare.CreateLargeItem(
    "HelloWorldName", /* Name of this item */
    Encoding.UTF8.GetBytes("Hello world!") /* Value of this item */
    );

Reading a large item

// Get a large item from the share
byte[] item = MyByteShare.GetLargeItem("HelloWorldName");