Using the BOINC Trickle Message API

From Unofficial BOINC Wiki

Contents 1 General 2 Application to Server 3 Server to Application 4 Also See 5 UCB Source 6 Copyright ©

[edit] General

The Trickle Message API is a set of functions that allow the Developer to send periodic messages from the Scheduling Server to the Science Application on the Participant's Host (Trickle-Down Message) or from the Science Application on the Participant's Host to the Scheduling Server (Trickle-Up Message).

[edit] Application to Server

The function:

int boinc_send_trickle_up(char* variety, char* text)

sends a trickle message of the given variety. Returns zero if success.

While

bool boinc_receive_trickle_down(char* buf, int len)

receives a trickle message. Returns true if there was a message. Messages are delivered in order.

[edit] Server to Application

To handle a Trickle Messages, use the daemon process 'trickle_handler'. You must supply the following function:

int handle_trickle(TRICKLE_UP&);

You may send Trickle-Down Messages, from this function or elsewhere, as follows:

DB_TRICKLE_DOWN tdown;
// ... populate the tdown object
tdown.insert();

[edit] Also See

• Trickle Message
• Trickle Message API
• Using the BOINC Trickle Message API

[edit] UCB Source

• Trickle message API

[edit] Copyright ©

• 2005 University of California
• 2005 Paul D. Buck

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation.