6 files changed, 108 insertions, 0 deletions
diff --git a/doc/examples/nonblocking/.gitignore b/doc/examples/nonblocking/.gitignore
new file mode 100644
index 0000000..e5c1856
--- /dev/null
+++ b/doc/examples/nonblocking/.gitignore
@@ -0,0 +1,5 @@
+cleanup
+init
+write
+poll
+
diff --git a/doc/examples/nonblocking/Makefile b/doc/examples/nonblocking/Makefile
new file mode 100644
index 0000000..1b1cbd3
--- /dev/null
+++ b/doc/examples/nonblocking/Makefile
@@ -0,0 +1,13 @@
+COMMANDS = init cleanup write poll
+
+all: ${COMMANDS}
+
+%: %.c
+	${CC} -Wall -Wextra -pedantic -std=c99 -lbus -o $@ $<
+
+clean:
+	-rm ${COMMANDS}
+
+
+.PHONY: all clean
+
diff --git a/doc/examples/nonblocking/cleanup.c b/doc/examples/nonblocking/cleanup.c
new file mode 100644
index 0000000..00f07bc
--- /dev/null
+++ b/doc/examples/nonblocking/cleanup.c
@@ -0,0 +1,8 @@
+#include <bus.h>
+#include <stdio.h>
+
+int main()
+{
+	return bus_unlink("/tmp/example-bus") && (perror("cleanup"), 1);
+}
+
diff --git a/doc/examples/nonblocking/init.c b/doc/examples/nonblocking/init.c
new file mode 100644
index 0000000..870e10d
--- /dev/null
+++ b/doc/examples/nonblocking/init.c
@@ -0,0 +1,8 @@
+#include <bus.h>
+#include <stdio.h>
+
+int main()
+{
+	return bus_create("/tmp/example-bus", 0, NULL) && (perror("init"), 1);
+}
+
diff --git a/doc/examples/nonblocking/poll.c b/doc/examples/nonblocking/poll.c
new file mode 100644
index 0000000..c918b5b
--- /dev/null
+++ b/doc/examples/nonblocking/poll.c
@@ -0,0 +1,42 @@
+#include <bus.h>
+#include <stdio.h>
+#include <unistd.h>
+#include <string.h>
+#include <errno.h>
+
+#define t(stmt)  if (stmt) goto fail
+
+
+
+int main()
+{
+	bus_t bus;
+	const char *message;
+	long long tick = 0;
+	t(bus_open(&bus, "/tmp/example-bus", BUS_RDONLY));
+	t(bus_poll_start(&bus, BUS_NOWAIT));
+	for (;;) {
+		message = bus_poll(&bus);
+		if (message == NULL) {
+			t(errno != EAGAIN);
+			printf("waiting... %lli\n", ++tick);
+			sleep(1);
+			continue;
+		}
+		tick = 0;
+		message = strchr(message, ' ') + 1;
+		if (!strcmp(message, "stop"))
+			break;
+		printf("\033[01m%s\033[21m\n", message);
+	}
+	t(bus_poll_stop(&bus));
+	bus_close(&bus);
+	return 0;
+
+fail:
+	perror("poll");
+	bus_poll_stop(&bus);
+	bus_close(&bus);
+	return 1;
+}
+
diff --git a/doc/examples/nonblocking/write.c b/doc/examples/nonblocking/write.c
new file mode 100644
index 0000000..7fe9690
--- /dev/null
+++ b/doc/examples/nonblocking/write.c
@@ -0,0 +1,32 @@
+#include <bus.h>
+#include <stdio.h>
+#include <unistd.h>
+#include <stdint.h>
+
+#define t(stmt)  if (stmt) goto fail
+
+
+
+static char message[BUS_MEMORY_SIZE];
+
+
+
+int main(int argc, char *argv[])
+{
+	bus_t bus;
+	if (argc < 2) {
+		fprintf(stderr, "%s: USAGE: %s message\n", argv[0], argv[0]);
+		return 2;
+	}
+	sprintf(message, "0 %s", argv[1]);
+	t(bus_open(&bus, "/tmp/example-bus", BUS_WRONLY));
+	t(bus_write(&bus, message, BUS_NOWAIT));
+	bus_close(&bus);
+	return 0;
+
+fail:
+	perror("write");
+	bus_close(&bus);
+	return 1;
+}
+