Karoo project cave protocol

• CAVE_MESSAGE 10 This message is sent to the cave rock to ask it to execute and SQL. The format of the message is first the standard 4 parameters (that are sent in any message): type,seq,port,name, followed by the following more specific fields: id,reply_id,reply_num,num, then followed by a number of the following 3 parameters: param_key,param_type,param_val (num being the number of times these 3 are repeated, one for each parameter passed.)
• id this is a string, the ID of the cave service.
• reply_id this is a string, a name that identifies the transaction when the reply is returned asynchronously
• reply_num this is a 64bit unsigned integer, a number that, along with the reply_id, identifies the transaction when the reply is returned asynchronously
• num this is an unsigned 8bit integer - the number of key/type/val 3-tuples that follow.
• param_key this is a string that matches a parameter name in an sql element inside a service of the cave.
• param_type this is an unsigned 8bit integer (enum db_data_type) that specifies the type of value
• param_val the value (type determined by param_type.