rxvt-unicode/src/iom.h

/*
    iom.h -- generic I/O multiplexer
    Copyright (C) 2003, 2004 Marc Lehmann <gvpe@schmorp.de>
 
    This file is part of GVPE.

    GVPE is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.
 
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.
 
    You should have received a copy of the GNU General Public License
    along with gvpe; if not, write to the Free Software
    Foundation, Inc. 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
*/

#ifndef IOM_H__
#define IOM_H__

// required:
// - a vector template like simplevec or stl's vector
// - defines for all watcher types required in your app
// edit iom_conf.h as appropriate.
#include "iom_conf.h"

#if IOM_CHILD
# undef IOM_SIG
# define IOM_SIG 1
#endif

#include "callback.h"

typedef double tstamp;
extern tstamp NOW;

// TSTAMP_MAX must still fit into a positive struct timeval
#define TSTAMP_MAX (double)(1UL<<31)

struct watcher;
#if IOM_IO
struct io_watcher;
#endif
#if IOM_TIME
struct time_watcher;
#endif
#if IOM_CHECK
struct check_watcher;
#endif
#if IOM_IDLE
struct idle_watcher;
#endif
#if IOM_SIG
struct sig_watcher;
#endif
#if IOM_CHILD
struct child_watcher;
#endif

template<class watcher>
struct io_manager_vec : vector<watcher *> {
  void erase_unordered (unsigned int pos)
  {
    watcher *w = (*this)[this->size () - 1];
    this->pop_back ();

    if (!this->empty ())
      if (((*this)[pos] = w)) // '=' is correct!
        w->active = pos + 1;
  }
};

// only used as a namespace, and for initialisation purposes
class io_manager {
  template<class watcher>
  static void reg (watcher &w, io_manager_vec<watcher> &queue);

  template<class watcher>
  static void unreg (watcher &w, io_manager_vec<watcher> &queue);

public:
#if IOM_TIME
  // fetch time only
  static tstamp now ();

  // set NOW
  static void set_now ();
#endif

  // register a watcher
#if IOM_IO
  static void reg (io_watcher    &w); static void unreg (io_watcher    &w);
#endif
#if IOM_TIME
  static void reg (time_watcher  &w); static void unreg (time_watcher  &w);
#endif
#if IOM_CHECK
  static void reg (check_watcher &w); static void unreg (check_watcher &w);
#endif
#if IOM_IDLE
  static void reg (idle_watcher  &w); static void unreg (idle_watcher  &w);
#endif
#if IOM_SIG
  static void reg (sig_watcher   &w); static void unreg (sig_watcher   &w);
#endif
#if IOM_CHILD
  static void reg (child_watcher &w); static void unreg (child_watcher &w);
#endif
  
  static void loop ();
};

struct watcher {
  int active; /* 0 == inactive, else index into respective vector */

  watcher () : active (0) { }
};

#if IOM_IO
enum { EVENT_UNDEF = -1, EVENT_NONE = 0, EVENT_READ = 1, EVENT_WRITE = 2 };

struct io_watcher : watcher, callback2<void, io_watcher &, short> {
  int fd;
  short events;

  void set (int fd_, short events_) { fd = fd_; events = events_; }

  void set (short events_) { set (fd, events_); }
  void start () { io_manager::reg (*this); }
  void start (int fd_, short events_) { set (fd_, events_); io_manager::reg (*this); }
  void stop () { io_manager::unreg (*this); }

  template<class O1, class O2>
  io_watcher (O1 *object, void (O2::*method) (io_watcher &, short))
  : callback2<void, io_watcher &, short> (object, method)
  { }
  ~io_watcher () { stop (); }
};
#endif

#if IOM_TIME
struct time_watcher : watcher, callback1<void, time_watcher &> {
  tstamp at;

  void trigger ();

  void set (tstamp when) { at = when; }
  void operator () () { trigger (); }
  void start () { io_manager::reg (*this); }
  void start (tstamp when) { set (when); io_manager::reg (*this); }
  void stop () { io_manager::unreg (*this); }

