1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
|
--!A cross-platform build utility based on Lua
--
-- Licensed under the Apache License, Version 2.0 (the "License");
-- you may not use this file except in compliance with the License.
-- You may obtain a copy of the License at
--
-- http://www.apache.org/licenses/LICENSE-2.0
--
-- Unless required by applicable law or agreed to in writing, software
-- distributed under the License is distributed on an "AS IS" BASIS,
-- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-- See the License for the specific language governing permissions and
-- limitations under the License.
--
-- Copyright (C) 2015-present, Xmake Open Source Community.
--
-- @author ruki
-- @file poller.lua
--
-- define module
local poller = poller or {}
-- load modules
local io = require("base/io")
local string = require("base/string")
-- the poller object type, @see tbox/platform/poller.h
poller.OT_SOCK = 1
poller.OT_PIPE = 2
poller.OT_PROC = 3
poller.OT_FWATCHER = 4
-- the poller events, @see tbox/platform/poller.h
poller.EV_POLLER_RECV = 1
poller.EV_POLLER_SEND = 2
poller.EV_POLLER_CONN = poller.EV_POLLER_SEND
poller.EV_POLLER_ACPT = poller.EV_POLLER_RECV
poller.EV_POLLER_CLEAR = 0x0010 -- edge trigger. after the event is retrieved by the user, its state is reset
poller.EV_POLLER_ONESHOT = 0x0010 -- causes the event to return only the first occurrence of the filter being triggered
poller.EV_POLLER_EOF = 0x0100 -- the event flag will be marked if the connection be closed in the edge trigger
poller.EV_POLLER_ERROR = 0x0200 -- socket error after waiting
-- get poller object data
function poller:_pollerdata(cdata)
return self._POLLERDATA and self._POLLERDATA[cdata] or nil
end
-- set poller object data
function poller:_pollerdata_set(cdata, data)
local pollerdata = self._POLLERDATA
if not pollerdata then
pollerdata = {}
self._POLLERDATA = pollerdata
end
pollerdata[cdata] = data
end
-- check if the poller supports the given events
--
-- @param events the events to check
-- @return true if supported
--
function poller:support(events)
return io.poller_support(events)
end
-- spank the poller to break wait() and return immediately
function poller:spank()
io.poller_spank()
end
-- insert object events to poller
--
-- @param obj the object (pipe, socket, process, fwatcher)
-- @param events the events to monitor
-- @param udata the user data (optional)
-- @return true on success, or false and error info
--
function poller:insert(obj, events, udata)
-- insert it
local ok, errors = io.poller_insert(obj:otype(), obj:cdata(), events)
if not ok then
return false, string.format("%s: insert events(%d) to poller failed, %s", obj, events, errors or "unknown reason")
end
-- save poller object data and save obj/ref for gc
self:_pollerdata_set(obj:cdata(), {obj, udata})
return true
end
-- modify object events in poller
--
-- @param obj the object
-- @param events the new events to monitor
-- @param udata the user data (optional)
-- @return true on success, or false and error info
--
function poller:modify(obj, events, udata)
-- modify it
local ok, errors = io.poller_modify(obj:otype(), obj:cdata(), events)
if not ok then
return false, string.format("%s: modify events(%d) to poller failed, %s", obj, events, errors or "unknown reason")
end
-- update poller object data
self:_pollerdata_set(obj:cdata(), {obj, udata})
return true
end
-- remove object from poller
--
-- @param obj the object to remove
-- @return true on success, or false and error info
--
function poller:remove(obj)
-- remove it
local ok, errors = io.poller_remove(obj:otype(), obj:cdata())
if not ok then
return false, string.format("%s: remove events from poller failed, %s", obj, errors or "unknown reason")
end
-- remove poller object data
self:_pollerdata_set(obj, nil)
return true
end
-- wait for object events in poller
--
-- @param timeout the timeout in milliseconds, -1 for infinite
-- @return the number of events, or -1 on error
--
function poller:wait(timeout)
-- wait it
local events, count = io.poller_wait(timeout or -1)
if count < 0 then
return -1, "wait events in poller failed!"
end
-- check count
if count > 0 and count ~= #events then
return -1, string.format("events(%d) != %d in poller!", #events, count)
end
-- wrap objects with cdata
local results = {}
if events then
for _, v in ipairs(events) do
local otype = v[1]
local cdata = v[2]
local events = v[3]
local pollerdata = self:_pollerdata(cdata)
if not pollerdata then
return -1, string.format("no object data for cdata(%s)!", cdata)
end
local obj = pollerdata[1]
assert(obj and obj:otype() == otype and obj:cdata() == cdata)
table.insert(results, {obj, events, pollerdata[2]})
end
end
return count, results
end
-- return module
return poller
|
