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