  template<class O1, class O2>
  time_watcher (O1 *object, void (O2::*method) (time_watcher &))
  : callback1<void, time_watcher &> (object, method), at (0)
  { }
  ~time_watcher () { stop (); }
};
#endif

#if IOM_CHECK
// run before checking for new events
struct check_watcher : watcher, callback1<void, check_watcher &> {
  void start () { io_manager::reg (*this); }
  void stop () { io_manager::unreg (*this); }

  template<class O1, class O2>
  check_watcher (O1 *object, void (O2::*method) (check_watcher &))
  : callback1<void, check_watcher &> (object, method)
  { }
  ~check_watcher () { stop (); }
};
#endif

#if IOM_IDLE
// run after checking for any i/o, but before waiting
struct idle_watcher : watcher, callback1<void, idle_watcher &> {
  void start () { io_manager::reg (*this); }
  void stop () { io_manager::unreg (*this); }

  template<class O1, class O2>
  idle_watcher (O1 *object, void (O2::*method) (idle_watcher &))
    : callback1<void, idle_watcher &> (object, method)
    { }
  ~idle_watcher () { stop (); }
};
#endif

#if IOM_SIG
struct sig_watcher : watcher, callback1<void, sig_watcher &> {
  int signum;

  void start (int signum);
  void stop () { io_manager::unreg (*this); }

  template<class O1, class O2>
  sig_watcher (O1 *object, void (O2::*method) (sig_watcher &))
  : callback1<void, sig_watcher &> (object, method), signum (0)
  { }
  ~sig_watcher () { stop (); }
};
#endif

#if IOM_CHILD
struct child_watcher : watcher, callback2<void, child_watcher &, int> {
  int /*pid_t*/ pid;

  void start (int pid) { this->pid = pid; io_manager::reg (*this); }
  void stop () { io_manager::unreg (*this); }

  template<class O1, class O2>
  child_watcher (O1 *object, void (O2::*method) (child_watcher &, int status))
  : callback2<void, child_watcher &, int> (object, method), pid (0)
  { }
  ~child_watcher () { stop (); }
};
#endif

#endif

