Add arch taglines
[bpt/emacs.git] / src / atimer.h
CommitLineData
e12489f9
GM
1/* Asynchronous timers.
2 Copyright (C) 2000 Free Software Foundation, Inc.
3
4This file is part of GNU Emacs.
5
6GNU Emacs is free software; you can redistribute it and/or modify
7it under the terms of the GNU General Public License as published by
8the Free Software Foundation; either version 2, or (at your option)
9any later version.
10
11GNU Emacs is distributed in the hope that it will be useful,
12but WITHOUT ANY WARRANTY; without even the implied warranty of
13MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14GNU General Public License for more details.
15
16You should have received a copy of the GNU General Public License
17along with GNU Emacs; see the file COPYING. If not, write to
18the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19Boston, MA 02111-1307, USA. */
20
ffd8f46e
DL
21#ifndef EMACS_ATIMER_H
22#define EMACS_ATIMER_H
23
cf8c53b2
DL
24/* Building alloca.o includes us, and we need lisp.h for the P_ macro
25 in that case. */
26#include "lisp.h"
ffd8f46e
DL
27#include "systime.h" /* for EMACS_TIME */
28
e12489f9
GM
29/* Forward declaration. */
30
31struct atimer;
32
33/* Types of timers. */
34
35enum atimer_type
36{
37 /* Timer is ripe at some absolute time. */
38 ATIMER_ABSOLUTE,
39
40 /* Timer is ripe at now plus an offset. */
41 ATIMER_RELATIVE,
42
43 /* Timer runs continously. */
44 ATIMER_CONTINUOUS
45};
46
47/* Type of timer callback functions. */
48
49typedef void (* atimer_callback) P_ ((struct atimer *timer));
50
51/* Structure describing an asynchronous timer. */
52
53struct atimer
54{
55 /* The type of this timer. */
56 enum atimer_type type;
177c0ea7 57
e12489f9
GM
58 /* Time when this timer is ripe. */
59 EMACS_TIME expiration;
60
61 /* Interval of this timer. */
62 EMACS_TIME interval;
63
5f351ff1
PJ
64 /* Function to call when timer is ripe. Interrupt input is
65 guaranteed to not be blocked when this function is called. */
e12489f9
GM
66 atimer_callback fn;
67
68 /* Additional user-specified data to pass to FN. */
69 void *client_data;
70
71 /* Next in list of active or free atimers. */
72 struct atimer *next;
73};
74
75/* Function prototypes. */
76
77struct atimer *start_atimer P_ ((enum atimer_type, EMACS_TIME,
78 atimer_callback, void *));
79void cancel_atimer P_ ((struct atimer *));
80void do_pending_atimers P_ ((void));
81void init_atimer P_ ((void));
82void turn_on_atimers P_ ((int));
67a516c6
GM
83void stop_other_atimers P_ ((struct atimer *));
84void run_all_atimers P_ ((void));
85Lisp_Object unwind_stop_other_atimers P_ ((Lisp_Object));
e12489f9 86
ffd8f46e 87#endif /* EMACS_ATIMER_H */
ab5796a9
MB
88
89/* arch-tag: 02c7c1c8-45bd-4222-b874-4ca44662f60b
90 (do not change this comment) */