FILE
trace_events_trigger.c
File preview with syntax highlighting.
linux-6.19.14/kernel/trace/trace_events_trigger.c
1// SPDX-License-Identifier: GPL-2.0 2/* 3 * trace_events_trigger - trace event triggers 4 * 5 * Copyright (C) 2013 Tom Zanussi <tom.zanussi@linux.intel.com> 6 */ 7 8#include <linux/security.h> 9#include <linux/kthread.h> 10#include <linux/module.h> 11#include <linux/ctype.h> 12#include <linux/mutex.h> 13#include <linux/slab.h> 14#include <linux/rculist.h> 15 16#include "trace.h" 17 18static LIST_HEAD(trigger_commands); 19static DEFINE_MUTEX(trigger_cmd_mutex); 20 21static struct task_struct *trigger_kthread; 22static struct llist_head trigger_data_free_list; 23static DEFINE_MUTEX(trigger_data_kthread_mutex); 24 25static int trigger_kthread_fn(void *ignore); 26 27static void trigger_create_kthread_locked(void) 28{ 29 lockdep_assert_held(&trigger_data_kthread_mutex); 30 31 if (!trigger_kthread) { 32 struct task_struct *kthread; 33 34 kthread = kthread_create(trigger_kthread_fn, NULL, 35 "trigger_data_free"); 36 if (!IS_ERR(kthread)) 37 WRITE_ONCE(trigger_kthread, kthread); 38 } 39} 40 41static void trigger_data_free_queued_locked(void) 42{ 43 struct event_trigger_data *data, *tmp; 44 struct llist_node *llnodes; 45 46 lockdep_assert_held(&trigger_data_kthread_mutex); 47 48 llnodes = llist_del_all(&trigger_data_free_list); 49 if (!llnodes) 50 return; 51 52 tracepoint_synchronize_unregister(); 53 54 llist_for_each_entry_safe(data, tmp, llnodes, llist) 55 kfree(data); 56} 57 58/* Bulk garbage collection of event_trigger_data elements */ 59static int trigger_kthread_fn(void *ignore) 60{ 61 struct event_trigger_data *data, *tmp; 62 struct llist_node *llnodes; 63 64 /* Once this task starts, it lives forever */ 65 for (;;) { 66 set_current_state(TASK_INTERRUPTIBLE); 67 if (llist_empty(&trigger_data_free_list)) 68 schedule(); 69 70 __set_current_state(TASK_RUNNING); 71 72 llnodes = llist_del_all(&trigger_data_free_list); 73 74 /* make sure current triggers exit before free */ 75 tracepoint_synchronize_unregister(); 76 77 llist_for_each_entry_safe(data, tmp, llnodes, llist) 78 kfree(data); 79 } 80 81 return 0; 82} 83 84void trigger_data_free(struct event_trigger_data *data) 85{ 86 if (!data) 87 return; 88 89 if (data->cmd_ops->set_filter) 90 data->cmd_ops->set_filter(NULL, data, NULL); 91 92 /* 93 * Boot-time trigger registration can fail before kthread creation 94 * works. Keep the deferred-free semantics during boot and let late 95 * init start the kthread to drain the list. 96 */ 97 if (system_state == SYSTEM_BOOTING && !trigger_kthread) { 98 llist_add(&data->llist, &trigger_data_free_list); 99 return; 100 } 101 102 if (unlikely(!trigger_kthread)) { 103 guard(mutex)(&trigger_data_kthread_mutex); 104 105 trigger_create_kthread_locked(); 106 /* Check again after taking mutex */ 107 if (!trigger_kthread) { 108 llist_add(&data->llist, &trigger_data_free_list); 109 /* Drain the queued frees synchronously if creation failed. */ 110 trigger_data_free_queued_locked(); 111 return; 112 } 113 } 114 115 llist_add(&data->llist, &trigger_data_free_list); 116 wake_up_process(trigger_kthread); 117} 118 119static int __init trigger_data_free_init(void) 120{ 121 guard(mutex)(&trigger_data_kthread_mutex); 122 123 if (llist_empty(&trigger_data_free_list)) 124 return 0; 125 126 trigger_create_kthread_locked(); 127 if (trigger_kthread) 128 wake_up_process(trigger_kthread); 129 else 130 trigger_data_free_queued_locked(); 131 132 return 0; 133} 134late_initcall(trigger_data_free_init); 135 136static inline void data_ops_trigger(struct event_trigger_data *data, 137 struct trace_buffer *buffer, void *rec, 138 struct ring_buffer_event *event) 139{ 140 const struct event_command *cmd_ops = data->cmd_ops; 141 142 if (data->flags & EVENT_TRIGGER_FL_COUNT) { 143 if (!cmd_ops->count_func(data, buffer, rec, event)) 144 return; 145 } 146 147 cmd_ops->trigger(data, buffer, rec, event); 148} 149 150/** 151 * event_triggers_call - Call triggers associated with a trace event 152 * @file: The trace_event_file associated with the event 153 * @buffer: The ring buffer that the event is being written to 154 * @rec: The trace entry for the event, NULL for unconditional invocation 155 * @event: The event meta data in the ring buffer 156 * 157 * For each trigger associated with an event, invoke the trigger 158 * function registered with the associated trigger command. If rec is 159 * non-NULL, it means that the trigger requires further processing and 160 * shouldn't be unconditionally invoked. If rec is non-NULL and the 161 * trigger has a filter associated with it, rec will checked against 162 * the filter and if the record matches the trigger will be invoked. 163 * If the trigger is a 'post_trigger', meaning it shouldn't be invoked 164 * in any case until the current event is written, the trigger 165 * function isn't invoked but the bit associated with the deferred 166 * trigger is set in the return value. 167 * 168 * Returns an enum event_trigger_type value containing a set bit for 169 * any trigger that should be deferred, ETT_NONE if nothing to defer. 170 * 171 * Called from tracepoint handlers (with rcu_read_lock_sched() held). 172 * 173 * Return: an enum event_trigger_type value containing a set bit for 174 * any trigger that should be deferred, ETT_NONE if nothing to defer. 175 */ 176enum event_trigger_type 177event_triggers_call(struct trace_event_file *file, 178 struct trace_buffer *buffer, void *rec, 179 struct ring_buffer_event *event) 180{ 181 struct event_trigger_data *data; 182 enum event_trigger_type tt = ETT_NONE; 183 struct event_filter *filter; 184 185 if (list_empty(&file->triggers)) 186 return tt; 187 188 list_for_each_entry_rcu(data, &file->triggers, list) { 189 if (data->paused) 190 continue; 191 if (!rec) { 192 data_ops_trigger(data, buffer, rec, event); 193 continue; 194 } 195 filter = rcu_dereference_sched(data->filter); 196 if (filter && !filter_match_preds(filter, rec)) 197 continue; 198 if (event_command_post_trigger(data->cmd_ops)) { 199 tt |= data->cmd_ops->trigger_type; 200 continue; 201 } 202 data_ops_trigger(data, buffer, rec, event); 203 } 204 return tt; 205} 206EXPORT_SYMBOL_GPL(event_triggers_call); 207 208bool __trace_trigger_soft_disabled(struct trace_event_file *file) 209{ 210 unsigned long eflags = file->flags; 211 212 if (eflags & EVENT_FILE_FL_TRIGGER_MODE) 213 event_triggers_call(file, NULL, NULL, NULL); 214 if (eflags & EVENT_FILE_FL_SOFT_DISABLED) 215 return true; 216 if (eflags & EVENT_FILE_FL_PID_FILTER) 217 return trace_event_ignore_this_pid(file); 218 return false; 219} 220EXPORT_SYMBOL_GPL(__trace_trigger_soft_disabled); 221 222/** 223 * event_triggers_post_call - Call 'post_triggers' for a trace event 224 * @file: The trace_event_file associated with the event 225 * @tt: enum event_trigger_type containing a set bit for each trigger to invoke 226 * 227 * For each trigger associated with an event, invoke the trigger 228 * function registered with the associated trigger command, if the 229 * corresponding bit is set in the tt enum passed into this function. 230 * See @event_triggers_call for details on how those bits are set. 231 * 232 * Called from tracepoint handlers (with rcu_read_lock_sched() held). 233 */ 234void 235event_triggers_post_call(struct trace_event_file *file, 236 enum event_trigger_type tt) 237{ 238 struct event_trigger_data *data; 239 240 list_for_each_entry_rcu(data, &file->triggers, list) { 241 if (data->paused) 242 continue; 243 if (data->cmd_ops->trigger_type & tt) 244 data_ops_trigger(data, NULL, NULL, NULL); 245 } 246} 247EXPORT_SYMBOL_GPL(event_triggers_post_call); 248 249#define SHOW_AVAILABLE_TRIGGERS (void *)(1UL) 250 251static void *trigger_next(struct seq_file *m, void *t, loff_t *pos) 252{ 253 struct trace_event_file *event_file = event_file_data(m->private); 254 255 if (t == SHOW_AVAILABLE_TRIGGERS) { 256 (*pos)++; 257 return NULL; 258 } 259 return seq_list_next(t, &event_file->triggers, pos); 260} 261 262static bool check_user_trigger(struct trace_event_file *file) 263{ 264 struct event_trigger_data *data; 265 266 list_for_each_entry_rcu(data, &file->triggers, list, 267 lockdep_is_held(&event_mutex)) { 268 if (data->flags & EVENT_TRIGGER_FL_PROBE) 269 continue; 270 return true; 271 } 272 return false; 273} 274 275static void *trigger_start(struct seq_file *m, loff_t *pos) 276{ 277 struct trace_event_file *event_file; 278 279 /* ->stop() is called even if ->start() fails */ 280 mutex_lock(&event_mutex); 281 event_file = event_file_file(m->private); 282 if (unlikely(!event_file)) 283 return ERR_PTR(-ENODEV); 284 285 if (list_empty(&event_file->triggers) || !check_user_trigger(event_file)) 286 return *pos == 0 ? SHOW_AVAILABLE_TRIGGERS : NULL; 287 288 return seq_list_start(&event_file->triggers, *pos); 289} 290 291static void trigger_stop(struct seq_file *m, void *t) 292{ 293 mutex_unlock(&event_mutex); 294} 295 296static int trigger_show(struct seq_file *m, void *v) 297{ 298 struct event_trigger_data *data; 299 struct event_command *p; 300 301 if (v == SHOW_AVAILABLE_TRIGGERS) { 302 seq_puts(m, "# Available triggers:\n"); 303 seq_putc(m, '#'); 304 mutex_lock(&trigger_cmd_mutex); 305 list_for_each_entry_reverse(p, &trigger_commands, list) 306 seq_printf(m, " %s", p->name); 307 seq_putc(m, '\n'); 308 mutex_unlock(&trigger_cmd_mutex); 309 return 0; 310 } 311 312 data = list_entry(v, struct event_trigger_data, list); 313 data->cmd_ops->print(m, data); 314 315 return 0; 316} 317 318static const struct seq_operations event_triggers_seq_ops = { 319 .start = trigger_start, 320 .next = trigger_next, 321 .stop = trigger_stop, 322 .show = trigger_show, 323}; 324 325static int event_trigger_regex_open(struct inode *inode, struct file *file) 326{ 327 int ret; 328 329 ret = security_locked_down(LOCKDOWN_TRACEFS); 330 if (ret) 331 return ret; 332 333 guard(mutex)(&event_mutex); 334 335 if (unlikely(!event_file_file(file))) 336 return -ENODEV; 337 338 if ((file->f_mode & FMODE_WRITE) && 339 (file->f_flags & O_TRUNC)) { 340 struct trace_event_file *event_file; 341 struct event_command *p; 342 343 event_file = event_file_data(file); 344 345 list_for_each_entry(p, &trigger_commands, list) { 346 if (p->unreg_all) 347 p->unreg_all(event_file); 348 } 349 } 350 351 if (file->f_mode & FMODE_READ) { 352 ret = seq_open(file, &event_triggers_seq_ops); 353 if (!ret) { 354 struct seq_file *m = file->private_data; 355 m->private = file; 356 } 357 } 358 359 return ret; 360} 361 362int trigger_process_regex(struct trace_event_file *file, char *buff) 363{ 364 char *command, *next; 365 struct event_command *p; 366 367 next = buff = strim(buff); 368 369 command = strsep(&next, ": \t"); 370 if (next) { 371 next = skip_spaces(next); 372 if (!*next) 373 next = NULL; 374 } 375 command = (command[0] != '!') ? command : command + 1; 376 377 guard(mutex)(&trigger_cmd_mutex); 378 379 list_for_each_entry(p, &trigger_commands, list) { 380 if (strcmp(p->name, command) == 0) 381 return p->parse(p, file, buff, command, next); 382 } 383 384 return -EINVAL; 385} 386 387static ssize_t event_trigger_regex_write(struct file *file, 388 const char __user *ubuf, 389 size_t cnt, loff_t *ppos) 390{ 391 struct trace_event_file *event_file; 392 ssize_t ret; 393 char *buf __free(kfree) = NULL; 394 395 if (!cnt) 396 return 0; 397 398 if (cnt >= PAGE_SIZE) 399 return -EINVAL; 400 401 buf = memdup_user_nul(ubuf, cnt); 402 if (IS_ERR(buf)) 403 return PTR_ERR(buf); 404 405 guard(mutex)(&event_mutex); 406 407 event_file = event_file_file(file); 408 if (unlikely(!event_file)) 409 return -ENODEV; 410 411 ret = trigger_process_regex(event_file, buf); 412 if (ret < 0) 413 return ret; 414 415 *ppos += cnt; 416 return cnt; 417} 418 419static int event_trigger_regex_release(struct inode *inode, struct file *file) 420{ 421 if (file->f_mode & FMODE_READ) 422 seq_release(inode, file); 423 424 return 0; 425} 426 427static ssize_t 428event_trigger_write(struct file *filp, const char __user *ubuf, 429 size_t cnt, loff_t *ppos) 430{ 431 return event_trigger_regex_write(filp, ubuf, cnt, ppos); 432} 433 434static int 435event_trigger_open(struct inode *inode, struct file *filp) 436{ 437 /* Checks for tracefs lockdown */ 438 return event_trigger_regex_open(inode, filp); 439} 440 441static int 442event_trigger_release(struct inode *inode, struct file *file) 443{ 444 return event_trigger_regex_release(inode, file); 445} 446 447const struct file_operations event_trigger_fops = { 448 .open = event_trigger_open, 449 .read = seq_read, 450 .write = event_trigger_write, 451 .llseek = tracing_lseek, 452 .release = event_trigger_release, 453}; 454 455/* 456 * Currently we only register event commands from __init, so mark this 457 * __init too. 458 */ 459__init int register_event_command(struct event_command *cmd) 460{ 461 struct event_command *p; 462 463 guard(mutex)(&trigger_cmd_mutex); 464 465 list_for_each_entry(p, &trigger_commands, list) { 466 if (strcmp(cmd->name, p->name) == 0) 467 return -EBUSY; 468 } 469 list_add(&cmd->list, &trigger_commands); 470 471 return 0; 472} 473 474/* 475 * Currently we only unregister event commands from __init, so mark 476 * this __init too. 477 */ 478__init int unregister_event_command(struct event_command *cmd) 479{ 480 struct event_command *p, *n; 481 482 guard(mutex)(&trigger_cmd_mutex); 483 484 list_for_each_entry_safe(p, n, &trigger_commands, list) { 485 if (strcmp(cmd->name, p->name) == 0) { 486 list_del_init(&p->list); 487 return 0; 488 } 489 } 490 491 return -ENODEV; 492} 493 494/** 495 * event_trigger_count - Optional count function for event triggers 496 * @data: Trigger-specific data 497 * @buffer: The ring buffer that the event is being written to 498 * @rec: The trace entry for the event, NULL for unconditional invocation 499 * @event: The event meta data in the ring buffer 500 * 501 * For triggers that can take a count parameter that doesn't do anything 502 * special, they can use this function to assign to their .count_func 503 * field. 504 * 505 * This simply does a count down of the @data->count field. 506 * 507 * If the @data->count is greater than zero, it will decrement it. 508 * 509 * Returns false if @data->count is zero, otherwise true. 510 */ 511bool event_trigger_count(struct event_trigger_data *data, 512 struct trace_buffer *buffer, void *rec, 513 struct ring_buffer_event *event) 514{ 515 if (!data->count) 516 return false; 517 518 if (data->count != -1) 519 (data->count)--; 520 521 return true; 522} 523 524/** 525 * event_trigger_print - Generic event_command @print implementation 526 * @name: The name of the event trigger 527 * @m: The seq_file being printed to 528 * @data: Trigger-specific data 529 * @filter_str: filter_str to print, if present 530 * 531 * Common implementation for event triggers to print themselves. 532 * 533 * Usually wrapped by a function that simply sets the @name of the 534 * trigger command and then invokes this. 535 * 536 * Return: 0 on success, errno otherwise 537 */ 538static int 539event_trigger_print(const char *name, struct seq_file *m, 540 void *data, char *filter_str) 541{ 542 long count = (long)data; 543 544 seq_puts(m, name); 545 546 if (count == -1) 547 seq_puts(m, ":unlimited"); 548 else 549 seq_printf(m, ":count=%ld", count); 550 551 if (filter_str) 552 seq_printf(m, " if %s\n", filter_str); 553 else 554 seq_putc(m, '\n'); 555 556 return 0; 557} 558 559/** 560 * event_trigger_init - Generic event_command @init implementation 561 * @data: Trigger-specific data 562 * 563 * Common implementation of event trigger initialization. 564 * 565 * Usually used directly as the @init method in event trigger 566 * implementations. 567 * 568 * Return: 0 on success, errno otherwise 569 */ 570int event_trigger_init(struct event_trigger_data *data) 571{ 572 data->ref++; 573 return 0; 574} 575 576/** 577 * event_trigger_free - Generic event_command @free implementation 578 * @data: Trigger-specific data 579 * 580 * Common implementation of event trigger de-initialization. 581 * 582 * Usually used directly as the @free method in event trigger 583 * implementations. 584 */ 585static void 586event_trigger_free(struct event_trigger_data *data) 587{ 588 if (WARN_ON_ONCE(data->ref <= 0)) 589 return; 590 591 data->ref--; 592 if (!data->ref) 593 trigger_data_free(data); 594} 595 596int trace_event_trigger_enable_disable(struct trace_event_file *file, 597 int trigger_enable) 598{ 599 int ret = 0; 600 601 if (trigger_enable) { 602 if (atomic_inc_return(&file->tm_ref) > 1) 603 return ret; 604 set_bit(EVENT_FILE_FL_TRIGGER_MODE_BIT, &file->flags); 605 ret = trace_event_enable_disable(file, 1, 1); 606 } else { 607 if (atomic_dec_return(&file->tm_ref) > 0) 608 return ret; 609 clear_bit(EVENT_FILE_FL_TRIGGER_MODE_BIT, &file->flags); 610 ret = trace_event_enable_disable(file, 0, 1); 611 } 612 613 return ret; 614} 615 616/** 617 * clear_event_triggers - Clear all triggers associated with a trace array 618 * @tr: The trace array to clear 619 * 620 * For each trigger, the triggering event has its tm_ref decremented 621 * via trace_event_trigger_enable_disable(), and any associated event 622 * (in the case of enable/disable_event triggers) will have its sm_ref 623 * decremented via free()->trace_event_enable_disable(). That 624 * combination effectively reverses the soft-mode/trigger state added 625 * by trigger registration. 626 * 627 * Must be called with event_mutex held. 628 */ 629void 630clear_event_triggers(struct trace_array *tr) 631{ 632 struct trace_event_file *file; 633 634 list_for_each_entry(file, &tr->events, list) { 635 struct event_trigger_data *data, *n; 636 list_for_each_entry_safe(data, n, &file->triggers, list) { 637 trace_event_trigger_enable_disable(file, 0); 638 list_del_rcu(&data->list); 639 if (data->cmd_ops->free) 640 data->cmd_ops->free(data); 641 } 642 } 643} 644 645/** 646 * update_cond_flag - Set or reset the TRIGGER_COND bit 647 * @file: The trace_event_file associated with the event 648 * 649 * If an event has triggers and any of those triggers has a filter or 650 * a post_trigger, trigger invocation needs to be deferred until after 651 * the current event has logged its data, and the event should have 652 * its TRIGGER_COND bit set, otherwise the TRIGGER_COND bit should be 653 * cleared. 654 */ 655void update_cond_flag(struct trace_event_file *file) 656{ 657 struct event_trigger_data *data; 658 bool set_cond = false; 659 660 lockdep_assert_held(&event_mutex); 661 662 list_for_each_entry(data, &file->triggers, list) { 663 if (data->filter || event_command_post_trigger(data->cmd_ops) || 664 event_command_needs_rec(data->cmd_ops)) { 665 set_cond = true; 666 break; 667 } 668 } 669 670 if (set_cond) 671 set_bit(EVENT_FILE_FL_TRIGGER_COND_BIT, &file->flags); 672 else 673 clear_bit(EVENT_FILE_FL_TRIGGER_COND_BIT, &file->flags); 674} 675 676/** 677 * register_trigger - Generic event_command @reg implementation 678 * @glob: The raw string used to register the trigger 679 * @data: Trigger-specific data to associate with the trigger 680 * @file: The trace_event_file associated with the event 681 * 682 * Common implementation for event trigger registration. 683 * 684 * Usually used directly as the @reg method in event command 685 * implementations. 686 * 687 * Return: 0 on success, errno otherwise 688 */ 689static int register_trigger(char *glob, 690 struct event_trigger_data *data, 691 struct trace_event_file *file) 692{ 693 struct event_trigger_data *test; 694 int ret = 0; 695 696 lockdep_assert_held(&event_mutex); 697 698 list_for_each_entry(test, &file->triggers, list) { 699 if (test->cmd_ops->trigger_type == data->cmd_ops->trigger_type) 700 return -EEXIST; 701 } 702 703 if (data->cmd_ops->init) { 704 ret = data->cmd_ops->init(data); 705 if (ret < 0) 706 return ret; 707 } 708 709 list_add_rcu(&data->list, &file->triggers); 710 711 update_cond_flag(file); 712 ret = trace_event_trigger_enable_disable(file, 1); 713 if (ret < 0) { 714 list_del_rcu(&data->list); 715 update_cond_flag(file); 716 } 717 return ret; 718} 719 720/* 721 * True if the trigger was found and unregistered, else false. 722 */ 723static bool try_unregister_trigger(char *glob, 724 struct event_trigger_data *test, 725 struct trace_event_file *file) 726{ 727 struct event_trigger_data *data = NULL, *iter; 728 729 lockdep_assert_held(&event_mutex); 730 731 list_for_each_entry(iter, &file->triggers, list) { 732 if (iter->cmd_ops->trigger_type == test->cmd_ops->trigger_type) { 733 data = iter; 734 list_del_rcu(&data->list); 735 trace_event_trigger_enable_disable(file, 0); 736 update_cond_flag(file); 737 break; 738 } 739 } 740 741 if (data) { 742 if (data->cmd_ops->free) 743 data->cmd_ops->free(data); 744 745 return true; 746 } 747 748 return false; 749} 750 751/** 752 * unregister_trigger - Generic event_command @unreg implementation 753 * @glob: The raw string used to register the trigger 754 * @test: Trigger-specific data used to find the trigger to remove 755 * @file: The trace_event_file associated with the event 756 * 757 * Common implementation for event trigger unregistration. 758 * 759 * Usually used directly as the @unreg method in event command 760 * implementations. 761 */ 762static void unregister_trigger(char *glob, 763 struct event_trigger_data *test, 764 struct trace_event_file *file) 765{ 766 try_unregister_trigger(glob, test, file); 767} 768 769/* 770 * Event trigger parsing helper functions. 771 * 772 * These functions help make it easier to write an event trigger 773 * parsing function i.e. the struct event_command.parse() callback 774 * function responsible for parsing and registering a trigger command 775 * written to the 'trigger' file. 776 * 777 * A trigger command (or just 'trigger' for short) takes the form: 778 * [trigger] [if filter] 779 * 780 * The struct event_command.parse() callback (and other struct 781 * event_command functions) refer to several components of a trigger 782 * command. Those same components are referenced by the event trigger 783 * parsing helper functions defined below. These components are: 784 * 785 * cmd - the trigger command name 786 * glob - the trigger command name optionally prefaced with '!' 787 * param_and_filter - text following cmd and ':' 788 * param - text following cmd and ':' and stripped of filter 789 * filter - the optional filter text following (and including) 'if' 790 * 791 * To illustrate the use of these components, here are some concrete 792 * examples. For the following triggers: 793 * 794 * echo 'traceon:5 if pid == 0' > trigger 795 * - 'traceon' is both cmd and glob 796 * - '5 if pid == 0' is the param_and_filter 797 * - '5' is the param 798 * - 'if pid == 0' is the filter 799 * 800 * echo 'enable_event:sys:event:n' > trigger 801 * - 'enable_event' is both cmd and glob 802 * - 'sys:event:n' is the param_and_filter 803 * - 'sys:event:n' is the param 804 * - there is no filter 805 * 806 * echo 'hist:keys=pid if prio > 50' > trigger 807 * - 'hist' is both cmd and glob 808 * - 'keys=pid if prio > 50' is the param_and_filter 809 * - 'keys=pid' is the param 810 * - 'if prio > 50' is the filter 811 * 812 * echo '!enable_event:sys:event:n' > trigger 813 * - 'enable_event' the cmd 814 * - '!enable_event' is the glob 815 * - 'sys:event:n' is the param_and_filter 816 * - 'sys:event:n' is the param 817 * - there is no filter 818 * 819 * echo 'traceoff' > trigger 820 * - 'traceoff' is both cmd and glob 821 * - there is no param_and_filter 822 * - there is no param 823 * - there is no filter 824 * 825 * There are a few different categories of event trigger covered by 826 * these helpers: 827 * 828 * - triggers that don't require a parameter e.g. traceon 829 * - triggers that do require a parameter e.g. enable_event and hist 830 * - triggers that though they may not require a param may support an 831 * optional 'n' param (n = number of times the trigger should fire) 832 * e.g.: traceon:5 or enable_event:sys:event:n 833 * - triggers that do not support an 'n' param e.g. hist 834 * 835 * These functions can be used or ignored as necessary - it all 836 * depends on the complexity of the trigger, and the granularity of 837 * the functions supported reflects the fact that some implementations 838 * may need to customize certain aspects of their implementations and 839 * won't need certain functions. For instance, the hist trigger 840 * implementation doesn't use event_trigger_separate_filter() because 841 * it has special requirements for handling the filter. 842 */ 843 844/** 845 * event_trigger_check_remove - check whether an event trigger specifies remove 846 * @glob: The trigger command string, with optional remove(!) operator 847 * 848 * The event trigger callback implementations pass in 'glob' as a 849 * parameter. This is the command name either with or without a 850 * remove(!) operator. This function simply parses the glob and 851 * determines whether the command corresponds to a trigger removal or 852 * a trigger addition. 853 * 854 * Return: true if this is a remove command, false otherwise 855 */ 856bool event_trigger_check_remove(const char *glob) 857{ 858 return (glob && glob[0] == '!') ? true : false; 859} 860 861/** 862 * event_trigger_empty_param - check whether the param is empty 863 * @param: The trigger param string 864 * 865 * The event trigger callback implementations pass in 'param' as a 866 * parameter. This corresponds to the string following the command 867 * name minus the command name. This function can be called by a 868 * callback implementation for any command that requires a param; a 869 * callback that doesn't require a param can ignore it. 870 * 871 * Return: true if this is an empty param, false otherwise 872 */ 873bool event_trigger_empty_param(const char *param) 874{ 875 return !param; 876} 877 878/** 879 * event_trigger_separate_filter - separate an event trigger from a filter 880 * @param_and_filter: String containing trigger and possibly filter 881 * @param: outparam, will be filled with a pointer to the trigger 882 * @filter: outparam, will be filled with a pointer to the filter 883 * @param_required: Specifies whether or not the param string is required 884 * 885 * Given a param string of the form '[trigger] [if filter]', this 886 * function separates the filter from the trigger and returns the 887 * trigger in @param and the filter in @filter. Either the @param 888 * or the @filter may be set to NULL by this function - if not set to 889 * NULL, they will contain strings corresponding to the trigger and 890 * filter. 891 * 892 * There are two cases that need to be handled with respect to the 893 * passed-in param: either the param is required, or it is not 894 * required. If @param_required is set, and there's no param, it will 895 * return -EINVAL. If @param_required is not set and there's a param 896 * that starts with a number, that corresponds to the case of a 897 * trigger with :n (n = number of times the trigger should fire) and 898 * the parsing continues normally; otherwise the function just returns 899 * and assumes param just contains a filter and there's nothing else 900 * to do. 901 * 902 * Return: 0 on success, errno otherwise 903 */ 904int event_trigger_separate_filter(char *param_and_filter, char **param, 905 char **filter, bool param_required) 906{ 907 int ret = 0; 908 909 *param = *filter = NULL; 910 911 if (!param_and_filter) { 912 if (param_required) 913 ret = -EINVAL; 914 return ret; 915 } 916 917 /* 918 * Here we check for an optional param. The only legal 919 * optional param is :n, and if that's the case, continue 920 * below. Otherwise we assume what's left is a filter and 921 * return it as the filter string for the caller to deal with. 922 */ 923 if (!param_required && param_and_filter && !isdigit(param_and_filter[0])) { 924 *filter = param_and_filter; 925 return ret; 926 } 927 928 /* 929 * Separate the param from the filter (param [if filter]). 930 * Here we have either an optional :n param or a required 931 * param and an optional filter. 932 */ 933 *param = strsep(¶m_and_filter, " \t"); 934 935 /* 936 * Here we have a filter, though it may be empty. 937 */ 938 if (param_and_filter) { 939 *filter = skip_spaces(param_and_filter); 940 if (!**filter) 941 *filter = NULL; 942 } 943 return ret; 944} 945 946/** 947 * trigger_data_alloc - allocate and init event_trigger_data for a trigger 948 * @cmd_ops: The event_command operations for the trigger 949 * @cmd: The cmd string 950 * @param: The param string 951 * @private_data: User data to associate with the event trigger 952 * 953 * Allocate an event_trigger_data instance and initialize it. The 954 * @cmd_ops defines how the trigger will operate. If @param is set, 955 * and @cmd_ops->trigger_ops->count_func is non NULL, then the 956 * data->count is set to @param and before the trigger is executed, the 957 * @cmd_ops->trigger_ops->count_func() is called. If that function returns 958 * false, the @cmd_ops->trigger_ops->trigger() function will not be called. 959 * @private_data can also be passed in and associated with the 960 * event_trigger_data. 961 * 962 * Use trigger_data_free() to free an event_trigger_data object. 963 * 964 * Return: The trigger_data object success, NULL otherwise 965 */ 966struct event_trigger_data *trigger_data_alloc(struct event_command *cmd_ops, 967 char *cmd, 968 char *param, 969 void *private_data) 970{ 971 struct event_trigger_data *trigger_data; 972 973 trigger_data = kzalloc(sizeof(*trigger_data), GFP_KERNEL); 974 if (!trigger_data) 975 return NULL; 976 977 trigger_data->count = -1; 978 trigger_data->cmd_ops = cmd_ops; 979 trigger_data->private_data = private_data; 980 if (param && cmd_ops->count_func) 981 trigger_data->flags |= EVENT_TRIGGER_FL_COUNT; 982 983 INIT_LIST_HEAD(&trigger_data->list); 984 INIT_LIST_HEAD(&trigger_data->named_list); 985 RCU_INIT_POINTER(trigger_data->filter, NULL); 986 987 return trigger_data; 988} 989 990/** 991 * event_trigger_parse_num - parse and return the number param for a trigger 992 * @param: The param string 993 * @trigger_data: The trigger_data for the trigger 994 * 995 * Parse the :n (n = number of times the trigger should fire) param 996 * and set the count variable in the trigger_data to the parsed count. 997 * 998 * Return: 0 on success, errno otherwise 999 */ 1000int event_trigger_parse_num(char *param, 1001 struct event_trigger_data *trigger_data) 1002{ 1003 char *number; 1004 int ret = 0; 1005 1006 if (param) { 1007 number = strsep(¶m, ":"); 1008 1009 if (!strlen(number)) 1010 return -EINVAL; 1011 1012 /* 1013 * We use the callback data field (which is a pointer) 1014 * as our counter. 1015 */ 1016 ret = kstrtoul(number, 0, &trigger_data->count); 1017 } 1018 1019 return ret; 1020} 1021 1022/** 1023 * event_trigger_set_filter - set an event trigger's filter 1024 * @cmd_ops: The event_command operations for the trigger 1025 * @file: The event file for the trigger's event 1026 * @param: The string containing the filter 1027 * @trigger_data: The trigger_data for the trigger 1028 * 1029 * Set the filter for the trigger. If the filter is NULL, just return 1030 * without error. 1031 * 1032 * Return: 0 on success, errno otherwise 1033 */ 1034int event_trigger_set_filter(struct event_command *cmd_ops, 1035 struct trace_event_file *file, 1036 char *param, 1037 struct event_trigger_data *trigger_data) 1038{ 1039 if (param && cmd_ops->set_filter) 1040 return cmd_ops->set_filter(param, trigger_data, file); 1041 1042 return 0; 1043} 1044 1045/** 1046 * event_trigger_reset_filter - reset an event trigger's filter 1047 * @cmd_ops: The event_command operations for the trigger 1048 * @trigger_data: The trigger_data for the trigger 1049 * 1050 * Reset the filter for the trigger to no filter. 1051 */ 1052void event_trigger_reset_filter(struct event_command *cmd_ops, 1053 struct event_trigger_data *trigger_data) 1054{ 1055 if (cmd_ops->set_filter) 1056 cmd_ops->set_filter(NULL, trigger_data, NULL); 1057} 1058 1059/** 1060 * event_trigger_register - register an event trigger 1061 * @cmd_ops: The event_command operations for the trigger 1062 * @file: The event file for the trigger's event 1063 * @glob: The trigger command string, with optional remove(!) operator 1064 * @trigger_data: The trigger_data for the trigger 1065 * 1066 * Register an event trigger. The @cmd_ops are used to call the 1067 * cmd_ops->reg() function which actually does the registration. 1068 * 1069 * Return: 0 on success, errno otherwise 1070 */ 1071int event_trigger_register(struct event_command *cmd_ops, 1072 struct trace_event_file *file, 1073 char *glob, 1074 struct event_trigger_data *trigger_data) 1075{ 1076 return cmd_ops->reg(glob, trigger_data, file); 1077} 1078 1079/** 1080 * event_trigger_unregister - unregister an event trigger 1081 * @cmd_ops: The event_command operations for the trigger 1082 * @file: The event file for the trigger's event 1083 * @glob: The trigger command string, with optional remove(!) operator 1084 * @trigger_data: The trigger_data for the trigger 1085 * 1086 * Unregister an event trigger. The @cmd_ops are used to call the 1087 * cmd_ops->unreg() function which actually does the unregistration. 1088 */ 1089void event_trigger_unregister(struct event_command *cmd_ops, 1090 struct trace_event_file *file, 1091 char *glob, 1092 struct event_trigger_data *trigger_data) 1093{ 1094 cmd_ops->unreg(glob, trigger_data, file); 1095} 1096 1097/* 1098 * End event trigger parsing helper functions. 1099 */ 1100 1101/** 1102 * event_trigger_parse - Generic event_command @parse implementation 1103 * @cmd_ops: The command ops, used for trigger registration 1104 * @file: The trace_event_file associated with the event 1105 * @glob: The raw string used to register the trigger 1106 * @cmd: The cmd portion of the string used to register the trigger 1107 * @param_and_filter: The param and filter portion of the string used to register the trigger 1108 * 1109 * Common implementation for event command parsing and trigger 1110 * instantiation. 1111 * 1112 * Usually used directly as the @parse method in event command 1113 * implementations. 1114 * 1115 * Return: 0 on success, errno otherwise 1116 */ 1117static int 1118event_trigger_parse(struct event_command *cmd_ops, 1119 struct trace_event_file *file, 1120 char *glob, char *cmd, char *param_and_filter) 1121{ 1122 struct event_trigger_data *trigger_data; 1123 char *param, *filter; 1124 bool remove; 1125 int ret; 1126 1127 remove = event_trigger_check_remove(glob); 1128 1129 ret = event_trigger_separate_filter(param_and_filter, ¶m, &filter, false); 1130 if (ret) 1131 return ret; 1132 1133 ret = -ENOMEM; 1134 trigger_data = trigger_data_alloc(cmd_ops, cmd, param, file); 1135 if (!trigger_data) 1136 return ret; 1137 1138 if (remove) { 1139 event_trigger_unregister(cmd_ops, file, glob+1, trigger_data); 1140 trigger_data_free(trigger_data); 1141 return 0; 1142 } 1143 1144 ret = event_trigger_parse_num(param, trigger_data); 1145 if (ret) 1146 goto out_free; 1147 1148 ret = event_trigger_set_filter(cmd_ops, file, filter, trigger_data); 1149 if (ret < 0) 1150 goto out_free; 1151 1152 /* Up the trigger_data count to make sure reg doesn't free it on failure */ 1153 event_trigger_init(trigger_data); 1154 1155 ret = event_trigger_register(cmd_ops, file, glob, trigger_data); 1156 if (ret) 1157 goto out_free; 1158 1159 /* Down the counter of trigger_data or free it if not used anymore */ 1160 event_trigger_free(trigger_data); 1161 return ret; 1162 1163 out_free: 1164 event_trigger_reset_filter(cmd_ops, trigger_data); 1165 trigger_data_free(trigger_data); 1166 return ret; 1167} 1168 1169/** 1170 * set_trigger_filter - Generic event_command @set_filter implementation 1171 * @filter_str: The filter string for the trigger, NULL to remove filter 1172 * @trigger_data: Trigger-specific data 1173 * @file: The trace_event_file associated with the event 1174 * 1175 * Common implementation for event command filter parsing and filter 1176 * instantiation. 1177 * 1178 * Usually used directly as the @set_filter method in event command 1179 * implementations. 1180 * 1181 * Also used to remove a filter (if filter_str = NULL). 1182 * 1183 * Return: 0 on success, errno otherwise 1184 */ 1185int set_trigger_filter(char *filter_str, 1186 struct event_trigger_data *trigger_data, 1187 struct trace_event_file *file) 1188{ 1189 struct event_trigger_data *data = trigger_data; 1190 struct event_filter *filter = NULL, *tmp; 1191 int ret = -EINVAL; 1192 char *s; 1193 1194 if (!filter_str) /* clear the current filter */ 1195 goto assign; 1196 1197 s = strsep(&filter_str, " \t"); 1198 1199 if (!strlen(s) || strcmp(s, "if") != 0) 1200 return ret; 1201 1202 if (!filter_str) 1203 return ret; 1204 1205 /* The filter is for the 'trigger' event, not the triggered event */ 1206 ret = create_event_filter(file->tr, file->event_call, 1207 filter_str, true, &filter); 1208 1209 /* Only enabled set_str for error handling */ 1210 if (filter) { 1211 kfree(filter->filter_string); 1212 filter->filter_string = NULL; 1213 } 1214 1215 /* 1216 * If create_event_filter() fails, filter still needs to be freed. 1217 * Which the calling code will do with data->filter. 1218 */ 1219 assign: 1220 tmp = rcu_access_pointer(data->filter); 1221 1222 rcu_assign_pointer(data->filter, filter); 1223 1224 if (tmp) { 1225 /* 1226 * Make sure the call is done with the filter. 1227 * It is possible that a filter could fail at boot up, 1228 * and then this path will be called. Avoid the synchronization 1229 * in that case. 1230 */ 1231 if (system_state != SYSTEM_BOOTING) 1232 tracepoint_synchronize_unregister(); 1233 free_event_filter(tmp); 1234 } 1235 1236 kfree(data->filter_str); 1237 data->filter_str = NULL; 1238 1239 if (filter_str) { 1240 data->filter_str = kstrdup(filter_str, GFP_KERNEL); 1241 if (!data->filter_str) { 1242 free_event_filter(rcu_access_pointer(data->filter)); 1243 data->filter = NULL; 1244 ret = -ENOMEM; 1245 } 1246 } 1247 return ret; 1248} 1249 1250static LIST_HEAD(named_triggers); 1251 1252/** 1253 * find_named_trigger - Find the common named trigger associated with @name 1254 * @name: The name of the set of named triggers to find the common data for 1255 * 1256 * Named triggers are sets of triggers that share a common set of 1257 * trigger data. The first named trigger registered with a given name 1258 * owns the common trigger data that the others subsequently 1259 * registered with the same name will reference. This function 1260 * returns the common trigger data associated with that first 1261 * registered instance. 1262 * 1263 * Return: the common trigger data for the given named trigger on 1264 * success, NULL otherwise. 1265 */ 1266struct event_trigger_data *find_named_trigger(const char *name) 1267{ 1268 struct event_trigger_data *data; 1269 1270 if (!name) 1271 return NULL; 1272 1273 list_for_each_entry(data, &named_triggers, named_list) { 1274 if (data->named_data) 1275 continue; 1276 if (strcmp(data->name, name) == 0) 1277 return data; 1278 } 1279 1280 return NULL; 1281} 1282 1283/** 1284 * is_named_trigger - determine if a given trigger is a named trigger 1285 * @test: The trigger data to test 1286 * 1287 * Return: true if 'test' is a named trigger, false otherwise. 1288 */ 1289bool is_named_trigger(struct event_trigger_data *test) 1290{ 1291 struct event_trigger_data *data; 1292 1293 list_for_each_entry(data, &named_triggers, named_list) { 1294 if (test == data) 1295 return true; 1296 } 1297 1298 return false; 1299} 1300 1301/** 1302 * save_named_trigger - save the trigger in the named trigger list 1303 * @name: The name of the named trigger set 1304 * @data: The trigger data to save 1305 * 1306 * Return: 0 if successful, negative error otherwise. 1307 */ 1308int save_named_trigger(const char *name, struct event_trigger_data *data) 1309{ 1310 data->name = kstrdup(name, GFP_KERNEL); 1311 if (!data->name) 1312 return -ENOMEM; 1313 1314 list_add(&data->named_list, &named_triggers); 1315 1316 return 0; 1317} 1318 1319/** 1320 * del_named_trigger - delete a trigger from the named trigger list 1321 * @data: The trigger data to delete 1322 */ 1323void del_named_trigger(struct event_trigger_data *data) 1324{ 1325 kfree(data->name); 1326 data->name = NULL; 1327 1328 list_del(&data->named_list); 1329} 1330 1331static void __pause_named_trigger(struct event_trigger_data *data, bool pause) 1332{ 1333 struct event_trigger_data *test; 1334 1335 list_for_each_entry(test, &named_triggers, named_list) { 1336 if (strcmp(test->name, data->name) == 0) { 1337 if (pause) { 1338 test->paused_tmp = test->paused; 1339 test->paused = true; 1340 } else { 1341 test->paused = test->paused_tmp; 1342 } 1343 } 1344 } 1345} 1346 1347/** 1348 * pause_named_trigger - Pause all named triggers with the same name 1349 * @data: The trigger data of a named trigger to pause 1350 * 1351 * Pauses a named trigger along with all other triggers having the 1352 * same name. Because named triggers share a common set of data, 1353 * pausing only one is meaningless, so pausing one named trigger needs 1354 * to pause all triggers with the same name. 1355 */ 1356void pause_named_trigger(struct event_trigger_data *data) 1357{ 1358 __pause_named_trigger(data, true); 1359} 1360 1361/** 1362 * unpause_named_trigger - Un-pause all named triggers with the same name 1363 * @data: The trigger data of a named trigger to unpause 1364 * 1365 * Un-pauses a named trigger along with all other triggers having the 1366 * same name. Because named triggers share a common set of data, 1367 * unpausing only one is meaningless, so unpausing one named trigger 1368 * needs to unpause all triggers with the same name. 1369 */ 1370void unpause_named_trigger(struct event_trigger_data *data) 1371{ 1372 __pause_named_trigger(data, false); 1373} 1374 1375/** 1376 * set_named_trigger_data - Associate common named trigger data 1377 * @data: The trigger data to associate 1378 * @named_data: The common named trigger to be associated 1379 * 1380 * Named triggers are sets of triggers that share a common set of 1381 * trigger data. The first named trigger registered with a given name 1382 * owns the common trigger data that the others subsequently 1383 * registered with the same name will reference. This function 1384 * associates the common trigger data from the first trigger with the 1385 * given trigger. 1386 */ 1387void set_named_trigger_data(struct event_trigger_data *data, 1388 struct event_trigger_data *named_data) 1389{ 1390 data->named_data = named_data; 1391} 1392 1393struct event_trigger_data * 1394get_named_trigger_data(struct event_trigger_data *data) 1395{ 1396 return data->named_data; 1397} 1398 1399static void 1400traceon_trigger(struct event_trigger_data *data, 1401 struct trace_buffer *buffer, void *rec, 1402 struct ring_buffer_event *event) 1403{ 1404 struct trace_event_file *file = data->private_data; 1405 1406 if (file) { 1407 if (tracer_tracing_is_on(file->tr)) 1408 return; 1409 1410 tracer_tracing_on(file->tr); 1411 return; 1412 } 1413 1414 if (tracing_is_on()) 1415 return; 1416 1417 tracing_on(); 1418} 1419 1420static bool 1421traceon_count_func(struct event_trigger_data *data, 1422 struct trace_buffer *buffer, void *rec, 1423 struct ring_buffer_event *event) 1424{ 1425 struct trace_event_file *file = data->private_data; 1426 1427 if (file) { 1428 if (tracer_tracing_is_on(file->tr)) 1429 return false; 1430 } else { 1431 if (tracing_is_on()) 1432 return false; 1433 } 1434 1435 if (!data->count) 1436 return false; 1437 1438 if (data->count != -1) 1439 (data->count)--; 1440 1441 return true; 1442} 1443 1444static void 1445traceoff_trigger(struct event_trigger_data *data, 1446 struct trace_buffer *buffer, void *rec, 1447 struct ring_buffer_event *event) 1448{ 1449 struct trace_event_file *file = data->private_data; 1450 1451 if (file) { 1452 if (!tracer_tracing_is_on(file->tr)) 1453 return; 1454 1455 tracer_tracing_off(file->tr); 1456 return; 1457 } 1458 1459 if (!tracing_is_on()) 1460 return; 1461 1462 tracing_off(); 1463} 1464 1465static bool 1466traceoff_count_func(struct event_trigger_data *data, 1467 struct trace_buffer *buffer, void *rec, 1468 struct ring_buffer_event *event) 1469{ 1470 struct trace_event_file *file = data->private_data; 1471 1472 if (file) { 1473 if (!tracer_tracing_is_on(file->tr)) 1474 return false; 1475 } else { 1476 if (!tracing_is_on()) 1477 return false; 1478 } 1479 1480 if (!data->count) 1481 return false; 1482 1483 if (data->count != -1) 1484 (data->count)--; 1485 1486 return true; 1487} 1488 1489static int 1490traceon_trigger_print(struct seq_file *m, struct event_trigger_data *data) 1491{ 1492 return event_trigger_print("traceon", m, (void *)data->count, 1493 data->filter_str); 1494} 1495 1496static int 1497traceoff_trigger_print(struct seq_file *m, struct event_trigger_data *data) 1498{ 1499 return event_trigger_print("traceoff", m, (void *)data->count, 1500 data->filter_str); 1501} 1502 1503static struct event_command trigger_traceon_cmd = { 1504 .name = "traceon", 1505 .trigger_type = ETT_TRACE_ONOFF, 1506 .parse = event_trigger_parse, 1507 .reg = register_trigger, 1508 .unreg = unregister_trigger, 1509 .set_filter = set_trigger_filter, 1510 .trigger = traceon_trigger, 1511 .count_func = traceon_count_func, 1512 .print = traceon_trigger_print, 1513 .init = event_trigger_init, 1514 .free = event_trigger_free, 1515}; 1516 1517static struct event_command trigger_traceoff_cmd = { 1518 .name = "traceoff", 1519 .trigger_type = ETT_TRACE_ONOFF, 1520 .flags = EVENT_CMD_FL_POST_TRIGGER, 1521 .parse = event_trigger_parse, 1522 .reg = register_trigger, 1523 .unreg = unregister_trigger, 1524 .set_filter = set_trigger_filter, 1525 .trigger = traceoff_trigger, 1526 .count_func = traceoff_count_func, 1527 .print = traceoff_trigger_print, 1528 .init = event_trigger_init, 1529 .free = event_trigger_free, 1530}; 1531 1532#ifdef CONFIG_TRACER_SNAPSHOT 1533static void 1534snapshot_trigger(struct event_trigger_data *data, 1535 struct trace_buffer *buffer, void *rec, 1536 struct ring_buffer_event *event) 1537{ 1538 struct trace_event_file *file = data->private_data; 1539 1540 if (file) 1541 tracing_snapshot_instance(file->tr); 1542 else 1543 tracing_snapshot(); 1544} 1545 1546static int 1547register_snapshot_trigger(char *glob, 1548 struct event_trigger_data *data, 1549 struct trace_event_file *file) 1550{ 1551 int ret = tracing_arm_snapshot(file->tr); 1552 1553 if (ret < 0) 1554 return ret; 1555 1556 ret = register_trigger(glob, data, file); 1557 if (ret < 0) 1558 tracing_disarm_snapshot(file->tr); 1559 return ret; 1560} 1561 1562static void unregister_snapshot_trigger(char *glob, 1563 struct event_trigger_data *data, 1564 struct trace_event_file *file) 1565{ 1566 if (try_unregister_trigger(glob, data, file)) 1567 tracing_disarm_snapshot(file->tr); 1568} 1569 1570static int 1571snapshot_trigger_print(struct seq_file *m, struct event_trigger_data *data) 1572{ 1573 return event_trigger_print("snapshot", m, (void *)data->count, 1574 data->filter_str); 1575} 1576 1577static struct event_command trigger_snapshot_cmd = { 1578 .name = "snapshot", 1579 .trigger_type = ETT_SNAPSHOT, 1580 .parse = event_trigger_parse, 1581 .reg = register_snapshot_trigger, 1582 .unreg = unregister_snapshot_trigger, 1583 .set_filter = set_trigger_filter, 1584 .trigger = snapshot_trigger, 1585 .count_func = event_trigger_count, 1586 .print = snapshot_trigger_print, 1587 .init = event_trigger_init, 1588 .free = event_trigger_free, 1589}; 1590 1591static __init int register_trigger_snapshot_cmd(void) 1592{ 1593 int ret; 1594 1595 ret = register_event_command(&trigger_snapshot_cmd); 1596 WARN_ON(ret < 0); 1597 1598 return ret; 1599} 1600#else 1601static __init int register_trigger_snapshot_cmd(void) { return 0; } 1602#endif /* CONFIG_TRACER_SNAPSHOT */ 1603 1604#ifdef CONFIG_STACKTRACE 1605#ifdef CONFIG_UNWINDER_ORC 1606/* Skip 2: 1607 * event_triggers_post_call() 1608 * trace_event_raw_event_xxx() 1609 */ 1610# define STACK_SKIP 2 1611#else 1612/* 1613 * Skip 4: 1614 * stacktrace_trigger() 1615 * event_triggers_post_call() 1616 * trace_event_buffer_commit() 1617 * trace_event_raw_event_xxx() 1618 */ 1619#define STACK_SKIP 4 1620#endif 1621 1622static void 1623stacktrace_trigger(struct event_trigger_data *data, 1624 struct trace_buffer *buffer, void *rec, 1625 struct ring_buffer_event *event) 1626{ 1627 struct trace_event_file *file = data->private_data; 1628 1629 if (file) 1630 __trace_stack(file->tr, tracing_gen_ctx_dec(), STACK_SKIP); 1631 else 1632 trace_dump_stack(STACK_SKIP); 1633} 1634 1635static int 1636stacktrace_trigger_print(struct seq_file *m, struct event_trigger_data *data) 1637{ 1638 return event_trigger_print("stacktrace", m, (void *)data->count, 1639 data->filter_str); 1640} 1641 1642static struct event_command trigger_stacktrace_cmd = { 1643 .name = "stacktrace", 1644 .trigger_type = ETT_STACKTRACE, 1645 .flags = EVENT_CMD_FL_POST_TRIGGER, 1646 .parse = event_trigger_parse, 1647 .reg = register_trigger, 1648 .unreg = unregister_trigger, 1649 .set_filter = set_trigger_filter, 1650 .trigger = stacktrace_trigger, 1651 .count_func = event_trigger_count, 1652 .print = stacktrace_trigger_print, 1653 .init = event_trigger_init, 1654 .free = event_trigger_free, 1655}; 1656 1657static __init int register_trigger_stacktrace_cmd(void) 1658{ 1659 int ret; 1660 1661 ret = register_event_command(&trigger_stacktrace_cmd); 1662 WARN_ON(ret < 0); 1663 1664 return ret; 1665} 1666#else 1667static __init int register_trigger_stacktrace_cmd(void) { return 0; } 1668#endif /* CONFIG_STACKTRACE */ 1669 1670static __init void unregister_trigger_traceon_traceoff_cmds(void) 1671{ 1672 unregister_event_command(&trigger_traceon_cmd); 1673 unregister_event_command(&trigger_traceoff_cmd); 1674} 1675 1676static void 1677event_enable_trigger(struct event_trigger_data *data, 1678 struct trace_buffer *buffer, void *rec, 1679 struct ring_buffer_event *event) 1680{ 1681 struct enable_trigger_data *enable_data = data->private_data; 1682 1683 if (enable_data->enable) 1684 clear_bit(EVENT_FILE_FL_SOFT_DISABLED_BIT, &enable_data->file->flags); 1685 else 1686 set_bit(EVENT_FILE_FL_SOFT_DISABLED_BIT, &enable_data->file->flags); 1687} 1688 1689static bool 1690event_enable_count_func(struct event_trigger_data *data, 1691 struct trace_buffer *buffer, void *rec, 1692 struct ring_buffer_event *event) 1693{ 1694 struct enable_trigger_data *enable_data = data->private_data; 1695 1696 if (!data->count) 1697 return false; 1698 1699 /* Skip if the event is in a state we want to switch to */ 1700 if (enable_data->enable == !(enable_data->file->flags & EVENT_FILE_FL_SOFT_DISABLED)) 1701 return false; 1702 1703 if (data->count != -1) 1704 (data->count)--; 1705 1706 return true; 1707} 1708 1709int event_enable_trigger_print(struct seq_file *m, 1710 struct event_trigger_data *data) 1711{ 1712 struct enable_trigger_data *enable_data = data->private_data; 1713 1714 seq_printf(m, "%s:%s:%s", 1715 enable_data->hist ? 1716 (enable_data->enable ? ENABLE_HIST_STR : DISABLE_HIST_STR) : 1717 (enable_data->enable ? ENABLE_EVENT_STR : DISABLE_EVENT_STR), 1718 enable_data->file->event_call->class->system, 1719 trace_event_name(enable_data->file->event_call)); 1720 1721 if (data->count == -1) 1722 seq_puts(m, ":unlimited"); 1723 else 1724 seq_printf(m, ":count=%ld", data->count); 1725 1726 if (data->filter_str) 1727 seq_printf(m, " if %s\n", data->filter_str); 1728 else 1729 seq_putc(m, '\n'); 1730 1731 return 0; 1732} 1733 1734void event_enable_trigger_free(struct event_trigger_data *data) 1735{ 1736 struct enable_trigger_data *enable_data = data->private_data; 1737 1738 if (WARN_ON_ONCE(data->ref <= 0)) 1739 return; 1740 1741 data->ref--; 1742 if (!data->ref) { 1743 /* Remove the SOFT_MODE flag */ 1744 trace_event_enable_disable(enable_data->file, 0, 1); 1745 trace_event_put_ref(enable_data->file->event_call); 1746 trigger_data_free(data); 1747 kfree(enable_data); 1748 } 1749} 1750 1751int event_enable_trigger_parse(struct event_command *cmd_ops, 1752 struct trace_event_file *file, 1753 char *glob, char *cmd, char *param_and_filter) 1754{ 1755 struct trace_event_file *event_enable_file; 1756 struct enable_trigger_data *enable_data; 1757 struct event_trigger_data *trigger_data; 1758 struct trace_array *tr = file->tr; 1759 char *param, *filter; 1760 bool enable, remove; 1761 const char *system; 1762 const char *event; 1763 bool hist = false; 1764 int ret; 1765 1766 remove = event_trigger_check_remove(glob); 1767 1768 if (event_trigger_empty_param(param_and_filter)) 1769 return -EINVAL; 1770 1771 ret = event_trigger_separate_filter(param_and_filter, ¶m, &filter, true); 1772 if (ret) 1773 return ret; 1774 1775 system = strsep(¶m, ":"); 1776 if (!param) 1777 return -EINVAL; 1778 1779 event = strsep(¶m, ":"); 1780 1781 ret = -EINVAL; 1782 event_enable_file = find_event_file(tr, system, event); 1783 if (!event_enable_file) 1784 return ret; 1785 1786#ifdef CONFIG_HIST_TRIGGERS 1787 hist = ((strcmp(cmd, ENABLE_HIST_STR) == 0) || 1788 (strcmp(cmd, DISABLE_HIST_STR) == 0)); 1789 1790 enable = ((strcmp(cmd, ENABLE_EVENT_STR) == 0) || 1791 (strcmp(cmd, ENABLE_HIST_STR) == 0)); 1792#else 1793 enable = strcmp(cmd, ENABLE_EVENT_STR) == 0; 1794#endif 1795 ret = -ENOMEM; 1796 1797 enable_data = kzalloc(sizeof(*enable_data), GFP_KERNEL); 1798 if (!enable_data) 1799 return ret; 1800 1801 enable_data->hist = hist; 1802 enable_data->enable = enable; 1803 enable_data->file = event_enable_file; 1804 1805 trigger_data = trigger_data_alloc(cmd_ops, cmd, param, enable_data); 1806 if (!trigger_data) { 1807 kfree(enable_data); 1808 return ret; 1809 } 1810 1811 if (remove) { 1812 event_trigger_unregister(cmd_ops, file, glob+1, trigger_data); 1813 kfree(trigger_data); 1814 kfree(enable_data); 1815 ret = 0; 1816 return ret; 1817 } 1818 1819 /* Up the trigger_data count to make sure nothing frees it on failure */ 1820 event_trigger_init(trigger_data); 1821 1822 ret = event_trigger_parse_num(param, trigger_data); 1823 if (ret) 1824 goto out_free; 1825 1826 ret = event_trigger_set_filter(cmd_ops, file, filter, trigger_data); 1827 if (ret < 0) 1828 goto out_free; 1829 1830 /* Don't let event modules unload while probe registered */ 1831 ret = trace_event_try_get_ref(event_enable_file->event_call); 1832 if (!ret) { 1833 ret = -EBUSY; 1834 goto out_free; 1835 } 1836 1837 ret = trace_event_enable_disable(event_enable_file, 1, 1); 1838 if (ret < 0) 1839 goto out_put; 1840 1841 ret = event_trigger_register(cmd_ops, file, glob, trigger_data); 1842 if (ret) 1843 goto out_disable; 1844 1845 event_trigger_free(trigger_data); 1846 return ret; 1847 out_disable: 1848 trace_event_enable_disable(event_enable_file, 0, 1); 1849 out_put: 1850 trace_event_put_ref(event_enable_file->event_call); 1851 out_free: 1852 event_trigger_reset_filter(cmd_ops, trigger_data); 1853 event_trigger_free(trigger_data); 1854 kfree(enable_data); 1855 1856 return ret; 1857} 1858 1859int event_enable_register_trigger(char *glob, 1860 struct event_trigger_data *data, 1861 struct trace_event_file *file) 1862{ 1863 struct enable_trigger_data *enable_data = data->private_data; 1864 struct enable_trigger_data *test_enable_data; 1865 struct event_trigger_data *test; 1866 int ret = 0; 1867 1868 lockdep_assert_held(&event_mutex); 1869 1870 list_for_each_entry(test, &file->triggers, list) { 1871 test_enable_data = test->private_data; 1872 if (test_enable_data && 1873 (test->cmd_ops->trigger_type == 1874 data->cmd_ops->trigger_type) && 1875 (test_enable_data->file == enable_data->file)) { 1876 return -EEXIST; 1877 } 1878 } 1879 1880 if (data->cmd_ops->init) { 1881 ret = data->cmd_ops->init(data); 1882 if (ret < 0) 1883 return ret; 1884 } 1885 1886 list_add_rcu(&data->list, &file->triggers); 1887 1888 update_cond_flag(file); 1889 ret = trace_event_trigger_enable_disable(file, 1); 1890 if (ret < 0) { 1891 list_del_rcu(&data->list); 1892 update_cond_flag(file); 1893 } 1894 return ret; 1895} 1896 1897void event_enable_unregister_trigger(char *glob, 1898 struct event_trigger_data *test, 1899 struct trace_event_file *file) 1900{ 1901 struct enable_trigger_data *test_enable_data = test->private_data; 1902 struct event_trigger_data *data = NULL, *iter; 1903 struct enable_trigger_data *enable_data; 1904 1905 lockdep_assert_held(&event_mutex); 1906 1907 list_for_each_entry(iter, &file->triggers, list) { 1908 enable_data = iter->private_data; 1909 if (enable_data && 1910 (iter->cmd_ops->trigger_type == 1911 test->cmd_ops->trigger_type) && 1912 (enable_data->file == test_enable_data->file)) { 1913 data = iter; 1914 list_del_rcu(&data->list); 1915 trace_event_trigger_enable_disable(file, 0); 1916 update_cond_flag(file); 1917 break; 1918 } 1919 } 1920 1921 if (data && data->cmd_ops->free) 1922 data->cmd_ops->free(data); 1923} 1924 1925static struct event_command trigger_enable_cmd = { 1926 .name = ENABLE_EVENT_STR, 1927 .trigger_type = ETT_EVENT_ENABLE, 1928 .parse = event_enable_trigger_parse, 1929 .reg = event_enable_register_trigger, 1930 .unreg = event_enable_unregister_trigger, 1931 .set_filter = set_trigger_filter, 1932 .trigger = event_enable_trigger, 1933 .count_func = event_enable_count_func, 1934 .print = event_enable_trigger_print, 1935 .init = event_trigger_init, 1936 .free = event_enable_trigger_free, 1937}; 1938 1939static struct event_command trigger_disable_cmd = { 1940 .name = DISABLE_EVENT_STR, 1941 .trigger_type = ETT_EVENT_ENABLE, 1942 .parse = event_enable_trigger_parse, 1943 .reg = event_enable_register_trigger, 1944 .unreg = event_enable_unregister_trigger, 1945 .set_filter = set_trigger_filter, 1946 .trigger = event_enable_trigger, 1947 .count_func = event_enable_count_func, 1948 .print = event_enable_trigger_print, 1949 .init = event_trigger_init, 1950 .free = event_enable_trigger_free, 1951}; 1952 1953static __init void unregister_trigger_enable_disable_cmds(void) 1954{ 1955 unregister_event_command(&trigger_enable_cmd); 1956 unregister_event_command(&trigger_disable_cmd); 1957} 1958 1959static __init int register_trigger_enable_disable_cmds(void) 1960{ 1961 int ret; 1962 1963 ret = register_event_command(&trigger_enable_cmd); 1964 if (WARN_ON(ret < 0)) 1965 return ret; 1966 ret = register_event_command(&trigger_disable_cmd); 1967 if (WARN_ON(ret < 0)) 1968 unregister_trigger_enable_disable_cmds(); 1969 1970 return ret; 1971} 1972 1973static __init int register_trigger_traceon_traceoff_cmds(void) 1974{ 1975 int ret; 1976 1977 ret = register_event_command(&trigger_traceon_cmd); 1978 if (WARN_ON(ret < 0)) 1979 return ret; 1980 ret = register_event_command(&trigger_traceoff_cmd); 1981 if (WARN_ON(ret < 0)) 1982 unregister_trigger_traceon_traceoff_cmds(); 1983 1984 return ret; 1985} 1986 1987__init int register_trigger_cmds(void) 1988{ 1989 register_trigger_traceon_traceoff_cmds(); 1990 register_trigger_snapshot_cmd(); 1991 register_trigger_stacktrace_cmd(); 1992 register_trigger_enable_disable_cmds(); 1993 register_trigger_hist_enable_disable_cmds(); 1994 register_trigger_hist_cmd(); 1995 1996 return 0; 1997}
~/
Read-only file preview.