summaryrefslogtreecommitdiff
path: root/sql/event_scheduler.h
blob: b4007d88976b59a5a6d71c884ef8feb2433337e3 (plain)
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
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
#ifndef _EVENT_SCHEDULER_H_
#define _EVENT_SCHEDULER_H_
/* Copyright (C) 2004-2006 MySQL AB

   This program 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 this program; if not, write to the Free Software
   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA */

class sp_name;
class Event_timed;
class Event_db_repository;

class THD;

int
events_init();

void
events_shutdown();

#include "event_queue.h"
#include "event_scheduler.h"

class Event_scheduler : public Event_queue
{
public:
  enum enum_state
  {
    UNINITIALIZED= 0,
    INITIALIZED,
    COMMENCING,
    CANTSTART,
    RUNNING,
    SUSPENDED,
    IN_SHUTDOWN
  };

  enum enum_suspend_or_resume
  {
    SUSPEND= 1,
    RESUME= 2
  };

  /* This is the current status of the life-cycle of the scheduler. */
  enum enum_state state;


  static void
  create_instance();

  /* Singleton access */
  static Event_scheduler*
  get_instance();

  bool 
  init(Event_db_repository *db_repo);

  void
  destroy();

  /* State changing methods follow */

  bool
  start();

  int
  stop();

  bool
  start_suspended();

  /*
    Need to be public because has to be called from the function 
    passed to pthread_create.
  */
  bool
  run(THD *thd);

  int
  suspend_or_resume(enum enum_suspend_or_resume action);
/*  
  static void
  init_mutexes();
  
  static void
  destroy_mutexes();
*/
  void
  report_error_during_start();

  /* Information retrieving methods follow */

  enum enum_state
  get_state();

  bool
  initialized();

  static int
  dump_internal_status(THD *thd);

  /* helper functions for working with mutexes & conditionals */
  void
  lock_data(const char *func, uint line);

  void
  unlock_data(const char *func, uint line);

  int
  cond_wait(int cond, pthread_mutex_t *mutex);

  void
  queue_changed();

protected:

  uint
  workers_count();

  /* helper functions */
  bool
  execute_top(THD *thd, Event_timed *et);

  void
  clean_memory(THD *thd);
  
  void
  stop_all_running_events(THD *thd);


  bool
  check_n_suspend_if_needed(THD *thd);

  bool
  check_n_wait_for_non_empty_queue(THD *thd);

  /* Singleton DP is used */
  Event_scheduler();
  

  pthread_mutex_t *LOCK_scheduler_data;
  

  /* Set to start the scheduler in suspended state */
  bool start_scheduler_suspended;

  /*
    Holds the thread id of the executor thread or 0 if the executor is not
    running. It is used by ::shutdown() to know which thread to kill with
    kill_one_thread(). The latter wake ups a thread if it is waiting on a
    conditional variable and sets thd->killed to non-zero.
  */
  ulong thread_id;

  enum enum_cond_vars
  {
    COND_NONE= -1,
    COND_new_work= 0,
    COND_started_or_stopped,
    COND_suspend_or_resume,
    /* Must be always last */
    COND_LAST
  };

  uint mutex_last_locked_at_line_nr;
  uint mutex_last_unlocked_at_line_nr;
  const char* mutex_last_locked_in_func_name;
  const char* mutex_last_unlocked_in_func_name;
  int cond_waiting_on;
  bool mutex_scheduler_data_locked;


  static const char * const cond_vars_names[COND_LAST];

  pthread_cond_t cond_vars[COND_LAST];

private:
  /* Prevent use of these */
  Event_scheduler(const Event_scheduler &);
  void operator=(Event_scheduler &);
};

#endif /* _EVENT_SCHEDULER_H_ */