2 * UCW Library -- Main Loop
4 * (c) 2004--2005 Martin Mares <mj@ucw.cz>
6 * This software may be freely distributed and used according to the terms
7 * of the GNU Lesser General Public License.
10 #include "lib/clists.h"
12 typedef s64 timestamp_t; /* We measure time in milliseconds */
13 extern timestamp_t main_now; /* Current time in milliseconds since UNIX epoch */
14 extern sh_time_t main_now_seconds; /* Current time in seconds since the epoch */
15 extern uns main_shutdown;
16 extern clist main_timer_list, main_file_list, main_hook_list, main_process_list;
18 /* User-defined fields are marked with [*], all other fields must be initialized to zero. */
25 void (*handler)(struct main_timer *tm); /* [*] Function to be called when the timer expires. Must re-add/del the timer.*/
26 void *data; /* [*] Data for use by the handler */
29 void timer_add(struct main_timer *tm, timestamp_t expires); /* Can modify a running timer, too */
30 void timer_del(struct main_timer *tm);
36 int fd; /* [*] File descriptor */
37 int (*read_handler)(struct main_file *fi); /* [*] To be called when ready for reading/writing; must call file_chg() afterwards */
38 int (*write_handler)(struct main_file *fi);
39 void (*error_handler)(struct main_file *fi, int cause); /* [*] Handler to call on errors */
40 void *data; /* [*] Data for use by the handlers */
41 byte *rbuf; /* Read/write pointers for use by file_read/write */
45 void (*read_done)(struct main_file *fi); /* [*] Called when file_read is finished; rpos < rlen if EOF */
46 void (*write_done)(struct main_file *fi); /* [*] Called when file_write is finished */
47 struct main_timer timer;
48 struct pollfd *pollfd;
51 enum main_file_err_cause {
57 void file_add(struct main_file *fi);
58 void file_chg(struct main_file *fi);
59 void file_del(struct main_file *fi);
60 void file_read(struct main_file *fi, void *buf, uns len);
61 void file_write(struct main_file *fi, void *buf, uns len);
62 void file_set_timeout(struct main_file *fi, timestamp_t expires);
63 void file_close_all(void); /* Close all known main_file's; frequently used before fork() */
65 /* Hooks to be called in each iteration of the main loop */
69 int (*handler)(struct main_hook *ho); /* [*] Hook function; returns 1 if should be called again */
70 void *data; /* [*] For use by the handler */
73 void hook_add(struct main_hook *ho);
74 void hook_del(struct main_hook *ho);
76 /* Processes to watch */
80 int pid; /* Process id (0=not running) */
81 int status; /* Exit status (-1=fork failed) */
82 byte status_msg[EXIT_STATUS_MSG_SIZE];
83 void (*handler)(struct main_process *mp); /* [*] Called when the process exits; process_del done automatically */
84 void *data; /* [*] For use by the handler */
87 void process_add(struct main_process *mp);
88 void process_del(struct main_process *mp);
89 int process_fork(struct main_process *mp);
95 void main_debug(void);