libactor – a C library based on the Actor model

Chris Moos — Thu, 29 Oct 2009 06:38:38 +0000

Recently I’ve been really interested in functional, concurrent programming languages, such as Erlang. This prompted me to have some fun in C, and try to implement a simple library that is based on the Actor Model.

Right now it is usable, although it may not be ready for production. It uses pthreads and the library handles all of the threading issues, so you don’t have to worry about any of it at all.

In a future version I plan to add more sandboxing to the actors, so that when one actor crashes, they don’t all go down!

Right now it supports the following:

Spawn actor
Sending messages
Broadcast message
Actor memory management convenience functions(when an actor dies, the memory is freed!)

Here is what a simple ping/pong example looks like:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

#include
#include

void *pong_func(void *args) {
actor_msg_t *msg;

while(1) {
msg = actor_receive();
if(msg->type == PING_MSG) {
printf("PING! ");
actor_reply_msg(msg, PONG_MSG, NULL, 0);
}
arelease(msg);
}
}

void *ping_func(void *args) {
actor_msg_t *msg;
actor_id aid = spawn_actor(pong_func, NULL);
while(1) {
actor_send_msg(aid, PING_MSG, NULL, 0);
msg = actor_receive();
if(msg->type == PONG_MSG) printf("PONG!\n");
arelease(msg);
sleep(5);
}
}

void *main_func(void *args) {
struct actor_main *main = (struct actor_main*)args;
int x;

/* Accessing the arguments passed to the application */
printf("Number of arguments: %d\n", main->argc);
for(x = 0; x < main->argc; x++) printf("Argument: %s\n", main->argv[x]);

/* PING/PONG example */
spawn_actor(ping_func, NULL);
}

DECLARE_ACTOR_MAIN(main_func)

There is a more detailed example in the source distribution, located in the examples/ directory.

You can get the source here. Please, let me know what you think about it, it was really fun to write!

Documentation is available here: http://chrismoos.com/libactordocs/

chris moos's blog » concurrency

libactor – a C library based on the Actor model