https://github.com/rxi/dyad

Asynchronous networking for C
https://github.com/rxi/dyad

Last synced: 3 months ago
JSON representation

Asynchronous networking for C

• Host: GitHub
• URL: https://github.com/rxi/dyad
• Owner: rxi
• License: mit
• Archived: true
• Created: 2014-08-03T19:00:04.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2020-10-06T10:51:15.000Z (about 4 years ago)
• Last Synced: 2024-05-02T00:53:28.750Z (6 months ago)
• Language: C
• Size: 102 KB
• Stars: 1,437
• Watchers: 71
• Forks: 218
• Open Issues: 16
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• starred-awesome - dyad - Asynchronous networking for C (C)

README

        

![dyad.c](https://cloud.githubusercontent.com/assets/3920290/3942261/5de470e4-255d-11e4-95a9-5f97fa9f3a57.png)

## Overview

Dyad.c is an asynchronous networking library which aims to be lightweight,

portable and easy to use. It can be used both to create small standalone

servers and to provide network support to existing projects.

## Getting started

The [dyad.c](src/dyad.c?raw=1) and [dyad.h](src/dyad.h?raw=1) files can be

dropped into an existing project; if you're using Windows you will also have to

link to `ws2_32`.

An overview of the API can be found at [doc/api.md](doc/api.md).

Usage examples can be found at [example/](example/).

## Server example

A simple server which listens on port 8000 and echoes whatever is sent to it:

```c

#include 

#include "dyad.h"

static void onData(dyad_Event *e) {

  dyad_write(e->stream, e->data, e->size);

}

static void onAccept(dyad_Event *e) {

  dyad_addListener(e->remote, DYAD_EVENT_DATA, onData, NULL);

  dyad_writef(e->remote, "Echo server\r\n");

}

int main(void) {

  dyad_init();

  dyad_Stream *serv = dyad_newStream();

  dyad_addListener(serv, DYAD_EVENT_ACCEPT, onAccept, NULL);

  dyad_listen(serv, 8000);

  while (dyad_getStreamCount() > 0) {

    dyad_update();

  }

  dyad_shutdown();

  return 0;

}

```

## Client example

A simple example program which connects to a

[daytime](http://en.wikipedia.org/wiki/Daytime_Protocol) server and prints the

response:

```c

#include 

#include "dyad.h"

static void onConnect(dyad_Event *e) {

  printf("connected: %s\n", e->msg);

}

static void onData(dyad_Event *e) {

  printf("%s", e->data);

}

int main(void) {

  dyad_init();

  dyad_Stream *s = dyad_newStream();

  dyad_addListener(s, DYAD_EVENT_CONNECT, onConnect, NULL);

  dyad_addListener(s, DYAD_EVENT_DATA,    onData,    NULL);

  dyad_connect(s, "time-nw.nist.gov", 13);

  while (dyad_getStreamCount() > 0) {

    dyad_update();

  }

  

  dyad_shutdown();

  return 0;

}

```

## License

This library is free software; you can redistribute it and/or modify it under

the terms of the MIT license. See [LICENSE](LICENSE) for details.