]> git.ozlabs.org Git - ccan-lca-2011.git/blob - ccan/oserver/oserver.h
lca2011: rewrite to a serious server
[ccan-lca-2011.git] / ccan / oserver / oserver.h
1 #ifndef CCAN_OSERVER_H
2 #define CCAN_OSERVER_H
3 #include <stdbool.h>
4 #include <ccan/tevent/tevent.h>
5
6 /**
7  * oserver_setup - set up an oserver
8  * @ev: tevent context to use.
9  * @port: port to use (usually OSERVER_PORT)
10  *
11  * Opens a socket and binds it to @port, then sets it up to listen
12  * for connections.  talloc_free() the pointer returned to shut it down.
13  *
14  * Example:
15  *      void *oserver;
16  *      struct tevent_context *ev;
17  *
18  *      ev = tevent_context_init(NULL);
19  *      oserver = oserver_setup(ev, OSERVER_PORT);
20  *      if (!oserver)
21  *              err(1, "Failed to set up server");
22  *
23  *      while (tevent_loop_wait(ev) == 0);
24  *      err(1, "Event loop failed");
25  */
26 void *oserver_setup(struct tevent_context *ev, unsigned short port);
27
28 #define OSERVER_PORT 2727
29 #endif /* CCAN_OSERVER_H */