src/event.h

   1
   2 /*
   3  *
   4  * SQUID Web Proxy Cache          http://www.squid-cache.org/
   5  * ----------------------------------------------------------
   6  *
   7  *  Squid is the result of efforts by numerous individuals from
   8  *  the Internet community; see the CONTRIBUTORS file for full
   9  *  details.   Many organizations have provided support for Squid's
  10  *  development; see the SPONSORS file for full details.  Squid is
  11  *  Copyrighted (C) 2001 by the Regents of the University of
  12  *  California; see the COPYRIGHT file for full details.  Squid
  13  *  incorporates software developed and/or copyrighted by other
  14  *  sources; see the CREDITS file for full details.
  15  *
  16  *  This program is free software; you can redistribute it and/or modify
  17  *  it under the terms of the GNU General Public License as published by
  18  *  the Free Software Foundation; either version 2 of the License, or
  19  *  (at your option) any later version.
  20  *
  21  *  This program is distributed in the hope that it will be useful,
  22  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  23  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  24  *  GNU General Public License for more details.
  25  *
  26  *  You should have received a copy of the GNU General Public License
  27  *  along with this program; if not, write to the Free Software
  28  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
  29  *
  30  */
  31
  32 #ifndef SQUID_EVENT_H
  33 #define SQUID_EVENT_H
  34
  35 #include "Array.h"
  36 #include "AsyncEngine.h"
  37 #include "MemPool.h"
  38
  39 class StoreEntry;
  40
  41 /* event scheduling facilities - run a callback after a given time period. */
  42
  43 typedef void EVH(void *);
  44
  45 void eventAdd(const char *name, EVH * func, void *arg, double when, int, bool cbdata=true);
  46 void eventAddIsh(const char *name, EVH * func, void *arg, double delta_ish, int);
  47 void eventDelete(EVH * func, void *arg);
  48 void eventInit(void);
  49 void eventFreeMemory(void);
  50 int eventFind(EVH *, void *);
  51
  52 class ev_entry
  53 {
  54
  55 public:
  56     ev_entry(char const * name, EVH * func, void *arg, double when, int weight, bool cbdata=true);
  57     ~ev_entry();
  58     MEMPROXY_CLASS(ev_entry);
  59     const char *name;
  60     EVH *func;
  61     void *arg;
  62     double when;
  63
  64     int weight;
  65     bool cbdata;
  66
  67     ev_entry *next;
  68 };
  69
  70 MEMPROXY_CLASS_INLINE(ev_entry);
  71
  72 // manages time-based events
  73 class EventScheduler : public AsyncEngine
  74 {
  75
  76 public:
  77     EventScheduler();
  78     ~EventScheduler();
  79     /* cancel a scheduled but not dispatched event */
  80     void cancel(EVH * func, void * arg);
  81     /* clean up the used memory in the scheduler */
  82     void clean();
  83     /* how long until the next event ? */
  84     int checkDelay();
  85     /* cache manager output for the event queue */
  86     void dump(StoreEntry *);
  87     /* find a scheduled event */
  88     bool find(EVH * func, void * arg);
  89     /* schedule a callback function to run in when seconds */
  90     void schedule(const char *name, EVH * func, void *arg, double when, int weight, bool cbdata=true);
  91     int checkEvents(int timeout);
  92     static EventScheduler *GetInstance();
  93
  94 private:
  95     static EventScheduler _instance;
  96     ev_entry * tasks;
  97 };
  98
  99 #endif /* SQUID_EVENT_H */