| 1 | /* vi: set sw=4 ts=4: */
|
|---|
| 2 | /*
|
|---|
| 3 | * Generic non-forking server infrastructure.
|
|---|
| 4 | * Intended to make writing telnetd-type servers easier.
|
|---|
| 5 | *
|
|---|
| 6 | * Copyright (C) 2007 Denys Vlasenko
|
|---|
| 7 | *
|
|---|
| 8 | * Licensed under GPLv2, see file LICENSE in this source tree.
|
|---|
| 9 | */
|
|---|
| 10 |
|
|---|
| 11 | PUSH_AND_SET_FUNCTION_VISIBILITY_TO_HIDDEN
|
|---|
| 12 |
|
|---|
| 13 | /* opaque structure */
|
|---|
| 14 | struct isrv_state_t;
|
|---|
| 15 | typedef struct isrv_state_t isrv_state_t;
|
|---|
| 16 |
|
|---|
| 17 | /* callbacks */
|
|---|
| 18 | void isrv_want_rd(isrv_state_t *state, int fd);
|
|---|
| 19 | void isrv_want_wr(isrv_state_t *state, int fd);
|
|---|
| 20 | void isrv_dont_want_rd(isrv_state_t *state, int fd);
|
|---|
| 21 | void isrv_dont_want_wr(isrv_state_t *state, int fd);
|
|---|
| 22 | int isrv_register_fd(isrv_state_t *state, int peer, int fd);
|
|---|
| 23 | void isrv_close_fd(isrv_state_t *state, int fd);
|
|---|
| 24 | int isrv_register_peer(isrv_state_t *state, void *param);
|
|---|
| 25 |
|
|---|
| 26 | /* Driver:
|
|---|
| 27 | *
|
|---|
| 28 | * Select on listen_fd for <linger_timeout> (or forever if 0).
|
|---|
| 29 | *
|
|---|
| 30 | * If we time out and we have no peers, exit.
|
|---|
| 31 | * If we have peers, call do_timeout(peer_param),
|
|---|
| 32 | * if it returns !0, peer is removed.
|
|---|
| 33 | *
|
|---|
| 34 | * If listen_fd is active, accept new connection ("peer"),
|
|---|
| 35 | * call new_peer() on it, and if it returns 0,
|
|---|
| 36 | * add it to fds to select on.
|
|---|
| 37 | * Now, select will wait for <timeout>, not <linger_timeout>
|
|---|
| 38 | * (as long as we have more than zero peers).
|
|---|
| 39 | *
|
|---|
| 40 | * If a peer's fd is active, we call do_rd() on it if read
|
|---|
| 41 | * bit was set, and then do_wr() if write bit was also set.
|
|---|
| 42 | * If either returns !0, peer is removed.
|
|---|
| 43 | * Reaching this place also resets timeout counter for this peer.
|
|---|
| 44 | *
|
|---|
| 45 | * Note that peer must indicate that he wants to be selected
|
|---|
| 46 | * for read and/or write using isrv_want_rd()/isrv_want_wr()
|
|---|
| 47 | * [can be called in new_peer() or in do_rd()/do_wr()].
|
|---|
| 48 | * If it never wants to be selected for write, do_wr()
|
|---|
| 49 | * will never be called (can be NULL).
|
|---|
| 50 | */
|
|---|
| 51 | void isrv_run(
|
|---|
| 52 | int listen_fd,
|
|---|
| 53 | int (*new_peer)(isrv_state_t *state, int fd),
|
|---|
| 54 | int (*do_rd)(int fd, void **),
|
|---|
| 55 | int (*do_wr)(int fd, void **),
|
|---|
| 56 | int (*do_timeout)(void **),
|
|---|
| 57 | int timeout,
|
|---|
| 58 | int linger_timeout
|
|---|
| 59 | );
|
|---|
| 60 |
|
|---|
| 61 | POP_SAVED_FUNCTION_VISIBILITY
|
|---|
