blob: 7b12e0edd258c998d8cd8842efc4b60fce3feb14
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 |
62 |