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.
602  * @glob: The raw string used to register the trigger
603  * @test: Trigger-specific data used to find the trigger to remove
606  * Common implementation for event trigger unregistration.
634  * Event trigger parsing helper functions.
636  * These functions help make it easier to write an event trigger
638  * function responsible for parsing and registering a trigger command
639  * written to the 'trigger' file.
641  * A trigger command (or just 'trigger' for short) takes the form:
642  *   [trigger] [if filter]
645  * event_command functions) refer to several components of a trigger
646  * command.  Those same components are referenced by the event trigger
649  *   cmd               - the trigger command name
650  *   glob              - the trigger command name optionally prefaced with '!'
658  *   echo 'traceon:5 if pid == 0' > trigger
664  *   echo 'enable_event:sys:event:n' > trigger
670  *   echo 'hist:keys=pid if prio > 50' > trigger
676  *   echo '!enable_event:sys:event:n' > trigger
683  *   echo 'traceoff' > trigger
689  * There are a few different categories of event trigger covered by
695  *    optional 'n' param (n = number of times the trigger should fire)
700  * depends on the complexity of the trigger, and the granularity of
703  * won't need certain functions.  For instance, the hist trigger
709  * event_trigger_check_remove - check whether an event trigger specifies remove
710  * @glob: The trigger command string, with optional remove(!) operator
712  * The event trigger callback implementations pass in 'glob' as a
715  * determines whether the command corresponds to a trigger removal or
716  * a trigger addition.
727  * @param: The trigger param string
729  * The event trigger callback implementations pass in 'param' as a
743  * event_trigger_separate_filter - separate an event trigger from a filter
744  * @param_and_filter: String containing trigger and possibly filter
745  * @param: outparam, will be filled with a pointer to the trigger
749  * Given a param string of the form '[trigger] [if filter]', this
750  * function separates the filter from the trigger and returns the
751  * trigger in @param and the filter in @filter.  Either the @param
753  * NULL, they will contain strings corresponding to the trigger and
761  * trigger with :n (n = number of times the trigger should fire) and
812  * event_trigger_alloc - allocate and init event_trigger_data for a trigger
813  * @cmd_ops: The event_command operations for the trigger
816  * @private_data: User data to associate with the event trigger
854  * event_trigger_parse_num - parse and return the number param for a trigger
856  * @trigger_data: The trigger_data for the trigger
858  * Parse the :n (n = number of times the trigger should fire) param
886  * event_trigger_set_filter - set an event trigger's filter
887  * @cmd_ops: The event_command operations for the trigger
888  * @file: The event file for the trigger's event
890  * @trigger_data: The trigger_data for the trigger
892  * Set the filter for the trigger.  If the filter is NULL, just return
909  * event_trigger_reset_filter - reset an event trigger's filter
910  * @cmd_ops: The event_command operations for the trigger
911  * @trigger_data: The trigger_data for the trigger
913  * Reset the filter for the trigger to no filter.
923  * event_trigger_register - register an event trigger
924  * @cmd_ops: The event_command operations for the trigger
925  * @file: The event file for the trigger's event
926  * @glob: The trigger command string, with optional remove(!) operator
927  * @trigger_data: The trigger_data for the trigger
929  * Register an event trigger.  The @cmd_ops are used to call the
943  * event_trigger_unregister - unregister an event trigger
944  * @cmd_ops: The event_command operations for the trigger
945  * @file: The event file for the trigger's event
946  * @glob: The trigger command string, with optional remove(!) operator
947  * @trigger_data: The trigger_data for the trigger
949  * Unregister an event trigger.  The @cmd_ops are used to call the
961  * End event trigger parsing helper functions.
966  * @cmd_ops: The command ops, used for trigger registration
968  * @glob: The raw string used to register the trigger
969  * @cmd: The cmd portion of the string used to register the trigger
970  * @param_and_filter: The param and filter portion of the string used to register the trigger
972  * Common implementation for event command parsing and trigger
1036  * @filter_str: The filter string for the trigger, NULL to remove filter
1037  * @trigger_data: Trigger-specific data
1070 	/* The filter is for the 'trigger' event, not the triggered event */  in set_trigger_filter()
1119  * find_named_trigger - Find the common named trigger associated with @name
1123  * trigger data.  The first named trigger registered with a given name
1124  * owns the common trigger data that the others subsequently
1126  * returns the common trigger data associated with that first
1129  * Return: the common trigger data for the given named trigger on
1150  * is_named_trigger - determine if a given trigger is a named trigger
1151  * @test: The trigger data to test
1153  * Return: true if 'test' is a named trigger, false otherwise.
1168  * save_named_trigger - save the trigger in the named trigger list
1169  * @name: The name of the named trigger set
1170  * @data: The trigger data to save
1186  * del_named_trigger - delete a trigger from the named trigger list
1187  * @data: The trigger data to delete
1215  * @data: The trigger data of a named trigger to pause
1217  * Pauses a named trigger along with all other triggers having the
1219  * pausing only one is meaningless, so pausing one named trigger needs
1229  * @data: The trigger data of a named trigger to unpause
1231  * Un-pauses a named trigger along with all other triggers having the
1233  * unpausing only one is meaningless, so unpausing one named trigger
1242  * set_named_trigger_data - Associate common named trigger data
1243  * @data: The trigger data to associate
1244  * @named_data: The common named trigger to be associated
1247  * trigger data.  The first named trigger registered with a given name
1248  * owns the common trigger data that the others subsequently
1250  * associates the common trigger data from the first trigger with the
1251  * given trigger.
1376 	.trigger		= traceon_trigger,
1383 	.trigger		= traceon_count_trigger,
1390 	.trigger		= traceoff_trigger,
1397 	.trigger		= traceoff_count_trigger,
1489 	.trigger		= snapshot_trigger,
1496 	.trigger		= snapshot_count_trigger,
1584 	.trigger		= stacktrace_trigger,
1591 	.trigger		= stacktrace_count_trigger,
1709 	.trigger		= event_enable_trigger,
1716 	.trigger		= event_enable_count_trigger,
1723 	.trigger		= event_enable_trigger,
1730 	.trigger		= event_enable_count_trigger,