sysmon_envsys_events.c revision 1.60 1 1.60 pgoyette /* $NetBSD: sysmon_envsys_events.c,v 1.60 2008/11/04 22:16:15 pgoyette Exp $ */
2 1.1 xtraeme
3 1.1 xtraeme /*-
4 1.51 xtraeme * Copyright (c) 2007, 2008 Juan Romero Pardines.
5 1.1 xtraeme * All rights reserved.
6 1.1 xtraeme *
7 1.1 xtraeme * Redistribution and use in source and binary forms, with or without
8 1.1 xtraeme * modification, are permitted provided that the following conditions
9 1.1 xtraeme * are met:
10 1.1 xtraeme * 1. Redistributions of source code must retain the above copyright
11 1.1 xtraeme * notice, this list of conditions and the following disclaimer.
12 1.1 xtraeme * 2. Redistributions in binary form must reproduce the above copyright
13 1.1 xtraeme * notice, this list of conditions and the following disclaimer in the
14 1.1 xtraeme * documentation and/or other materials provided with the distribution.
15 1.1 xtraeme *
16 1.36 xtraeme * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
17 1.36 xtraeme * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
18 1.36 xtraeme * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
19 1.36 xtraeme * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
20 1.36 xtraeme * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
21 1.36 xtraeme * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22 1.36 xtraeme * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23 1.36 xtraeme * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24 1.36 xtraeme * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25 1.36 xtraeme * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26 1.1 xtraeme */
27 1.1 xtraeme
28 1.1 xtraeme /*
29 1.1 xtraeme * sysmon_envsys(9) events framework.
30 1.1 xtraeme */
31 1.1 xtraeme
32 1.1 xtraeme #include <sys/cdefs.h>
33 1.60 pgoyette __KERNEL_RCSID(0, "$NetBSD: sysmon_envsys_events.c,v 1.60 2008/11/04 22:16:15 pgoyette Exp $");
34 1.1 xtraeme
35 1.1 xtraeme #include <sys/param.h>
36 1.1 xtraeme #include <sys/types.h>
37 1.1 xtraeme #include <sys/conf.h>
38 1.1 xtraeme #include <sys/errno.h>
39 1.1 xtraeme #include <sys/kernel.h>
40 1.1 xtraeme #include <sys/systm.h>
41 1.1 xtraeme #include <sys/proc.h>
42 1.1 xtraeme #include <sys/mutex.h>
43 1.1 xtraeme #include <sys/kmem.h>
44 1.1 xtraeme #include <sys/callout.h>
45 1.1 xtraeme
46 1.32 xtraeme /* #define ENVSYS_DEBUG */
47 1.56 pgoyette
48 1.1 xtraeme #include <dev/sysmon/sysmonvar.h>
49 1.1 xtraeme #include <dev/sysmon/sysmon_envsysvar.h>
50 1.1 xtraeme
51 1.10 xtraeme struct sme_sensor_event {
52 1.10 xtraeme int state;
53 1.10 xtraeme int event;
54 1.10 xtraeme };
55 1.10 xtraeme
56 1.10 xtraeme static const struct sme_sensor_event sme_sensor_event[] = {
57 1.10 xtraeme { ENVSYS_SVALID, PENVSYS_EVENT_NORMAL },
58 1.10 xtraeme { ENVSYS_SCRITOVER, PENVSYS_EVENT_CRITOVER },
59 1.10 xtraeme { ENVSYS_SCRITUNDER, PENVSYS_EVENT_CRITUNDER },
60 1.10 xtraeme { ENVSYS_SWARNOVER, PENVSYS_EVENT_WARNOVER },
61 1.10 xtraeme { ENVSYS_SWARNUNDER, PENVSYS_EVENT_WARNUNDER },
62 1.10 xtraeme { -1, -1 }
63 1.10 xtraeme };
64 1.10 xtraeme
65 1.51 xtraeme static bool sysmon_low_power;
66 1.1 xtraeme
67 1.45 xtraeme #define SME_EVTIMO (SME_EVENTS_DEFTIMEOUT * hz)
68 1.3 xtraeme
69 1.44 xtraeme static bool sme_event_check_low_power(void);
70 1.47 xtraeme static bool sme_battery_check(void);
71 1.44 xtraeme static bool sme_battery_critical(envsys_data_t *);
72 1.47 xtraeme static bool sme_acadapter_check(void);
73 1.38 xtraeme
74 1.3 xtraeme /*
75 1.1 xtraeme * sme_event_register:
76 1.1 xtraeme *
77 1.24 xtraeme * + Registers a new sysmon envsys event or updates any event
78 1.24 xtraeme * already in the queue.
79 1.1 xtraeme */
80 1.1 xtraeme int
81 1.24 xtraeme sme_event_register(prop_dictionary_t sdict, envsys_data_t *edata,
82 1.45 xtraeme struct sysmon_envsys *sme, const char *objkey,
83 1.24 xtraeme int32_t critval, int crittype, int powertype)
84 1.1 xtraeme {
85 1.51 xtraeme sme_event_t *see = NULL, *osee = NULL;
86 1.24 xtraeme prop_object_t obj;
87 1.24 xtraeme bool critvalup = false;
88 1.1 xtraeme int error = 0;
89 1.56 pgoyette int real_crittype;
90 1.56 pgoyette int32_t o_critval;
91 1.1 xtraeme
92 1.45 xtraeme KASSERT(sdict != NULL || edata != NULL || sme != NULL);
93 1.51 xtraeme /*
94 1.51 xtraeme * Allocate a new sysmon_envsys event.
95 1.51 xtraeme */
96 1.51 xtraeme see = kmem_zalloc(sizeof(*see), KM_SLEEP);
97 1.51 xtraeme if (see == NULL)
98 1.51 xtraeme return ENOMEM;
99 1.1 xtraeme
100 1.56 pgoyette /*
101 1.56 pgoyette * Map user-types to kernel types
102 1.56 pgoyette */
103 1.56 pgoyette switch (crittype) {
104 1.56 pgoyette case PENVSYS_EVENT_USER_CRITMAX:
105 1.56 pgoyette case PENVSYS_EVENT_USER_CRITMIN:
106 1.56 pgoyette case PENVSYS_EVENT_USER_WARNMAX:
107 1.56 pgoyette case PENVSYS_EVENT_USER_WARNMIN:
108 1.56 pgoyette real_crittype = PENVSYS_EVENT_USER_LIMITS;
109 1.56 pgoyette break;
110 1.56 pgoyette case PENVSYS_EVENT_BATT_USERCAP:
111 1.56 pgoyette case PENVSYS_EVENT_BATT_USERWARN:
112 1.56 pgoyette real_crittype = PENVSYS_EVENT_BATT_USER_LIMITS;
113 1.56 pgoyette break;
114 1.56 pgoyette default:
115 1.56 pgoyette real_crittype = crittype;
116 1.56 pgoyette }
117 1.56 pgoyette
118 1.1 xtraeme /*
119 1.24 xtraeme * check if the event is already on the list and return
120 1.24 xtraeme * EEXIST if value provided hasn't been changed.
121 1.1 xtraeme */
122 1.51 xtraeme mutex_enter(&sme->sme_mtx);
123 1.51 xtraeme LIST_FOREACH(osee, &sme->sme_events_list, see_list) {
124 1.51 xtraeme if (strcmp(edata->desc, osee->see_pes.pes_sensname) == 0)
125 1.56 pgoyette if (real_crittype == osee->see_type) {
126 1.56 pgoyette switch (crittype) {
127 1.56 pgoyette case PENVSYS_EVENT_USER_CRITMAX:
128 1.56 pgoyette case PENVSYS_EVENT_BATT_USERCAP:
129 1.56 pgoyette o_critval = osee->see_critmax;
130 1.56 pgoyette break;
131 1.56 pgoyette case PENVSYS_EVENT_USER_WARNMAX:
132 1.56 pgoyette case PENVSYS_EVENT_BATT_USERWARN:
133 1.56 pgoyette o_critval = osee->see_warnmax;
134 1.56 pgoyette break;
135 1.56 pgoyette case PENVSYS_EVENT_USER_WARNMIN:
136 1.56 pgoyette o_critval = osee->see_warnmin;
137 1.56 pgoyette break;
138 1.56 pgoyette case PENVSYS_EVENT_USER_CRITMIN:
139 1.56 pgoyette default:
140 1.56 pgoyette o_critval = osee->see_critmin;
141 1.56 pgoyette break;
142 1.56 pgoyette }
143 1.56 pgoyette if (o_critval == critval) {
144 1.24 xtraeme DPRINTF(("%s: dev=%s sensor=%s type=%d "
145 1.24 xtraeme "(already exists)\n", __func__,
146 1.51 xtraeme osee->see_pes.pes_dvname,
147 1.51 xtraeme osee->see_pes.pes_sensname,
148 1.51 xtraeme osee->see_type));
149 1.52 rmind error = EEXIST;
150 1.52 rmind goto out;
151 1.24 xtraeme }
152 1.24 xtraeme critvalup = true;
153 1.24 xtraeme break;
154 1.1 xtraeme }
155 1.24 xtraeme }
156 1.24 xtraeme
157 1.24 xtraeme /*
158 1.24 xtraeme * Critical condition operation requested by userland.
159 1.24 xtraeme */
160 1.24 xtraeme if (objkey && critval && critvalup) {
161 1.24 xtraeme obj = prop_dictionary_get(sdict, objkey);
162 1.45 xtraeme if (obj && prop_object_type(obj) == PROP_TYPE_NUMBER) {
163 1.24 xtraeme /*
164 1.24 xtraeme * object is already in dictionary and value
165 1.24 xtraeme * provided is not the same than we have
166 1.51 xtraeme * currently, update the critical value.
167 1.24 xtraeme */
168 1.56 pgoyette switch (crittype) {
169 1.56 pgoyette case PENVSYS_EVENT_USER_CRITMAX:
170 1.56 pgoyette case PENVSYS_EVENT_BATT_USERCAP:
171 1.56 pgoyette osee->see_critmax = critval;
172 1.56 pgoyette break;
173 1.56 pgoyette case PENVSYS_EVENT_USER_WARNMAX:
174 1.56 pgoyette case PENVSYS_EVENT_BATT_USERWARN:
175 1.56 pgoyette osee->see_warnmax = critval;
176 1.56 pgoyette break;
177 1.56 pgoyette case PENVSYS_EVENT_USER_WARNMIN:
178 1.56 pgoyette osee->see_warnmin = critval;
179 1.56 pgoyette break;
180 1.56 pgoyette case PENVSYS_EVENT_USER_CRITMIN:
181 1.56 pgoyette default:
182 1.56 pgoyette osee->see_critmin = critval;
183 1.56 pgoyette break;
184 1.56 pgoyette }
185 1.51 xtraeme DPRINTF(("%s: (%s) event [sensor=%s type=%d] "
186 1.45 xtraeme "(critval updated)\n", __func__, sme->sme_name,
187 1.51 xtraeme edata->desc, osee->see_type));
188 1.24 xtraeme error = sme_sensor_upint32(sdict, objkey, critval);
189 1.52 rmind goto out;
190 1.1 xtraeme }
191 1.1 xtraeme }
192 1.1 xtraeme
193 1.51 xtraeme /*
194 1.56 pgoyette * New limit defined for existing event
195 1.56 pgoyette */
196 1.56 pgoyette if (osee != NULL) {
197 1.56 pgoyette osee->see_edata = edata;
198 1.56 pgoyette switch (crittype) {
199 1.56 pgoyette case PENVSYS_EVENT_USER_CRITMAX:
200 1.56 pgoyette case PENVSYS_EVENT_BATT_USERCAP:
201 1.56 pgoyette osee->see_critmax = critval;
202 1.56 pgoyette break;
203 1.56 pgoyette case PENVSYS_EVENT_USER_WARNMAX:
204 1.56 pgoyette case PENVSYS_EVENT_BATT_USERWARN:
205 1.56 pgoyette osee->see_warnmax = critval;
206 1.56 pgoyette break;
207 1.56 pgoyette case PENVSYS_EVENT_USER_WARNMIN:
208 1.56 pgoyette osee->see_warnmin = critval;
209 1.56 pgoyette break;
210 1.56 pgoyette case PENVSYS_EVENT_USER_CRITMIN:
211 1.56 pgoyette default:
212 1.56 pgoyette osee->see_critmin = critval;
213 1.56 pgoyette break;
214 1.56 pgoyette }
215 1.56 pgoyette if (objkey && critval) {
216 1.56 pgoyette error = sme_sensor_upint32(sdict, objkey, critval);
217 1.56 pgoyette if (error)
218 1.56 pgoyette goto out;
219 1.56 pgoyette }
220 1.56 pgoyette DPRINTF(("%s: (%s) new limit added to existing event, type %d "
221 1.56 pgoyette "critmin=%" PRIu32 " warnmin=%" PRIu32 " warnmax=%"
222 1.56 pgoyette PRIu32 " critmax=%d\n", __func__, osee->see_sme->sme_name,
223 1.56 pgoyette osee->see_type, osee->see_critmin, osee->see_warnmin,
224 1.56 pgoyette osee->see_warnmax, osee->see_critmax));
225 1.56 pgoyette goto out;
226 1.56 pgoyette }
227 1.56 pgoyette /*
228 1.51 xtraeme * New event requested.
229 1.24 xtraeme */
230 1.45 xtraeme see->see_edata = edata;
231 1.56 pgoyette switch (crittype) {
232 1.56 pgoyette case PENVSYS_EVENT_USER_CRITMAX:
233 1.56 pgoyette case PENVSYS_EVENT_BATT_USERCAP:
234 1.56 pgoyette see->see_critmax = critval;
235 1.56 pgoyette break;
236 1.56 pgoyette case PENVSYS_EVENT_USER_WARNMAX:
237 1.56 pgoyette case PENVSYS_EVENT_BATT_USERWARN:
238 1.56 pgoyette see->see_warnmax = critval;
239 1.56 pgoyette break;
240 1.56 pgoyette case PENVSYS_EVENT_USER_WARNMIN:
241 1.56 pgoyette see->see_warnmin = critval;
242 1.56 pgoyette break;
243 1.56 pgoyette case PENVSYS_EVENT_USER_CRITMIN:
244 1.56 pgoyette default:
245 1.56 pgoyette see->see_critmin = critval;
246 1.56 pgoyette break;
247 1.56 pgoyette }
248 1.56 pgoyette see->see_type = real_crittype;
249 1.45 xtraeme see->see_sme = sme;
250 1.57 pgoyette
251 1.57 pgoyette /* Initialize sensor type and previously-sent state */
252 1.57 pgoyette
253 1.57 pgoyette see->see_pes.pes_type = powertype;
254 1.57 pgoyette switch (powertype) {
255 1.57 pgoyette case PENVSYS_TYPE_BATTERY:
256 1.57 pgoyette see->see_evsent = ENVSYS_BATTERY_CAPACITY_NORMAL;
257 1.57 pgoyette break;
258 1.57 pgoyette case PENVSYS_TYPE_DRIVE:
259 1.57 pgoyette see->see_evsent = ENVSYS_DRIVE_EMPTY;
260 1.57 pgoyette break;
261 1.57 pgoyette case PENVSYS_TYPE_FAN:
262 1.57 pgoyette case PENVSYS_TYPE_INDICATOR:
263 1.57 pgoyette case PENVSYS_TYPE_TEMP:
264 1.57 pgoyette case PENVSYS_TYPE_POWER:
265 1.57 pgoyette case PENVSYS_TYPE_RESISTANCE:
266 1.57 pgoyette case PENVSYS_TYPE_VOLTAGE:
267 1.57 pgoyette see->see_evsent = ENVSYS_SVALID;
268 1.57 pgoyette break;
269 1.57 pgoyette default:
270 1.57 pgoyette see->see_evsent = 0;
271 1.57 pgoyette }
272 1.57 pgoyette
273 1.45 xtraeme (void)strlcpy(see->see_pes.pes_dvname, sme->sme_name,
274 1.45 xtraeme sizeof(see->see_pes.pes_dvname));
275 1.45 xtraeme (void)strlcpy(see->see_pes.pes_sensname, edata->desc,
276 1.45 xtraeme sizeof(see->see_pes.pes_sensname));
277 1.24 xtraeme
278 1.45 xtraeme LIST_INSERT_HEAD(&sme->sme_events_list, see, see_list);
279 1.27 xtraeme if (objkey && critval) {
280 1.27 xtraeme error = sme_sensor_upint32(sdict, objkey, critval);
281 1.45 xtraeme if (error)
282 1.27 xtraeme goto out;
283 1.27 xtraeme }
284 1.51 xtraeme DPRINTF(("%s: (%s) event registered (sensor=%s snum=%d type=%d "
285 1.56 pgoyette "critmin=%" PRIu32 " warnmin=%" PRIu32 " warnmax=%" PRIu32
286 1.56 pgoyette " crixmax=%" PRIu32 ")\n", __func__,
287 1.45 xtraeme see->see_sme->sme_name, see->see_pes.pes_sensname,
288 1.56 pgoyette see->see_edata->sensor, see->see_type, see->see_critmin,
289 1.56 pgoyette see->see_warnmin, see->see_warnmax, see->see_critmax));
290 1.1 xtraeme /*
291 1.45 xtraeme * Initialize the events framework if it wasn't initialized before.
292 1.1 xtraeme */
293 1.45 xtraeme if ((sme->sme_flags & SME_CALLOUT_INITIALIZED) == 0)
294 1.45 xtraeme error = sme_events_init(sme);
295 1.27 xtraeme out:
296 1.51 xtraeme mutex_exit(&sme->sme_mtx);
297 1.53 xtraeme if (error || critvalup)
298 1.24 xtraeme kmem_free(see, sizeof(*see));
299 1.1 xtraeme return error;
300 1.1 xtraeme }
301 1.1 xtraeme
302 1.1 xtraeme /*
303 1.18 xtraeme * sme_event_unregister_all:
304 1.18 xtraeme *
305 1.51 xtraeme * + Unregisters all events associated with a sysmon envsys device.
306 1.18 xtraeme */
307 1.18 xtraeme void
308 1.45 xtraeme sme_event_unregister_all(struct sysmon_envsys *sme)
309 1.18 xtraeme {
310 1.18 xtraeme sme_event_t *see;
311 1.18 xtraeme int evcounter = 0;
312 1.18 xtraeme
313 1.45 xtraeme KASSERT(sme != NULL);
314 1.18 xtraeme
315 1.51 xtraeme mutex_enter(&sme->sme_mtx);
316 1.45 xtraeme LIST_FOREACH(see, &sme->sme_events_list, see_list) {
317 1.56 pgoyette while (see->see_flags & SEE_EVENT_WORKING)
318 1.51 xtraeme cv_wait(&sme->sme_condvar, &sme->sme_mtx);
319 1.51 xtraeme
320 1.45 xtraeme if (strcmp(see->see_pes.pes_dvname, sme->sme_name) == 0)
321 1.18 xtraeme evcounter++;
322 1.18 xtraeme }
323 1.18 xtraeme
324 1.18 xtraeme DPRINTF(("%s: total events %d (%s)\n", __func__,
325 1.45 xtraeme evcounter, sme->sme_name));
326 1.18 xtraeme
327 1.45 xtraeme while ((see = LIST_FIRST(&sme->sme_events_list))) {
328 1.18 xtraeme if (evcounter == 0)
329 1.18 xtraeme break;
330 1.18 xtraeme
331 1.45 xtraeme if (strcmp(see->see_pes.pes_dvname, sme->sme_name) == 0) {
332 1.51 xtraeme LIST_REMOVE(see, see_list);
333 1.18 xtraeme DPRINTF(("%s: event %s %d removed (%s)\n", __func__,
334 1.45 xtraeme see->see_pes.pes_sensname, see->see_type,
335 1.45 xtraeme sme->sme_name));
336 1.18 xtraeme kmem_free(see, sizeof(*see));
337 1.18 xtraeme evcounter--;
338 1.18 xtraeme }
339 1.18 xtraeme }
340 1.18 xtraeme
341 1.51 xtraeme if (LIST_EMPTY(&sme->sme_events_list))
342 1.45 xtraeme if (sme->sme_flags & SME_CALLOUT_INITIALIZED)
343 1.45 xtraeme sme_events_destroy(sme);
344 1.51 xtraeme mutex_exit(&sme->sme_mtx);
345 1.18 xtraeme }
346 1.18 xtraeme
347 1.18 xtraeme /*
348 1.1 xtraeme * sme_event_unregister:
349 1.1 xtraeme *
350 1.45 xtraeme * + Unregisters an event from the specified sysmon envsys device.
351 1.1 xtraeme */
352 1.1 xtraeme int
353 1.45 xtraeme sme_event_unregister(struct sysmon_envsys *sme, const char *sensor, int type)
354 1.1 xtraeme {
355 1.1 xtraeme sme_event_t *see;
356 1.1 xtraeme bool found = false;
357 1.1 xtraeme
358 1.1 xtraeme KASSERT(sensor != NULL);
359 1.1 xtraeme
360 1.51 xtraeme mutex_enter(&sme->sme_mtx);
361 1.45 xtraeme LIST_FOREACH(see, &sme->sme_events_list, see_list) {
362 1.45 xtraeme if (strcmp(see->see_pes.pes_sensname, sensor) == 0) {
363 1.45 xtraeme if (see->see_type == type) {
364 1.1 xtraeme found = true;
365 1.1 xtraeme break;
366 1.1 xtraeme }
367 1.1 xtraeme }
368 1.1 xtraeme }
369 1.1 xtraeme
370 1.51 xtraeme if (!found) {
371 1.51 xtraeme mutex_exit(&sme->sme_mtx);
372 1.1 xtraeme return EINVAL;
373 1.51 xtraeme }
374 1.1 xtraeme
375 1.51 xtraeme /*
376 1.51 xtraeme * Wait for the event to finish its work, remove from the list
377 1.51 xtraeme * and release resouces.
378 1.51 xtraeme */
379 1.56 pgoyette while (see->see_flags & SEE_EVENT_WORKING)
380 1.51 xtraeme cv_wait(&sme->sme_condvar, &sme->sme_mtx);
381 1.15 xtraeme
382 1.51 xtraeme DPRINTF(("%s: removed dev=%s sensor=%s type=%d\n",
383 1.45 xtraeme __func__, see->see_pes.pes_dvname, sensor, type));
384 1.1 xtraeme LIST_REMOVE(see, see_list);
385 1.1 xtraeme /*
386 1.1 xtraeme * So the events list is empty, we'll do the following:
387 1.1 xtraeme *
388 1.9 xtraeme * - stop and destroy the callout.
389 1.1 xtraeme * - destroy the workqueue.
390 1.1 xtraeme */
391 1.51 xtraeme if (LIST_EMPTY(&sme->sme_events_list))
392 1.45 xtraeme sme_events_destroy(sme);
393 1.51 xtraeme mutex_exit(&sme->sme_mtx);
394 1.1 xtraeme
395 1.20 xtraeme kmem_free(see, sizeof(*see));
396 1.1 xtraeme return 0;
397 1.1 xtraeme }
398 1.1 xtraeme
399 1.1 xtraeme /*
400 1.1 xtraeme * sme_event_drvadd:
401 1.1 xtraeme *
402 1.45 xtraeme * + Registers a new event for a device that had enabled any of
403 1.45 xtraeme * the monitoring flags in the driver.
404 1.1 xtraeme */
405 1.1 xtraeme void
406 1.1 xtraeme sme_event_drvadd(void *arg)
407 1.1 xtraeme {
408 1.1 xtraeme sme_event_drv_t *sed_t = arg;
409 1.2 xtraeme int error = 0;
410 1.1 xtraeme
411 1.1 xtraeme KASSERT(sed_t != NULL);
412 1.1 xtraeme
413 1.1 xtraeme #define SEE_REGEVENT(a, b, c) \
414 1.1 xtraeme do { \
415 1.45 xtraeme if (sed_t->sed_edata->flags & (a)) { \
416 1.36 xtraeme char str[ENVSYS_DESCLEN] = "monitoring-state-"; \
417 1.1 xtraeme \
418 1.45 xtraeme error = sme_event_register(sed_t->sed_sdict, \
419 1.45 xtraeme sed_t->sed_edata, \
420 1.45 xtraeme sed_t->sed_sme, \
421 1.2 xtraeme NULL, \
422 1.2 xtraeme 0, \
423 1.2 xtraeme (b), \
424 1.45 xtraeme sed_t->sed_powertype); \
425 1.2 xtraeme if (error && error != EEXIST) \
426 1.2 xtraeme printf("%s: failed to add event! " \
427 1.2 xtraeme "error=%d sensor=%s event=%s\n", \
428 1.45 xtraeme __func__, error, \
429 1.45 xtraeme sed_t->sed_edata->desc, (c)); \
430 1.2 xtraeme else { \
431 1.2 xtraeme (void)strlcat(str, (c), sizeof(str)); \
432 1.45 xtraeme prop_dictionary_set_bool(sed_t->sed_sdict, \
433 1.2 xtraeme str, \
434 1.2 xtraeme true); \
435 1.2 xtraeme } \
436 1.1 xtraeme } \
437 1.1 xtraeme } while (/* CONSTCOND */ 0)
438 1.1 xtraeme
439 1.1 xtraeme SEE_REGEVENT(ENVSYS_FMONCRITICAL,
440 1.1 xtraeme PENVSYS_EVENT_CRITICAL,
441 1.1 xtraeme "critical");
442 1.1 xtraeme
443 1.56 pgoyette SEE_REGEVENT(ENVSYS_FMONCRITUNDER | ENVSYS_FMONCRITOVER |
444 1.56 pgoyette ENVSYS_FMONWARNUNDER | ENVSYS_FMONWARNOVER,
445 1.56 pgoyette PENVSYS_EVENT_HW_LIMITS,
446 1.56 pgoyette "hw-range-limits");
447 1.1 xtraeme
448 1.28 xtraeme SEE_REGEVENT(ENVSYS_FMONSTCHANGED,
449 1.28 xtraeme PENVSYS_EVENT_STATE_CHANGED,
450 1.28 xtraeme "state-changed");
451 1.1 xtraeme
452 1.45 xtraeme /*
453 1.45 xtraeme * we are done, free memory now.
454 1.45 xtraeme */
455 1.1 xtraeme kmem_free(sed_t, sizeof(*sed_t));
456 1.1 xtraeme }
457 1.1 xtraeme
458 1.1 xtraeme /*
459 1.1 xtraeme * sme_events_init:
460 1.1 xtraeme *
461 1.45 xtraeme * + Initialize the events framework for this device.
462 1.1 xtraeme */
463 1.1 xtraeme int
464 1.45 xtraeme sme_events_init(struct sysmon_envsys *sme)
465 1.1 xtraeme {
466 1.51 xtraeme int error = 0;
467 1.45 xtraeme uint64_t timo;
468 1.1 xtraeme
469 1.45 xtraeme KASSERT(sme != NULL);
470 1.51 xtraeme KASSERT(mutex_owned(&sme->sme_mtx));
471 1.22 xtraeme
472 1.45 xtraeme if (sme->sme_events_timeout)
473 1.45 xtraeme timo = sme->sme_events_timeout * hz;
474 1.45 xtraeme else
475 1.45 xtraeme timo = SME_EVTIMO;
476 1.45 xtraeme
477 1.45 xtraeme error = workqueue_create(&sme->sme_wq, sme->sme_name,
478 1.45 xtraeme sme_events_worker, sme, PRI_NONE, IPL_SOFTCLOCK, WQ_MPSAFE);
479 1.1 xtraeme if (error)
480 1.51 xtraeme return error;
481 1.1 xtraeme
482 1.51 xtraeme mutex_init(&sme->sme_callout_mtx, MUTEX_DEFAULT, IPL_SOFTCLOCK);
483 1.54 xtraeme callout_init(&sme->sme_callout, CALLOUT_MPSAFE);
484 1.45 xtraeme callout_setfunc(&sme->sme_callout, sme_events_check, sme);
485 1.45 xtraeme callout_schedule(&sme->sme_callout, timo);
486 1.45 xtraeme sme->sme_flags |= SME_CALLOUT_INITIALIZED;
487 1.45 xtraeme DPRINTF(("%s: events framework initialized for '%s'\n",
488 1.45 xtraeme __func__, sme->sme_name));
489 1.1 xtraeme
490 1.1 xtraeme return error;
491 1.1 xtraeme }
492 1.1 xtraeme
493 1.1 xtraeme /*
494 1.18 xtraeme * sme_events_destroy:
495 1.18 xtraeme *
496 1.51 xtraeme * + Destroys the event framework for this device: callout
497 1.51 xtraeme * stopped, workqueue destroyed and callout mutex destroyed.
498 1.18 xtraeme */
499 1.18 xtraeme void
500 1.45 xtraeme sme_events_destroy(struct sysmon_envsys *sme)
501 1.18 xtraeme {
502 1.51 xtraeme KASSERT(mutex_owned(&sme->sme_mtx));
503 1.22 xtraeme
504 1.45 xtraeme callout_stop(&sme->sme_callout);
505 1.54 xtraeme workqueue_destroy(sme->sme_wq);
506 1.54 xtraeme mutex_destroy(&sme->sme_callout_mtx);
507 1.54 xtraeme callout_destroy(&sme->sme_callout);
508 1.45 xtraeme sme->sme_flags &= ~SME_CALLOUT_INITIALIZED;
509 1.45 xtraeme DPRINTF(("%s: events framework destroyed for '%s'\n",
510 1.45 xtraeme __func__, sme->sme_name));
511 1.18 xtraeme }
512 1.18 xtraeme
513 1.18 xtraeme /*
514 1.1 xtraeme * sme_events_check:
515 1.1 xtraeme *
516 1.51 xtraeme * + Passes the events to the workqueue thread and stops
517 1.51 xtraeme * the callout if the 'low-power' condition is triggered.
518 1.1 xtraeme */
519 1.1 xtraeme void
520 1.1 xtraeme sme_events_check(void *arg)
521 1.1 xtraeme {
522 1.45 xtraeme struct sysmon_envsys *sme = arg;
523 1.1 xtraeme sme_event_t *see;
524 1.45 xtraeme uint64_t timo;
525 1.45 xtraeme
526 1.45 xtraeme KASSERT(sme != NULL);
527 1.45 xtraeme
528 1.51 xtraeme mutex_enter(&sme->sme_callout_mtx);
529 1.51 xtraeme LIST_FOREACH(see, &sme->sme_events_list, see_list) {
530 1.45 xtraeme workqueue_enqueue(sme->sme_wq, &see->see_wk, NULL);
531 1.56 pgoyette see->see_edata->flags |= ENVSYS_FNEED_REFRESH;
532 1.51 xtraeme }
533 1.45 xtraeme if (sme->sme_events_timeout)
534 1.45 xtraeme timo = sme->sme_events_timeout * hz;
535 1.45 xtraeme else
536 1.45 xtraeme timo = SME_EVTIMO;
537 1.38 xtraeme if (!sysmon_low_power)
538 1.45 xtraeme callout_schedule(&sme->sme_callout, timo);
539 1.51 xtraeme mutex_exit(&sme->sme_callout_mtx);
540 1.1 xtraeme }
541 1.1 xtraeme
542 1.1 xtraeme /*
543 1.1 xtraeme * sme_events_worker:
544 1.1 xtraeme *
545 1.1 xtraeme * + workqueue thread that checks if there's a critical condition
546 1.51 xtraeme * and sends an event if it was triggered.
547 1.1 xtraeme */
548 1.1 xtraeme void
549 1.1 xtraeme sme_events_worker(struct work *wk, void *arg)
550 1.1 xtraeme {
551 1.28 xtraeme const struct sme_description_table *sdt = NULL;
552 1.10 xtraeme const struct sme_sensor_event *sse = sme_sensor_event;
553 1.1 xtraeme sme_event_t *see = (void *)wk;
554 1.51 xtraeme struct sysmon_envsys *sme = see->see_sme;
555 1.51 xtraeme envsys_data_t *edata = see->see_edata;
556 1.51 xtraeme int i, state = 0;
557 1.1 xtraeme
558 1.1 xtraeme KASSERT(wk == &see->see_wk);
559 1.51 xtraeme KASSERT(sme != NULL || edata != NULL);
560 1.1 xtraeme
561 1.51 xtraeme mutex_enter(&sme->sme_mtx);
562 1.56 pgoyette if ((see->see_flags & SEE_EVENT_WORKING) == 0)
563 1.56 pgoyette see->see_flags |= SEE_EVENT_WORKING;
564 1.1 xtraeme /*
565 1.56 pgoyette * sme_events_check marks the first event for the device to
566 1.56 pgoyette * mak us refresh it here. Don't refresh if the driver uses
567 1.56 pgoyette * its own method for refreshing.
568 1.1 xtraeme */
569 1.45 xtraeme if ((sme->sme_flags & SME_DISABLE_REFRESH) == 0) {
570 1.56 pgoyette if ((see->see_edata->flags & ENVSYS_FNEED_REFRESH) != 0) {
571 1.51 xtraeme /* refresh sensor in device */
572 1.51 xtraeme (*sme->sme_refresh)(sme, edata);
573 1.56 pgoyette see->see_edata->flags &= ~ENVSYS_FNEED_REFRESH;
574 1.42 xtraeme }
575 1.1 xtraeme }
576 1.1 xtraeme
577 1.56 pgoyette DPRINTFOBJ(("%s: (%s) desc=%s sensor=%d type=%d state=%d units=%d "
578 1.51 xtraeme "value_cur=%d\n", __func__, sme->sme_name, edata->desc,
579 1.56 pgoyette edata->sensor, see->see_type, edata->state, edata->units,
580 1.56 pgoyette edata->value_cur));
581 1.1 xtraeme
582 1.50 xtraeme /* skip the event if current sensor is in invalid state */
583 1.51 xtraeme if (edata->state == ENVSYS_SINVALID)
584 1.50 xtraeme goto out;
585 1.50 xtraeme
586 1.45 xtraeme switch (see->see_type) {
587 1.10 xtraeme /*
588 1.56 pgoyette * For user range limits, calculate a new state first
589 1.56 pgoyette * State based on user limits will override any hardware
590 1.56 pgoyette * detected state.
591 1.56 pgoyette */
592 1.56 pgoyette case PENVSYS_EVENT_USER_LIMITS:
593 1.56 pgoyette case PENVSYS_EVENT_BATT_USER_LIMITS:
594 1.56 pgoyette #define __EXCEEDED_LIMIT(lim, rel) ((lim) && edata->value_cur rel (lim))
595 1.56 pgoyette if __EXCEEDED_LIMIT(see->see_critmin, <)
596 1.56 pgoyette edata->state = ENVSYS_SCRITUNDER;
597 1.56 pgoyette else if __EXCEEDED_LIMIT(see->see_warnmin, <)
598 1.56 pgoyette edata->state = ENVSYS_SWARNUNDER;
599 1.56 pgoyette else if __EXCEEDED_LIMIT(see->see_warnmax, >)
600 1.56 pgoyette edata->state = ENVSYS_SWARNOVER;
601 1.56 pgoyette else if __EXCEEDED_LIMIT(see->see_critmax, >)
602 1.56 pgoyette edata->state = ENVSYS_SCRITOVER;
603 1.56 pgoyette /* FALLTHROUGH */
604 1.56 pgoyette #undef __EXCEED_LIMIT
605 1.56 pgoyette /*
606 1.56 pgoyette * For hardware and user range limits, send event if state has changed
607 1.10 xtraeme */
608 1.56 pgoyette case PENVSYS_EVENT_HW_LIMITS:
609 1.58 pgoyette if (edata->state == see->see_evsent)
610 1.58 pgoyette break;
611 1.56 pgoyette
612 1.58 pgoyette for (i = 0; sse[i].state != -1; i++)
613 1.58 pgoyette if (sse[i].state == edata->state)
614 1.10 xtraeme break;
615 1.1 xtraeme
616 1.58 pgoyette if (sse[i].state == -1)
617 1.58 pgoyette break;
618 1.58 pgoyette
619 1.58 pgoyette if (edata->state == ENVSYS_SVALID)
620 1.58 pgoyette sysmon_penvsys_event(&see->see_pes,
621 1.58 pgoyette PENVSYS_EVENT_NORMAL);
622 1.58 pgoyette else
623 1.58 pgoyette sysmon_penvsys_event(&see->see_pes, sse[i].event);
624 1.58 pgoyette
625 1.58 pgoyette see->see_evsent = edata->state;
626 1.58 pgoyette
627 1.58 pgoyette break;
628 1.1 xtraeme
629 1.58 pgoyette /*
630 1.59 pgoyette * Send PENVSYS_EVENT_CRITICAL event if:
631 1.59 pgoyette * State has gone from non-CRITICAL to CRITICAL,
632 1.59 pgoyette * State remains CRITICAL and value has changed, or
633 1.59 pgoyette * State has returned from CRITICAL to non-CRITICAL
634 1.58 pgoyette */
635 1.58 pgoyette case PENVSYS_EVENT_CRITICAL:
636 1.59 pgoyette if (edata->state == ENVSYS_SVALID &&
637 1.59 pgoyette see->see_evsent != 0) {
638 1.58 pgoyette sysmon_penvsys_event(&see->see_pes,
639 1.58 pgoyette PENVSYS_EVENT_NORMAL);
640 1.59 pgoyette see->see_evsent = 0;
641 1.59 pgoyette } else if (edata->state == ENVSYS_SCRITICAL &&
642 1.59 pgoyette see->see_evsent != edata->value_cur) {
643 1.58 pgoyette sysmon_penvsys_event(&see->see_pes,
644 1.58 pgoyette PENVSYS_EVENT_CRITICAL);
645 1.60 pgoyette see->see_evsent = edata->value_cur;
646 1.56 pgoyette }
647 1.1 xtraeme break;
648 1.1 xtraeme
649 1.10 xtraeme /*
650 1.28 xtraeme * if value_cur is not normal (battery) or online (drive),
651 1.28 xtraeme * send the event...
652 1.10 xtraeme */
653 1.28 xtraeme case PENVSYS_EVENT_STATE_CHANGED:
654 1.45 xtraeme /*
655 1.45 xtraeme * the state has not been changed, just ignore the event.
656 1.45 xtraeme */
657 1.51 xtraeme if (edata->value_cur == see->see_evsent)
658 1.1 xtraeme break;
659 1.1 xtraeme
660 1.51 xtraeme switch (edata->units) {
661 1.28 xtraeme case ENVSYS_DRIVE:
662 1.28 xtraeme sdt = sme_get_description_table(SME_DESC_DRIVE_STATES);
663 1.28 xtraeme state = ENVSYS_DRIVE_ONLINE;
664 1.28 xtraeme break;
665 1.44 xtraeme case ENVSYS_BATTERY_CAPACITY:
666 1.51 xtraeme sdt = sme_get_description_table(
667 1.51 xtraeme SME_DESC_BATTERY_CAPACITY);
668 1.44 xtraeme state = ENVSYS_BATTERY_CAPACITY_NORMAL;
669 1.28 xtraeme break;
670 1.34 xtraeme default:
671 1.35 xtraeme panic("%s: invalid units for ENVSYS_FMONSTCHANGED",
672 1.35 xtraeme __func__);
673 1.28 xtraeme }
674 1.28 xtraeme
675 1.28 xtraeme for (i = 0; sdt[i].type != -1; i++)
676 1.51 xtraeme if (sdt[i].type == edata->value_cur)
677 1.1 xtraeme break;
678 1.1 xtraeme
679 1.51 xtraeme if (sdt[i].type == -1)
680 1.51 xtraeme break;
681 1.51 xtraeme
682 1.45 xtraeme /*
683 1.45 xtraeme * copy current state description.
684 1.45 xtraeme */
685 1.45 xtraeme (void)strlcpy(see->see_pes.pes_statedesc, sdt[i].desc,
686 1.45 xtraeme sizeof(see->see_pes.pes_statedesc));
687 1.1 xtraeme
688 1.45 xtraeme /*
689 1.45 xtraeme * state is ok again... send a normal event.
690 1.45 xtraeme */
691 1.56 pgoyette if (see->see_evsent && edata->value_cur == state) {
692 1.56 pgoyette sysmon_penvsys_event(&see->see_pes,
693 1.56 pgoyette PENVSYS_EVENT_NORMAL);
694 1.56 pgoyette see->see_evsent = false;
695 1.56 pgoyette }
696 1.1 xtraeme
697 1.45 xtraeme /*
698 1.45 xtraeme * state has been changed... send event.
699 1.45 xtraeme */
700 1.51 xtraeme if (see->see_evsent || edata->value_cur != state) {
701 1.45 xtraeme /*
702 1.45 xtraeme * save current drive state.
703 1.45 xtraeme */
704 1.51 xtraeme see->see_evsent = edata->value_cur;
705 1.45 xtraeme sysmon_penvsys_event(&see->see_pes, see->see_type);
706 1.1 xtraeme }
707 1.1 xtraeme
708 1.49 xtraeme /*
709 1.49 xtraeme * There's no need to continue if it's a drive sensor.
710 1.49 xtraeme */
711 1.51 xtraeme if (edata->units == ENVSYS_DRIVE)
712 1.49 xtraeme break;
713 1.49 xtraeme
714 1.39 xtraeme /*
715 1.39 xtraeme * Check if the system is running in low power and send the
716 1.39 xtraeme * event to powerd (if running) or shutdown the system
717 1.39 xtraeme * otherwise.
718 1.39 xtraeme */
719 1.39 xtraeme if (!sysmon_low_power && sme_event_check_low_power()) {
720 1.39 xtraeme struct penvsys_state pes;
721 1.39 xtraeme
722 1.45 xtraeme /*
723 1.45 xtraeme * Stop the callout and send the 'low-power' event.
724 1.45 xtraeme */
725 1.45 xtraeme sysmon_low_power = true;
726 1.45 xtraeme callout_stop(&sme->sme_callout);
727 1.39 xtraeme pes.pes_type = PENVSYS_TYPE_BATTERY;
728 1.39 xtraeme sysmon_penvsys_event(&pes, PENVSYS_EVENT_LOW_POWER);
729 1.39 xtraeme }
730 1.1 xtraeme break;
731 1.56 pgoyette default:
732 1.56 pgoyette panic("%s: invalid event type %d", __func__, see->see_type);
733 1.1 xtraeme }
734 1.45 xtraeme
735 1.50 xtraeme out:
736 1.56 pgoyette see->see_flags &= ~SEE_EVENT_WORKING;
737 1.51 xtraeme cv_broadcast(&sme->sme_condvar);
738 1.51 xtraeme mutex_exit(&sme->sme_mtx);
739 1.1 xtraeme }
740 1.38 xtraeme
741 1.47 xtraeme /*
742 1.51 xtraeme * Returns true if the system is in low power state: an AC adapter
743 1.51 xtraeme * is OFF and all batteries are in LOW/CRITICAL state.
744 1.47 xtraeme */
745 1.44 xtraeme static bool
746 1.38 xtraeme sme_event_check_low_power(void)
747 1.38 xtraeme {
748 1.47 xtraeme if (!sme_acadapter_check())
749 1.47 xtraeme return false;
750 1.47 xtraeme
751 1.47 xtraeme return sme_battery_check();
752 1.47 xtraeme }
753 1.47 xtraeme
754 1.51 xtraeme /*
755 1.51 xtraeme * Called with the sysmon_envsys device mtx held through the
756 1.51 xtraeme * workqueue thread.
757 1.51 xtraeme */
758 1.47 xtraeme static bool
759 1.47 xtraeme sme_acadapter_check(void)
760 1.47 xtraeme {
761 1.38 xtraeme struct sysmon_envsys *sme;
762 1.38 xtraeme envsys_data_t *edata;
763 1.50 xtraeme bool dev = false, sensor = false;
764 1.38 xtraeme
765 1.50 xtraeme LIST_FOREACH(sme, &sysmon_envsys_list, sme_list) {
766 1.50 xtraeme if (sme->sme_class == SME_CLASS_ACADAPTER) {
767 1.50 xtraeme dev = true;
768 1.38 xtraeme break;
769 1.50 xtraeme }
770 1.50 xtraeme }
771 1.51 xtraeme
772 1.38 xtraeme /*
773 1.47 xtraeme * No AC Adapter devices were found.
774 1.38 xtraeme */
775 1.50 xtraeme if (!dev)
776 1.44 xtraeme return false;
777 1.51 xtraeme
778 1.44 xtraeme /*
779 1.47 xtraeme * Check if there's an AC adapter device connected.
780 1.44 xtraeme */
781 1.45 xtraeme TAILQ_FOREACH(edata, &sme->sme_sensors_list, sensors_head) {
782 1.38 xtraeme if (edata->units == ENVSYS_INDICATOR) {
783 1.47 xtraeme sensor = true;
784 1.50 xtraeme /* refresh current sensor */
785 1.50 xtraeme (*sme->sme_refresh)(sme, edata);
786 1.44 xtraeme if (edata->value_cur)
787 1.44 xtraeme return false;
788 1.38 xtraeme }
789 1.38 xtraeme }
790 1.51 xtraeme
791 1.47 xtraeme if (!sensor)
792 1.47 xtraeme return false;
793 1.47 xtraeme
794 1.51 xtraeme /*
795 1.51 xtraeme * AC adapter found and not connected.
796 1.51 xtraeme */
797 1.47 xtraeme return true;
798 1.47 xtraeme }
799 1.47 xtraeme
800 1.51 xtraeme /*
801 1.51 xtraeme * Called with the sysmon_envsys device mtx held through the
802 1.51 xtraeme * workqueue thread.
803 1.51 xtraeme */
804 1.47 xtraeme static bool
805 1.47 xtraeme sme_battery_check(void)
806 1.47 xtraeme {
807 1.47 xtraeme struct sysmon_envsys *sme;
808 1.47 xtraeme envsys_data_t *edata;
809 1.55 drochner int batteriesfound = 0;
810 1.55 drochner bool present, batterycap, batterycharge;
811 1.44 xtraeme
812 1.38 xtraeme /*
813 1.44 xtraeme * Check for battery devices and its state.
814 1.38 xtraeme */
815 1.44 xtraeme LIST_FOREACH(sme, &sysmon_envsys_list, sme_list) {
816 1.44 xtraeme if (sme->sme_class != SME_CLASS_BATTERY)
817 1.44 xtraeme continue;
818 1.38 xtraeme
819 1.55 drochner present = true;
820 1.55 drochner TAILQ_FOREACH(edata, &sme->sme_sensors_list, sensors_head) {
821 1.55 drochner if (edata->units == ENVSYS_INDICATOR &&
822 1.55 drochner !edata->value_cur) {
823 1.55 drochner present = false;
824 1.55 drochner break;
825 1.55 drochner }
826 1.55 drochner }
827 1.55 drochner if (!present)
828 1.55 drochner continue;
829 1.44 xtraeme /*
830 1.44 xtraeme * We've found a battery device...
831 1.44 xtraeme */
832 1.55 drochner batteriesfound++;
833 1.55 drochner batterycap = batterycharge = false;
834 1.45 xtraeme TAILQ_FOREACH(edata, &sme->sme_sensors_list, sensors_head) {
835 1.44 xtraeme if (edata->units == ENVSYS_BATTERY_CAPACITY) {
836 1.44 xtraeme batterycap = true;
837 1.44 xtraeme if (!sme_battery_critical(edata))
838 1.44 xtraeme return false;
839 1.44 xtraeme } else if (edata->units == ENVSYS_BATTERY_CHARGE) {
840 1.44 xtraeme batterycharge = true;
841 1.44 xtraeme if (edata->value_cur)
842 1.44 xtraeme return false;
843 1.38 xtraeme }
844 1.38 xtraeme }
845 1.55 drochner if (!batterycap || !batterycharge)
846 1.55 drochner return false;
847 1.38 xtraeme }
848 1.51 xtraeme
849 1.55 drochner if (!batteriesfound)
850 1.44 xtraeme return false;
851 1.38 xtraeme
852 1.38 xtraeme /*
853 1.44 xtraeme * All batteries in low/critical capacity and discharging.
854 1.38 xtraeme */
855 1.44 xtraeme return true;
856 1.44 xtraeme }
857 1.38 xtraeme
858 1.44 xtraeme static bool
859 1.44 xtraeme sme_battery_critical(envsys_data_t *edata)
860 1.44 xtraeme {
861 1.44 xtraeme if (edata->value_cur == ENVSYS_BATTERY_CAPACITY_CRITICAL ||
862 1.44 xtraeme edata->value_cur == ENVSYS_BATTERY_CAPACITY_LOW)
863 1.44 xtraeme return true;
864 1.44 xtraeme
865 1.44 xtraeme return false;
866 1.38 xtraeme }
867