proc_wakeup() - spammable and starts in the ksched
[akaros.git] / kern / src / schedule.c
1 /* Copyright (c) 2009, 2012 The Regents of the University of California
2  * Barret Rhoden <brho@cs.berkeley.edu>
3  * See LICENSE for details.
4  *
5  * Scheduling and dispatching. */
6
7 #ifdef __SHARC__
8 #pragma nosharc
9 #endif
10
11 #include <schedule.h>
12 #include <process.h>
13 #include <monitor.h>
14 #include <stdio.h>
15 #include <assert.h>
16 #include <atomic.h>
17 #include <smp.h>
18 #include <manager.h>
19 #include <alarm.h>
20 #include <sys/queue.h>
21
22 /* Process Lists.  'unrunnable' is a holding list for SCPs that are running or
23  * waiting or otherwise not considered for sched decisions. */
24 struct proc_list unrunnable_scps = TAILQ_HEAD_INITIALIZER(unrunnable_scps);
25 struct proc_list runnable_scps = TAILQ_HEAD_INITIALIZER(runnable_scps);
26 struct proc_list all_mcps = TAILQ_HEAD_INITIALIZER(all_mcps);
27 spinlock_t sched_lock = SPINLOCK_INITIALIZER;
28
29 // This could be useful for making scheduling decisions.  
30 /* Physical coremap: each index is a physical core id, with a proc ptr for
31  * whoever *should be or is* running.  Very similar to current, which is what
32  * process is *really* running there. */
33 struct proc *pcoremap[MAX_NUM_CPUS];
34
35 /* Tracks which cores are idle, similar to the vcoremap.  Each value is the
36  * physical coreid of an unallocated core. */
37 spinlock_t idle_lock = SPINLOCK_INITIALIZER;
38 uint32_t idlecoremap[MAX_NUM_CPUS];
39 uint32_t num_idlecores = 0;
40 uint32_t num_mgmtcores = 1;
41
42 /* Helper, defined below */
43 static void __core_request(struct proc *p);
44 static void __put_idle_cores(uint32_t *pc_arr, uint32_t num);
45 static void add_to_list(struct proc *p, struct proc_list *list);
46 static void remove_from_list(struct proc *p, struct proc_list *list);
47 static void switch_lists(struct proc *p, struct proc_list *old,
48                          struct proc_list *new);
49
50 /* Alarm struct, for our example 'timer tick' */
51 struct alarm_waiter ksched_waiter;
52
53 #define TIMER_TICK_USEC 10000   /* 10msec */
54
55 /* Helper: Sets up a timer tick on the calling core to go off 10 msec from now.
56  * This assumes the calling core is an LL core, etc. */
57 static void set_ksched_alarm(void)
58 {
59         set_awaiter_rel(&ksched_waiter, TIMER_TICK_USEC);
60         set_alarm(&per_cpu_info[core_id()].tchain, &ksched_waiter);
61 }
62
63 /* Kmsg, to run the scheduler tick (not in interrupt context) and reset the
64  * alarm.  Note that interrupts will be disabled, but this is not the same as
65  * interrupt context.  We're a routine kmsg, which means the core is in a
66  * quiescent state. */
67 static void __ksched_tick(struct trapframe *tf, uint32_t srcid, long a0,
68                           long a1, long a2)
69 {
70         /* TODO: imagine doing some accounting here */
71         schedule();
72         /* Set our alarm to go off, incrementing from our last tick (instead of
73          * setting it relative to now, since some time has passed since the alarm
74          * first went off.  Note, this may be now or in the past! */
75         set_awaiter_inc(&ksched_waiter, TIMER_TICK_USEC);
76         set_alarm(&per_cpu_info[core_id()].tchain, &ksched_waiter);
77 }
78
79 /* Interrupt/alarm handler: tells our core to run the scheduler (out of
80  * interrupt context). */
81 static void __kalarm(struct alarm_waiter *waiter)
82 {
83         send_kernel_message(core_id(), __ksched_tick, 0, 0, 0, KMSG_ROUTINE);
84 }
85
86 void schedule_init(void)
87 {
88         TAILQ_INIT(&runnable_scps);
89         TAILQ_INIT(&all_mcps);
90         assert(!core_id());             /* want the alarm on core0 for now */
91         init_awaiter(&ksched_waiter, __kalarm);
92         set_ksched_alarm();
93
94         /* Ghetto old idle core init */
95         /* Init idle cores. Core 0 is the management core. */
96         spin_lock(&idle_lock);
97 #ifdef __CONFIG_DISABLE_SMT__
98         /* assumes core0 is the only management core (NIC and monitor functionality
99          * are run there too.  it just adds the odd cores to the idlecoremap */
100         assert(!(num_cpus % 2));
101         // TODO: consider checking x86 for machines that actually hyperthread
102         num_idlecores = num_cpus >> 1;
103  #ifdef __CONFIG_ARSC_SERVER__
104         // Dedicate one core (core 2) to sysserver, might be able to share wit NIC
105         num_mgmtcores++;
106         assert(num_cpus >= num_mgmtcores);
107         send_kernel_message(2, (amr_t)arsc_server, 0,0,0, KMSG_ROUTINE);
108  #endif
109         for (int i = 0; i < num_idlecores; i++)
110                 idlecoremap[i] = (i * 2) + 1;
111 #else
112         // __CONFIG_DISABLE_SMT__
113         #ifdef __CONFIG_NETWORKING__
114         num_mgmtcores++; // Next core is dedicated to the NIC
115         assert(num_cpus >= num_mgmtcores);
116         #endif
117         #ifdef __CONFIG_APPSERVER__
118         #ifdef __CONFIG_DEDICATED_MONITOR__
119         num_mgmtcores++; // Next core dedicated to running the kernel monitor
120         assert(num_cpus >= num_mgmtcores);
121         // Need to subtract 1 from the num_mgmtcores # to get the cores index
122         send_kernel_message(num_mgmtcores-1, (amr_t)monitor, 0,0,0, KMSG_ROUTINE);
123         #endif
124         #endif
125  #ifdef __CONFIG_ARSC_SERVER__
126         // Dedicate one core (core 2) to sysserver, might be able to share with NIC
127         num_mgmtcores++;
128         assert(num_cpus >= num_mgmtcores);
129         send_kernel_message(num_mgmtcores-1, (amr_t)arsc_server, 0,0,0, KMSG_ROUTINE);
130  #endif
131         num_idlecores = num_cpus - num_mgmtcores;
132         for (int i = 0; i < num_idlecores; i++)
133                 idlecoremap[i] = i + num_mgmtcores;
134 #endif /* __CONFIG_DISABLE_SMT__ */
135         spin_unlock(&idle_lock);
136         return;
137 }
138
139 /* Round-robins on whatever list it's on */
140 static void add_to_list(struct proc *p, struct proc_list *new)
141 {
142         TAILQ_INSERT_TAIL(new, p, ksched_data.proc_link);
143         p->ksched_data.cur_list = new;
144 }
145
146 static void remove_from_list(struct proc *p, struct proc_list *old)
147 {
148         assert(p->ksched_data.cur_list == old);
149         TAILQ_REMOVE(old, p, ksched_data.proc_link);
150 }
151
152 static void switch_lists(struct proc *p, struct proc_list *old,
153                          struct proc_list *new)
154 {
155         remove_from_list(p, old);
156         add_to_list(p, new);
157 }
158
159 static void __remove_from_any_list(struct proc *p)
160 {
161         if (p->ksched_data.cur_list)
162                 TAILQ_REMOVE(p->ksched_data.cur_list, p, ksched_data.proc_link);
163 }
164
165 /* Removes from whatever list p is on */
166 static void remove_from_any_list(struct proc *p)
167 {
168         assert(p->ksched_data.cur_list);
169         TAILQ_REMOVE(p->ksched_data.cur_list, p, ksched_data.proc_link);
170 }
171
172 void register_proc(struct proc *p)
173 {
174         /* one ref for the proc's existence, cradle-to-grave */
175         proc_incref(p, 1);      /* need at least this OR the 'one for existing' */
176         spin_lock(&sched_lock);
177         add_to_list(p, &unrunnable_scps);
178         spin_unlock(&sched_lock);
179 }
180
181 /* TODO: the proc lock is currently held for sched and register */
182 /* sched_scp tells us to try and run the scp
183  * TODO: change this horrible name */
184 void schedule_scp(struct proc *p)
185 {
186         spin_lock(&sched_lock);
187         printd("Scheduling PID: %d\n", p->pid);
188         switch_lists(p, &unrunnable_scps, &runnable_scps);
189         spin_unlock(&sched_lock);
190 }
191
192 /* Returns 0 if it succeeded, an error code otherwise. */
193 int proc_change_to_m(struct proc *p)
194 {
195         int retval;
196         spin_lock(&sched_lock);
197         /* Should only be necessary to lock around the change_to_m call.  It's
198          * definitely necessary to hold the sched lock the whole time - need to
199          * atomically change the proc's state and have the ksched take action (and
200          * not squeeze a proc_destroy in there or something). */
201         spin_lock(&p->proc_lock);
202         retval = __proc_change_to_m(p);
203         spin_unlock(&p->proc_lock);
204         if (retval) {
205                 /* Failed for some reason. */
206                 spin_unlock(&sched_lock);
207                 return retval;
208         }
209         /* Catch user bugs */
210         if (!p->procdata->res_req[RES_CORES].amt_wanted) {
211                 printk("[kernel] process needs to specify amt_wanted\n");
212                 p->procdata->res_req[RES_CORES].amt_wanted = 1;
213         }
214         /* For now, this should only ever be called on an unrunnable.  It's
215          * probably a bug, at this stage in development, to do o/w. */
216         remove_from_list(p, &unrunnable_scps);
217         //remove_from_any_list(p);      /* ^^ instead of this */
218         add_to_list(p, &all_mcps);
219         spin_unlock(&sched_lock);
220         //poke_ksched(p, RES_CORES);
221         return retval;
222 }
223
224 /* Makes sure p is runnable.  Callers may spam this, so it needs to handle
225  * repeated calls for the same event.  Callers include event delivery, SCP
226  * yield, and new SCPs.  Most every scheduler should do something like this -
227  * grab whatever lock you have, then call the proc helper. */
228 void proc_wakeup(struct proc *p)
229 {
230         spin_lock(&sched_lock);
231         /* will trigger one of the __sched_.cp_wakeup()s */
232         __proc_wakeup(p);
233         spin_unlock(&sched_lock);
234 }
235
236 /* Destroys the given process.  This may be called from another process, a light
237  * kernel thread (no real process context), asynchronously/cross-core, or from
238  * the process on its own core.
239  *
240  * An external, edible ref is passed in.  when we return and they decref,
241  * __proc_free will be called */
242 void proc_destroy(struct proc *p)
243 {
244         uint32_t nr_cores_revoked = 0;
245         spin_lock(&sched_lock);
246         spin_lock(&p->proc_lock);
247         /* storage for pc_arr is alloced at decl, which is after grabbing the lock*/
248         uint32_t pc_arr[p->procinfo->num_vcores];
249         /* If this returns true, it means we successfully destroyed the proc */
250         if (__proc_destroy(p, pc_arr, &nr_cores_revoked)) {
251                 /* Do our cleanup.  note that proc_free won't run since we have an
252                  * external reference, passed in */
253
254                 /* Remove from whatever list we are on */
255                 remove_from_any_list(p);
256                 /* Drop the cradle-to-the-grave reference, jet-li */
257                 proc_decref(p);
258                 /* Put the cores back on the idlecore map.  For future changes, be
259                  * careful with the idle_lock.  It's safe to call this here or outside
260                  * the sched lock (for now). */
261                 if (nr_cores_revoked) 
262                         put_idle_cores(pc_arr, nr_cores_revoked);
263         }
264         spin_unlock(&p->proc_lock);
265         spin_unlock(&sched_lock);
266 }
267
268 /* mgmt/LL cores should call this to schedule the calling core and give it to an
269  * SCP.  will also prune the dead SCPs from the list.  hold the lock before
270  * calling.  returns TRUE if it scheduled a proc. */
271 static bool __schedule_scp(void)
272 {
273         struct proc *p;
274         uint32_t pcoreid = core_id();
275         struct per_cpu_info *pcpui = &per_cpu_info[pcoreid];
276         int8_t state = 0;
277         /* if there are any runnables, run them here and put any currently running
278          * SCP on the tail of the runnable queue. */
279         if ((p = TAILQ_FIRST(&runnable_scps))) {
280                 /* protect owning proc, cur_tf, etc.  note this nests with the
281                  * calls in proc_yield_s */
282                 disable_irqsave(&state);
283                 /* someone is currently running, dequeue them */
284                 if (pcpui->owning_proc) {
285                         printd("Descheduled %d in favor of %d\n", pcpui->owning_proc->pid,
286                                p->pid);
287                         __proc_yield_s(pcpui->owning_proc, pcpui->cur_tf);
288                         /* round-robin the SCPs (inserts at the end of the queue) */
289                         switch_lists(pcpui->owning_proc, &unrunnable_scps, &runnable_scps);
290                         clear_owning_proc(pcoreid);
291                         /* Note we abandon core.  It's not strictly necessary.  If
292                          * we didn't, the TLB would still be loaded with the old
293                          * one, til we proc_run_s, and the various paths in
294                          * proc_run_s would pick it up.  This way is a bit safer for
295                          * future changes, but has an extra (empty) TLB flush.  */
296                         abandon_core();
297                 } 
298                 /* Run the new proc */
299                 switch_lists(p, &runnable_scps, &unrunnable_scps);
300                 printd("PID of the SCP i'm running: %d\n", p->pid);
301                 proc_run_s(p);  /* gives it core we're running on */
302                 enable_irqsave(&state);
303                 return TRUE;
304         }
305         return FALSE;
306 }
307
308 /* Something has changed, and for whatever reason the scheduler should
309  * reevaluate things. 
310  *
311  * Don't call this from interrupt context (grabs proclocks). */
312 void schedule(void)
313 {
314         struct proc *p, *temp;
315         spin_lock(&sched_lock);
316         /* trivially try to handle the needs of all our MCPS.  smarter schedulers
317          * would do something other than FCFS */
318         TAILQ_FOREACH_SAFE(p, &all_mcps, ksched_data.proc_link, temp) {
319                 printd("Ksched has MCP %08p (%d)\n", p, p->pid);
320                 if (!num_idlecores)
321                         break;
322                 /* TODO: might use amt_wanted as a proxy.  right now, they have
323                  * amt_wanted == 1, even though they are waiting.
324                  * TODO: this is RACY too - just like with DYING. */
325                 if (p->state == PROC_WAITING)
326                         continue;
327                 __core_request(p);
328         }
329         if (management_core())
330                 __schedule_scp();
331         spin_unlock(&sched_lock);
332 }
333
334 /* A process is asking the ksched to look at its resource desires.  The
335  * scheduler is free to ignore this, for its own reasons, so long as it
336  * eventually gets around to looking at resource desires. */
337 void poke_ksched(struct proc *p, int res_type)
338 {
339         /* TODO: probably want something to trigger all res_types */
340         spin_lock(&sched_lock);
341         switch (res_type) {
342                 case RES_CORES:
343                         /* ignore core requests from non-mcps (note we have races if we ever
344                          * allow procs to switch back). */
345                         if (!__proc_is_mcp(p))
346                                 break;
347                         __core_request(p);
348                         break;
349                 default:
350                         break;
351         }
352         spin_unlock(&sched_lock);
353 }
354
355 /* ksched callbacks.  p just woke up, is unlocked, and the ksched lock is held */
356 void __sched_mcp_wakeup(struct proc *p)
357 {
358         /* the essence of poke_ksched for RES_CORES */
359         __core_request(p);
360 }
361
362 /* ksched callbacks.  p just woke up, is unlocked, and the ksched lock is held */
363 void __sched_scp_wakeup(struct proc *p)
364 {
365         /* might not be on a list if it is new.  o/w, it should be unrunnable */
366         __remove_from_any_list(p);
367         add_to_list(p, &runnable_scps);
368 }
369
370 /* The calling cpu/core has nothing to do and plans to idle/halt.  This is an
371  * opportunity to pick the nature of that halting (low power state, etc), or
372  * provide some other work (_Ss on LL cores).  Note that interrupts are
373  * disabled, and if you return, the core will cpu_halt(). */
374 void cpu_bored(void)
375 {
376         bool new_proc = FALSE;
377         if (!management_core())
378                 return;
379         spin_lock(&sched_lock);
380         new_proc = __schedule_scp();
381         spin_unlock(&sched_lock);
382         /* if we just scheduled a proc, we need to manually restart it, instead of
383          * returning.  if we return, the core will halt. */
384         if (new_proc) {
385                 proc_restartcore();
386                 assert(0);
387         }
388         /* Could drop into the monitor if there are no processes at all.  For now,
389          * the 'call of the giraffe' suffices. */
390 }
391
392 /* Helper function to return a core to the idlemap.  It causes some more lock
393  * acquisitions (like in a for loop), but it's a little easier.  Plus, one day
394  * we might be able to do this without locks (for the putting).
395  *
396  * This is a trigger, telling us we have more cores.  We could/should make a
397  * scheduling decision (or at least plan to). */
398 void put_idle_core(uint32_t coreid)
399 {
400         spin_lock(&idle_lock);
401         idlecoremap[num_idlecores++] = coreid;
402         spin_unlock(&idle_lock);
403 }
404
405 /* Helper for put_idle and core_req. */
406 static void __put_idle_cores(uint32_t *pc_arr, uint32_t num)
407 {
408         spin_lock(&idle_lock);
409         for (int i = 0; i < num; i++)
410                 idlecoremap[num_idlecores++] = pc_arr[i];
411         spin_unlock(&idle_lock);
412 }
413
414 /* Bulk interface for put_idle */
415 void put_idle_cores(uint32_t *pc_arr, uint32_t num)
416 {
417         /* could trigger a sched decision here */
418         __put_idle_cores(pc_arr, num);
419 }
420
421 /* Available resources changed (plus or minus).  Some parts of the kernel may
422  * call this if a particular resource that is 'quantity-based' changes.  Things
423  * like available RAM to processes, bandwidth, etc.  Cores would probably be
424  * inappropriate, since we need to know which specific core is now free. */
425 void avail_res_changed(int res_type, long change)
426 {
427         printk("[kernel] ksched doesn't track any resources yet!\n");
428 }
429
430 /* Normally it'll be the max number of CG cores ever */
431 uint32_t max_vcores(struct proc *p)
432 {
433 #ifdef __CONFIG_DISABLE_SMT__
434         return num_cpus >> 1;
435 #else
436         return MAX(1, num_cpus - num_mgmtcores);
437 #endif /* __CONFIG_DISABLE_SMT__ */
438 }
439
440 /* Ghetto helper, just hands out up to 'amt_new' cores (no sense of locality or
441  * anything) */
442 static uint32_t get_idle_cores(struct proc *p, uint32_t *pc_arr,
443                                uint32_t amt_new)
444 {
445         uint32_t num_granted = 0;
446         spin_lock(&idle_lock);
447         for (int i = 0; i < num_idlecores && i < amt_new; i++) {
448                 /* grab the last one on the list */
449                 pc_arr[i] = idlecoremap[num_idlecores - 1];
450                 num_idlecores--;
451                 num_granted++;
452         }
453         spin_unlock(&idle_lock);
454         return num_granted;
455 }
456
457 /* This deals with a request for more cores.  The request is already stored in
458  * the proc's amt_wanted (it is compared to amt_granted). */
459 static void __core_request(struct proc *p)
460 {
461         uint32_t num_granted, amt_wanted, amt_granted;
462         uint32_t corelist[num_cpus];
463
464         /* TODO: consider copy-in for amt_wanted too. */
465         amt_wanted = p->procdata->res_req[RES_CORES].amt_wanted;
466         amt_granted = p->procinfo->res_grant[RES_CORES];
467
468         /* Help them out - if they ask for something impossible, give them 1 so they
469          * can make some progress. (this is racy). */
470         if (amt_wanted > p->procinfo->max_vcores) {
471                 p->procdata->res_req[RES_CORES].amt_wanted = 1;
472         }
473         /* if they are satisfied, we're done.  There's a slight chance they have
474          * cores, but they aren't running (sched gave them cores while they were
475          * yielding, and now we see them on the run queue). */
476         if (amt_wanted <= amt_granted)
477                 return;
478         /* Otherwise, see what they want, and try to give out as many as possible.
479          * Current models are simple - it's just a raw number of cores, and we just
480          * give out what we can. */
481         num_granted = get_idle_cores(p, corelist, amt_wanted - amt_granted);
482         /* Now, actually give them out */
483         if (num_granted) {
484                 /* give them the cores.  this will start up the extras if RUNNING_M. */
485                 spin_lock(&p->proc_lock);
486                 /* if they fail, it is because they are WAITING or DYING.  we could give
487                  * the cores to another proc or whatever.  for the current type of
488                  * ksched, we'll just put them back on the pile and return.  Note, the
489                  * ksched could check the states after locking, but it isn't necessary:
490                  * just need to check at some point in the ksched loop. */
491                 if (__proc_give_cores(p, corelist, num_granted)) {
492                         __put_idle_cores(corelist, num_granted);
493                 } else {
494                         /* at some point after giving cores, call proc_run_m() (harmless on
495                          * RUNNING_Ms).  You can give small groups of cores, then run them
496                          * (which is more efficient than interleaving runs with the gives
497                          * for bulk preempted processes). */
498                         __proc_run_m(p);
499                 }
500                 spin_unlock(&p->proc_lock);
501         }
502 }
503
504 /************** Debugging **************/
505 void sched_diag(void)
506 {
507         struct proc *p;
508         spin_lock(&sched_lock);
509         TAILQ_FOREACH(p, &runnable_scps, ksched_data.proc_link)
510                 printk("Runnable _S PID: %d\n", p->pid);
511         TAILQ_FOREACH(p, &unrunnable_scps, ksched_data.proc_link)
512                 printk("Unrunnable _S PID: %d\n", p->pid);
513         TAILQ_FOREACH(p, &all_mcps, ksched_data.proc_link)
514                 printk("MCP PID: %d\n", p->pid);
515         spin_unlock(&sched_lock);
516         return;
517 }
518
519 void print_idlecoremap(void)
520 {
521         spin_lock(&idle_lock);
522         printk("There are %d idle cores.\n", num_idlecores);
523         for (int i = 0; i < num_idlecores; i++)
524                 printk("idlecoremap[%d] = %d\n", i, idlecoremap[i]);
525         spin_unlock(&idle_lock);
526 }
527
528 void print_resources(struct proc *p)
529 {
530         printk("--------------------\n");
531         printk("PID: %d\n", p->pid);
532         printk("--------------------\n");
533         for (int i = 0; i < MAX_NUM_RESOURCES; i++)
534                 printk("Res type: %02d, amt wanted: %08d, amt granted: %08d\n", i,
535                        p->procdata->res_req[i].amt_wanted, p->procinfo->res_grant[i]);
536 }
537
538 void print_all_resources(void)
539 {
540         /* Hash helper */
541         void __print_resources(void *item)
542         {
543                 print_resources((struct proc*)item);
544         }
545         spin_lock(&pid_hash_lock);
546         hash_for_each(pid_hash, __print_resources);
547         spin_unlock(&pid_hash_lock);
548 }