Revision:	1.25
Committed:	Thu Jan 19 09:47:15 2006 UTC (18 years, 4 months ago) by root
Content type:	text/plain
Branch:	MAIN
Changes since 1.24:	+31 -21 lines
Log Message:	* empty log message *
#	User	Rev	Content
1	pcg	1.1	/*
2	root	1.20	iom.h -- generic I/O multiplexer
3	root	1.23	Copyright (C) 2003, 2004 Marc Lehmann <gvpe@schmorp.de>
4	pcg	1.1
5	root	1.23	This file is part of GVPE.
6
7			GVPE is free software; you can redistribute it and/or modify
8	pcg	1.1	it under the terms of the GNU General Public License as published by
9			the Free Software Foundation; either version 2 of the License, or
10			(at your option) any later version.
11
12			This program is distributed in the hope that it will be useful,
13			but WITHOUT ANY WARRANTY; without even the implied warranty of
14			MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15			GNU General Public License for more details.
16
17			You should have received a copy of the GNU General Public License
18	root	1.23	along with gvpe; if not, write to the Free Software
19	root	1.22	Foundation, Inc. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20	pcg	1.1	*/
21
22	pcg	1.7	#ifndef IOM_H__
23			#define IOM_H__
24	pcg	1.1
25	pcg	1.7	// required:
26			// - a vector template like simplevec or stl's vector
27			// - defines for all watcher types required in your app
28			// edit iom_conf.h as appropriate.
29			#include "iom_conf.h"
30	pcg	1.1
31	root	1.25	#if IOM_CHILD
32			# undef IOM_SIG
33			# define IOM_SIG 1
34			#endif
35
36	pcg	1.6	#include "callback.h"
37	pcg	1.1
38	pcg	1.6	typedef double tstamp;
39			extern tstamp NOW;
40	pcg	1.2
41	root	1.23	// TSTAMP_MAX must still fit into a positive struct timeval
42			#define TSTAMP_MAX (double)(1UL<<31)
43
44	pcg	1.7	struct watcher;
45	pcg	1.2	#if IOM_IO
46	pcg	1.7	struct io_watcher;
47	pcg	1.2	#endif
48			#if IOM_TIME
49	pcg	1.7	struct time_watcher;
50	pcg	1.2	#endif
51			#if IOM_CHECK
52	pcg	1.7	struct check_watcher;
53	pcg	1.2	#endif
54	pcg	1.5	#if IOM_IDLE
55	pcg	1.7	struct idle_watcher;
56	pcg	1.5	#endif
57	pcg	1.12	#if IOM_SIG
58			struct sig_watcher;
59			#endif
60	root	1.25	#if IOM_CHILD
61			struct child_watcher;
62			#endif
63	pcg	1.1
64	pcg	1.6	template<class watcher>
65	pcg	1.10	struct io_manager_vec : vector<watcher *> {
66	pcg	1.6	void erase_unordered (unsigned int pos)
67			{
68	root	1.13	watcher w = (this)[this->size () - 1];
69			this->pop_back ();
70	pcg	1.6
71	root	1.20	if (!this->empty ())
72			if (((*this)[pos] = w)) // '=' is correct!
73	pcg	1.6	w->active = pos + 1;
74			}
75			};
76
77	root	1.15	// only used as a namespace, and for initialisation purposes
78	pcg	1.2	class io_manager {
79			template<class watcher>
80	root	1.15	static void reg (watcher &w, io_manager_vec<watcher> &queue);
81	pcg	1.1
82	pcg	1.2	template<class watcher>
83	root	1.15	static void unreg (watcher &w, io_manager_vec<watcher> &queue);
84	pcg	1.1
85			public:
86	root	1.21	#if IOM_TIME
87			// fetch time only
88			static tstamp now ();
89
90			// set NOW
91			static void set_now ();
92			#endif
93
94	pcg	1.1	// register a watcher
95	pcg	1.2	#if IOM_IO
96	root	1.15	static void reg (io_watcher &w); static void unreg (io_watcher &w);
97	pcg	1.2	#endif
98			#if IOM_TIME
99	root	1.15	static void reg (time_watcher &w); static void unreg (time_watcher &w);
100	pcg	1.2	#endif
101			#if IOM_CHECK
102	root	1.15	static void reg (check_watcher &w); static void unreg (check_watcher &w);
103	pcg	1.2	#endif
104	pcg	1.5	#if IOM_IDLE
105	root	1.15	static void reg (idle_watcher &w); static void unreg (idle_watcher &w);
106	pcg	1.5	#endif
107	pcg	1.12	#if IOM_SIG
108	root	1.15	static void reg (sig_watcher &w); static void unreg (sig_watcher &w);
109	pcg	1.12	#endif
110	root	1.25	#if IOM_CHILD
111			static void reg (child_watcher &w); static void unreg (child_watcher &w);
112			#endif
113	pcg	1.1
114	root	1.15	static void loop ();
115	pcg	1.1	};
116
117	pcg	1.6	struct watcher {
118			int active; /* 0 == inactive, else index into respective vector */
119
120	pcg	1.11	watcher () : active (0) { }
121	pcg	1.6	};
122
123	pcg	1.2	#if IOM_IO
124	root	1.24	enum { EVENT_UNDEF = -1, EVENT_NONE = 0, EVENT_READ = 1, EVENT_WRITE = 2 };
125	pcg	1.1
126	pcg	1.6	struct io_watcher : watcher, callback2<void, io_watcher &, short> {
127	pcg	1.1	int fd;
128			short events;
129
130	pcg	1.5	void set (int fd_, short events_) { fd = fd_; events = events_; }
131	pcg	1.1
132	pcg	1.5	void set (short events_) { set (fd, events_); }
133	root	1.15	void start () { io_manager::reg (*this); }
134			void start (int fd_, short events_) { set (fd_, events_); io_manager::reg (*this); }
135			void stop () { io_manager::unreg (*this); }
136	pcg	1.6
137			template<class O1, class O2>
138	pcg	1.11	io_watcher (O1 object, void (O2::method) (io_watcher &, short))
139	root	1.25	: callback2<void, io_watcher &, short> (object, method)
140	pcg	1.6	{ }
141			~io_watcher () { stop (); }
142	pcg	1.1	};
143	pcg	1.2	#endif
144	pcg	1.1
145	pcg	1.2	#if IOM_TIME
146	pcg	1.6	struct time_watcher : watcher, callback1<void, time_watcher &> {
147	pcg	1.1	tstamp at;
148
149			void trigger ();
150
151			void set (tstamp when) { at = when; }
152	pcg	1.11	void operator () () { trigger (); }
153	root	1.15	void start () { io_manager::reg (*this); }
154			void start (tstamp when) { set (when); io_manager::reg (*this); }
155			void stop () { io_manager::unreg (*this); }
156	pcg	1.1
157	pcg	1.6	template<class O1, class O2>
158	pcg	1.11	time_watcher (O1 object, void (O2::method) (time_watcher &))
159	root	1.25	: callback1<void, time_watcher &> (object, method), at (0)
160	pcg	1.6	{ }
161			~time_watcher () { stop (); }
162	pcg	1.1	};
163	pcg	1.2	#endif
164
165			#if IOM_CHECK
166			// run before checking for new events
167	pcg	1.6	struct check_watcher : watcher, callback1<void, check_watcher &> {
168	root	1.15	void start () { io_manager::reg (*this); }
169			void stop () { io_manager::unreg (*this); }
170	pcg	1.6
171	pcg	1.2	template<class O1, class O2>
172	pcg	1.11	check_watcher (O1 object, void (O2::method) (check_watcher &))
173	root	1.25	: callback1<void, check_watcher &> (object, method)
174	pcg	1.6	{ }
175			~check_watcher () { stop (); }
176	pcg	1.5	};
177			#endif
178
179			#if IOM_IDLE
180			// run after checking for any i/o, but before waiting
181	pcg	1.6	struct idle_watcher : watcher, callback1<void, idle_watcher &> {
182	root	1.15	void start () { io_manager::reg (*this); }
183			void stop () { io_manager::unreg (*this); }
184	pcg	1.6
185	pcg	1.5	template<class O1, class O2>
186	pcg	1.11	idle_watcher (O1 object, void (O2::method) (idle_watcher &))
187	root	1.25	: callback1<void, idle_watcher &> (object, method)
188	pcg	1.5	{ }
189	pcg	1.6	~idle_watcher () { stop (); }
190	pcg	1.2	};
191			#endif
192	pcg	1.1
193	pcg	1.12	#if IOM_SIG
194			struct sig_watcher : watcher, callback1<void, sig_watcher &> {
195			int signum;
196
197			void start (int signum);
198	root	1.15	void stop () { io_manager::unreg (*this); }
199	pcg	1.12
200			template<class O1, class O2>
201			sig_watcher (O1 object, void (O2::method) (sig_watcher &))
202	root	1.25	: callback1<void, sig_watcher &> (object, method), signum (0)
203	pcg	1.12	{ }
204			~sig_watcher () { stop (); }
205			};
206			#endif
207
208	root	1.25	#if IOM_CHILD
209			struct child_watcher : watcher, callback2<void, child_watcher &, int> {
210			int /pid_t/ pid;
211
212			void start (int pid) { this->pid = pid; io_manager::reg (*this); }
213			void stop () { io_manager::unreg (*this); }
214
215			template<class O1, class O2>
216			child_watcher (O1 object, void (O2::method) (child_watcher &, int status))
217			: callback2<void, child_watcher &, int> (object, method), pid (0)
218			{ }
219			~child_watcher () { stop (); }
220			};
221			#endif
222
223	pcg	1.1	#endif
224