Using the BOINC Trickle Message API

From Unofficial BOINC Wiki

Jump to: navigation, search

Contents

[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

[edit] UCB Source

[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.

Retrieved from "http://www.boinc-wiki.info/Using_the_BOINC_Trickle_Message_API"
Personal tools