kernel/trace/trace_events_trigger.c

38  * For each trigger associated with an event, invoke the trigger
39  * function registered with the associated trigger command.  If rec is
40  * non-NULL, it means that the trigger requires further processing and
42  * trigger has a filter associated with it, rec will checked against
43  * the filter and if the record matches the trigger will be invoked.
44  * If the trigger is a 'post_trigger', meaning it shouldn't be invoked
45  * in any case until the current event is written, the trigger
47  * trigger is set in the return value.
50  * any trigger that should be deferred, ETT_NONE if nothing to defer.
55  * any trigger that should be deferred, ETT_NONE if nothing to defer.
73 			data->ops->trigger(data, buffer, rec, event);  in event_triggers_call()
83 		data->ops->trigger(data, buffer, rec, event);  in event_triggers_call()
106  * @tt: enum event_trigger_type containing a set bit for each trigger to invoke
108  * For each trigger associated with an event, invoke the trigger
109  * function registered with the associated trigger command, if the
125 			data->ops->trigger(data, NULL, NULL, NULL);  in event_triggers_post_call()
403  * @name: The name of the event trigger
405  * @data: Trigger-specific data
411  * trigger command and then invokes this.
438  * @data: Trigger-specific data
440  * Common implementation of event trigger initialization.
442  * Usually used directly as the @init method in event trigger
455  * @data: Trigger-specific data
457  * Common implementation of event trigger de-initialization.
459  * Usually used directly as the @free method in event trigger
497  * For each trigger, the triggering event has its tm_ref decremented
501  * combination effectively reverses the soft-mode/trigger state added
502  * by trigger registration.
527  * a post_trigger, trigger invocation needs to be deferred until after
555  * @glob: The raw string used to register the trigger
556  * @data: Trigger-specific data to associate with the trigger
559  * Common implementation for event trigger registration.
601  * True if the trigger was found and unregistered, else false.
633  * @glob: The raw string used to register the trigger
634  * @test: Trigger-specific data used to find the trigger to remove
637  * Common implementation for event trigger unregistration.
650  * Event trigger parsing helper functions.
652  * These functions help make it easier to write an event trigger
654  * function responsible for parsing and registering a trigger command
655  * written to the 'trigger' file.
657  * A trigger command (or just 'trigger' for short) takes the form:
658  *   [trigger] [if filter]
661  * event_command functions) refer to several components of a trigger
662  * command.  Those same components are referenced by the event trigger
665  *   cmd               - the trigger command name
666  *   glob              - the trigger command name optionally prefaced with '!'
674  *   echo 'traceon:5 if pid == 0' > trigger
680  *   echo 'enable_event:sys:event:n' > trigger
686  *   echo 'hist:keys=pid if prio > 50' > trigger
692  *   echo '!enable_event:sys:event:n' > trigger
699  *   echo 'traceoff' > trigger
705  * There are a few different categories of event trigger covered by
711  *    optional 'n' param (n = number of times the trigger should fire)
716  * depends on the complexity of the trigger, and the granularity of
719  * won't need certain functions.  For instance, the hist trigger
725  * event_trigger_check_remove - check whether an event trigger specifies remove
726  * @glob: The trigger command string, with optional remove(!) operator
728  * The event trigger callback implementations pass in 'glob' as a
731  * determines whether the command corresponds to a trigger removal or
732  * a trigger addition.
743  * @param: The trigger param string
745  * The event trigger callback implementations pass in 'param' as a
759  * event_trigger_separate_filter - separate an event trigger from a filter
760  * @param_and_filter: String containing trigger and possibly filter
761  * @param: outparam, will be filled with a pointer to the trigger
765  * Given a param string of the form '[trigger] [if filter]', this
766  * function separates the filter from the trigger and returns the
767  * trigger in @param and the filter in @filter.  Either the @param
769  * NULL, they will contain strings corresponding to the trigger and
777  * trigger with :n (n = number of times the trigger should fire) and
828  * event_trigger_alloc - allocate and init event_trigger_data for a trigger
829  * @cmd_ops: The event_command operations for the trigger
832  * @private_data: User data to associate with the event trigger
870  * event_trigger_parse_num - parse and return the number param for a trigger
872  * @trigger_data: The trigger_data for the trigger
874  * Parse the :n (n = number of times the trigger should fire) param
902  * event_trigger_set_filter - set an event trigger's filter
903  * @cmd_ops: The event_command operations for the trigger
904  * @file: The event file for the trigger's event
906  * @trigger_data: The trigger_data for the trigger
908  * Set the filter for the trigger.  If the filter is NULL, just return
925  * event_trigger_reset_filter - reset an event trigger's filter
926  * @cmd_ops: The event_command operations for the trigger
927  * @trigger_data: The trigger_data for the trigger
929  * Reset the filter for the trigger to no filter.
939  * event_trigger_register - register an event trigger
940  * @cmd_ops: The event_command operations for the trigger
941  * @file: The event file for the trigger's event
942  * @glob: The trigger command string, with optional remove(!) operator
943  * @trigger_data: The trigger_data for the trigger
945  * Register an event trigger.  The @cmd_ops are used to call the
959  * event_trigger_unregister - unregister an event trigger
960  * @cmd_ops: The event_command operations for the trigger
961  * @file: The event file for the trigger's event
962  * @glob: The trigger command string, with optional remove(!) operator
963  * @trigger_data: The trigger_data for the trigger
965  * Unregister an event trigger.  The @cmd_ops are used to call the
977  * End event trigger parsing helper functions.
982  * @cmd_ops: The command ops, used for trigger registration
984  * @glob: The raw string used to register the trigger
985  * @cmd: The cmd portion of the string used to register the trigger
986  * @param_and_filter: The param and filter portion of the string used to register the trigger
988  * Common implementation for event command parsing and trigger
1052  * @filter_str: The filter string for the trigger, NULL to remove filter
1053  * @trigger_data: Trigger-specific data
1086 	/* The filter is for the 'trigger' event, not the triggered event */  in set_trigger_filter()
1135  * find_named_trigger - Find the common named trigger associated with @name
1139  * trigger data.  The first named trigger registered with a given name
1140  * owns the common trigger data that the others subsequently
1142  * returns the common trigger data associated with that first
1145  * Return: the common trigger data for the given named trigger on
1166  * is_named_trigger - determine if a given trigger is a named trigger
1167  * @test: The trigger data to test
1169  * Return: true if 'test' is a named trigger, false otherwise.
1184  * save_named_trigger - save the trigger in the named trigger list
1185  * @name: The name of the named trigger set
1186  * @data: The trigger data to save
1202  * del_named_trigger - delete a trigger from the named trigger list
1203  * @data: The trigger data to delete
1231  * @data: The trigger data of a named trigger to pause
1233  * Pauses a named trigger along with all other triggers having the
1235  * pausing only one is meaningless, so pausing one named trigger needs
1245  * @data: The trigger data of a named trigger to unpause
1247  * Un-pauses a named trigger along with all other triggers having the
1249  * unpausing only one is meaningless, so unpausing one named trigger
1258  * set_named_trigger_data - Associate common named trigger data
1259  * @data: The trigger data to associate
1260  * @named_data: The common named trigger to be associated
1263  * trigger data.  The first named trigger registered with a given name
1264  * owns the common trigger data that the others subsequently
1266  * associates the common trigger data from the first trigger with the
1267  * given trigger.
1392 	.trigger		= traceon_trigger,
1399 	.trigger		= traceon_count_trigger,
1406 	.trigger		= traceoff_trigger,
1413 	.trigger		= traceoff_count_trigger,
1516 	.trigger		= snapshot_trigger,
1523 	.trigger		= snapshot_count_trigger,
1611 	.trigger		= stacktrace_trigger,
1618 	.trigger		= stacktrace_count_trigger,
1736 	.trigger		= event_enable_trigger,
1743 	.trigger		= event_enable_count_trigger,
1750 	.trigger		= event_enable_trigger,
1757 	.trigger		= event_enable_count_trigger,