4 * @remark Copyright 2002 OProfile authors
5 * @remark Read the file COPYING
7 * @author John Levon <levon@movementarian.org>
8 * @author Barry Kasindorf
10 * This is the core of the buffer management. Each
11 * CPU buffer is processed and entered into the
12 * global event buffer. Such processing is necessary
13 * in several circumstances, mentioned below.
15 * The processing does the job of converting the
16 * transitory EIP value into a persistent dentry/offset
17 * value that the profiler can record at its leisure.
19 * See fs/dcookies.c for a description of the dentry/offset
24 #include <linux/workqueue.h>
25 #include <linux/notifier.h>
26 #include <linux/dcookies.h>
27 #include <linux/profile.h>
28 #include <linux/module.h>
30 #include <linux/oprofile.h>
31 #include <linux/sched.h>
33 #include "oprofile_stats.h"
34 #include "event_buffer.h"
35 #include "cpu_buffer.h"
36 #include "buffer_sync.h"
38 static LIST_HEAD(dying_tasks);
39 static LIST_HEAD(dead_tasks);
40 static cpumask_t marked_cpus = CPU_MASK_NONE;
41 static DEFINE_SPINLOCK(task_mortuary);
42 static void process_task_mortuary(void);
44 /* Take ownership of the task struct and place it on the
45 * list for processing. Only after two full buffer syncs
46 * does the task eventually get freed, because by then
47 * we are sure we will not reference it again.
48 * Can be invoked from softirq via RCU callback due to
49 * call_rcu() of the task struct, hence the _irqsave.
52 task_free_notify(struct notifier_block *self, unsigned long val, void *data)
55 struct task_struct *task = data;
56 spin_lock_irqsave(&task_mortuary, flags);
57 list_add(&task->tasks, &dying_tasks);
58 spin_unlock_irqrestore(&task_mortuary, flags);
63 /* The task is on its way out. A sync of the buffer means we can catch
64 * any remaining samples for this task.
67 task_exit_notify(struct notifier_block *self, unsigned long val, void *data)
69 /* To avoid latency problems, we only process the current CPU,
70 * hoping that most samples for the task are on this CPU
72 sync_buffer(raw_smp_processor_id());
77 /* The task is about to try a do_munmap(). We peek at what it's going to
78 * do, and if it's an executable region, process the samples first, so
79 * we don't lose any. This does not have to be exact, it's a QoI issue
83 munmap_notify(struct notifier_block *self, unsigned long val, void *data)
85 unsigned long addr = (unsigned long)data;
86 struct mm_struct *mm = current->mm;
87 struct vm_area_struct *mpnt;
89 down_read(&mm->mmap_sem);
91 mpnt = find_vma(mm, addr);
92 if (mpnt && mpnt->vm_file && (mpnt->vm_flags & VM_EXEC)) {
93 up_read(&mm->mmap_sem);
94 /* To avoid latency problems, we only process the current CPU,
95 * hoping that most samples for the task are on this CPU
97 sync_buffer(raw_smp_processor_id());
101 up_read(&mm->mmap_sem);
106 /* We need to be told about new modules so we don't attribute to a previously
107 * loaded module, or drop the samples on the floor.
110 module_load_notify(struct notifier_block *self, unsigned long val, void *data)
112 #ifdef CONFIG_MODULES
113 if (val != MODULE_STATE_COMING)
116 /* FIXME: should we process all CPU buffers ? */
117 mutex_lock(&buffer_mutex);
118 add_event_entry(ESCAPE_CODE);
119 add_event_entry(MODULE_LOADED_CODE);
120 mutex_unlock(&buffer_mutex);
126 static struct notifier_block task_free_nb = {
127 .notifier_call = task_free_notify,
130 static struct notifier_block task_exit_nb = {
131 .notifier_call = task_exit_notify,
134 static struct notifier_block munmap_nb = {
135 .notifier_call = munmap_notify,
138 static struct notifier_block module_load_nb = {
139 .notifier_call = module_load_notify,
143 static void end_sync(void)
146 /* make sure we don't leak task structs */
147 process_task_mortuary();
148 process_task_mortuary();
158 err = task_handoff_register(&task_free_nb);
161 err = profile_event_register(PROFILE_TASK_EXIT, &task_exit_nb);
164 err = profile_event_register(PROFILE_MUNMAP, &munmap_nb);
167 err = register_module_notifier(&module_load_nb);
174 profile_event_unregister(PROFILE_MUNMAP, &munmap_nb);
176 profile_event_unregister(PROFILE_TASK_EXIT, &task_exit_nb);
178 task_handoff_unregister(&task_free_nb);
187 unregister_module_notifier(&module_load_nb);
188 profile_event_unregister(PROFILE_MUNMAP, &munmap_nb);
189 profile_event_unregister(PROFILE_TASK_EXIT, &task_exit_nb);
190 task_handoff_unregister(&task_free_nb);
195 /* Optimisation. We can manage without taking the dcookie sem
196 * because we cannot reach this code without at least one
197 * dcookie user still being registered (namely, the reader
198 * of the event buffer). */
199 static inline unsigned long fast_get_dcookie(struct path *path)
201 unsigned long cookie;
203 if (path->dentry->d_cookie)
204 return (unsigned long)path->dentry;
205 get_dcookie(path, &cookie);
210 /* Look up the dcookie for the task's first VM_EXECUTABLE mapping,
211 * which corresponds loosely to "application name". This is
212 * not strictly necessary but allows oprofile to associate
213 * shared-library samples with particular applications
215 static unsigned long get_exec_dcookie(struct mm_struct *mm)
217 unsigned long cookie = NO_COOKIE;
218 struct vm_area_struct *vma;
223 for (vma = mm->mmap; vma; vma = vma->vm_next) {
226 if (!(vma->vm_flags & VM_EXECUTABLE))
228 cookie = fast_get_dcookie(&vma->vm_file->f_path);
237 /* Convert the EIP value of a sample into a persistent dentry/offset
238 * pair that can then be added to the global event buffer. We make
239 * sure to do this lookup before a mm->mmap modification happens so
240 * we don't lose track.
243 lookup_dcookie(struct mm_struct *mm, unsigned long addr, off_t *offset)
245 unsigned long cookie = NO_COOKIE;
246 struct vm_area_struct *vma;
248 for (vma = find_vma(mm, addr); vma; vma = vma->vm_next) {
250 if (addr < vma->vm_start || addr >= vma->vm_end)
254 cookie = fast_get_dcookie(&vma->vm_file->f_path);
255 *offset = (vma->vm_pgoff << PAGE_SHIFT) + addr -
258 /* must be an anonymous map */
266 cookie = INVALID_COOKIE;
271 static unsigned long last_cookie = INVALID_COOKIE;
273 static void add_cpu_switch(int i)
275 add_event_entry(ESCAPE_CODE);
276 add_event_entry(CPU_SWITCH_CODE);
278 last_cookie = INVALID_COOKIE;
281 static void add_kernel_ctx_switch(unsigned int in_kernel)
283 add_event_entry(ESCAPE_CODE);
285 add_event_entry(KERNEL_ENTER_SWITCH_CODE);
287 add_event_entry(KERNEL_EXIT_SWITCH_CODE);
291 add_user_ctx_switch(struct task_struct const *task, unsigned long cookie)
293 add_event_entry(ESCAPE_CODE);
294 add_event_entry(CTX_SWITCH_CODE);
295 add_event_entry(task->pid);
296 add_event_entry(cookie);
297 /* Another code for daemon back-compat */
298 add_event_entry(ESCAPE_CODE);
299 add_event_entry(CTX_TGID_CODE);
300 add_event_entry(task->tgid);
304 static void add_cookie_switch(unsigned long cookie)
306 add_event_entry(ESCAPE_CODE);
307 add_event_entry(COOKIE_SWITCH_CODE);
308 add_event_entry(cookie);
312 static void add_trace_begin(void)
314 add_event_entry(ESCAPE_CODE);
315 add_event_entry(TRACE_BEGIN_CODE);
318 #ifdef CONFIG_OPROFILE_IBS
320 #define IBS_FETCH_CODE_SIZE 2
321 #define IBS_OP_CODE_SIZE 5
324 * Add IBS fetch and op entries to event buffer
326 static void add_ibs_begin(int cpu, int code, struct mm_struct *mm)
330 unsigned long ibs_cookie = 0;
332 struct op_sample *sample;
334 sample = cpu_buffer_read_entry(cpu);
340 rip += sample->event << 32;
344 ibs_cookie = lookup_dcookie(mm, rip, &offset);
346 if (ibs_cookie == NO_COOKIE)
348 if (ibs_cookie == INVALID_COOKIE) {
349 atomic_inc(&oprofile_stats.sample_lost_no_mapping);
352 if (ibs_cookie != last_cookie) {
353 add_cookie_switch(ibs_cookie);
354 last_cookie = ibs_cookie;
359 add_event_entry(ESCAPE_CODE);
360 add_event_entry(code);
361 add_event_entry(offset); /* Offset from Dcookie */
363 /* we send the Dcookie offset, but send the raw Linear Add also*/
364 add_event_entry(sample->eip);
365 add_event_entry(sample->event);
367 if (code == IBS_FETCH_CODE)
368 count = IBS_FETCH_CODE_SIZE; /*IBS FETCH is 2 int64s*/
370 count = IBS_OP_CODE_SIZE; /*IBS OP is 5 int64s*/
372 for (i = 0; i < count; i++) {
373 sample = cpu_buffer_read_entry(cpu);
376 add_event_entry(sample->eip);
377 add_event_entry(sample->event);
388 static void add_sample_entry(unsigned long offset, unsigned long event)
390 add_event_entry(offset);
391 add_event_entry(event);
395 static int add_us_sample(struct mm_struct *mm, struct op_sample *s)
397 unsigned long cookie;
400 cookie = lookup_dcookie(mm, s->eip, &offset);
402 if (cookie == INVALID_COOKIE) {
403 atomic_inc(&oprofile_stats.sample_lost_no_mapping);
407 if (cookie != last_cookie) {
408 add_cookie_switch(cookie);
409 last_cookie = cookie;
412 add_sample_entry(offset, s->event);
418 /* Add a sample to the global event buffer. If possible the
419 * sample is converted into a persistent dentry/offset pair
420 * for later lookup from userspace.
423 add_sample(struct mm_struct *mm, struct op_sample *s, int in_kernel)
426 add_sample_entry(s->eip, s->event);
429 return add_us_sample(mm, s);
431 atomic_inc(&oprofile_stats.sample_lost_no_mm);
437 static void release_mm(struct mm_struct *mm)
441 up_read(&mm->mmap_sem);
446 static struct mm_struct *take_tasks_mm(struct task_struct *task)
448 struct mm_struct *mm = get_task_mm(task);
450 down_read(&mm->mmap_sem);
455 static inline int is_code(unsigned long val)
457 return val == ESCAPE_CODE;
461 /* Move tasks along towards death. Any tasks on dead_tasks
462 * will definitely have no remaining references in any
463 * CPU buffers at this point, because we use two lists,
464 * and to have reached the list, it must have gone through
465 * one full sync already.
467 static void process_task_mortuary(void)
470 LIST_HEAD(local_dead_tasks);
471 struct task_struct *task;
472 struct task_struct *ttask;
474 spin_lock_irqsave(&task_mortuary, flags);
476 list_splice_init(&dead_tasks, &local_dead_tasks);
477 list_splice_init(&dying_tasks, &dead_tasks);
479 spin_unlock_irqrestore(&task_mortuary, flags);
481 list_for_each_entry_safe(task, ttask, &local_dead_tasks, tasks) {
482 list_del(&task->tasks);
488 static void mark_done(int cpu)
492 cpu_set(cpu, marked_cpus);
494 for_each_online_cpu(i) {
495 if (!cpu_isset(i, marked_cpus))
499 /* All CPUs have been processed at least once,
500 * we can process the mortuary once
502 process_task_mortuary();
504 cpus_clear(marked_cpus);
508 /* FIXME: this is not sufficient if we implement syscall barrier backtrace
509 * traversal, the code switch to sb_sample_start at first kernel enter/exit
510 * switch so we need a fifth state and some special handling in sync_buffer()
519 /* Sync one of the CPU's buffers into the global event buffer.
520 * Here we need to go through each batch of samples punctuated
521 * by context switch notes, taking the task's mmap_sem and doing
522 * lookup in task->mm->mmap to convert EIP into dcookie/offset
525 void sync_buffer(int cpu)
527 struct mm_struct *mm = NULL;
528 struct mm_struct *oldmm;
529 struct task_struct *new;
530 unsigned long cookie = 0;
532 sync_buffer_state state = sb_buffer_start;
534 unsigned long available;
536 mutex_lock(&buffer_mutex);
540 cpu_buffer_reset(cpu);
541 available = cpu_buffer_entries(cpu);
543 for (i = 0; i < available; ++i) {
544 struct op_sample *s = cpu_buffer_read_entry(cpu);
548 if (is_code(s->eip)) {
552 /* kernel/userspace switch */
553 in_kernel = s->event;
554 if (state == sb_buffer_start)
555 state = sb_sample_start;
556 add_kernel_ctx_switch(s->event);
558 case CPU_TRACE_BEGIN:
562 #ifdef CONFIG_OPROFILE_IBS
563 case IBS_FETCH_BEGIN:
565 add_ibs_begin(cpu, IBS_FETCH_CODE, mm);
569 add_ibs_begin(cpu, IBS_OP_CODE, mm);
573 /* userspace context switch */
575 new = (struct task_struct *)s->event;
577 mm = take_tasks_mm(new);
579 cookie = get_exec_dcookie(mm);
580 add_user_ctx_switch(new, cookie);
583 } else if (state >= sb_bt_start &&
584 !add_sample(mm, s, in_kernel)) {
585 if (state == sb_bt_start) {
586 state = sb_bt_ignore;
587 atomic_inc(&oprofile_stats.bt_lost_no_mapping);
595 mutex_unlock(&buffer_mutex);
598 /* The function can be used to add a buffer worth of data directly to
599 * the kernel buffer. The buffer is assumed to be a circular buffer.
600 * Take the entries from index start and end at index end, wrapping
603 void oprofile_put_buff(unsigned long *buf, unsigned int start,
604 unsigned int stop, unsigned int max)
610 mutex_lock(&buffer_mutex);
612 add_event_entry(buf[i++]);
618 mutex_unlock(&buffer_mutex);