kernel/trace/trace_events_trigger.c

93 	 * Boot-time trigger registration can fail before kthread creation  in trigger_data_free()
147 	cmd_ops->trigger(data, buffer, rec, event);  in data_ops_trigger()
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
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
166  * trigger is set in the return value.
169  * any trigger that should be deferred, ETT_NONE if nothing to defer.
174  * any trigger that should be deferred, ETT_NONE if nothing to defer.
225  * @tt: enum event_trigger_type containing a set bit for each trigger to invoke
227  * For each trigger associated with an event, invoke the trigger
228  * function registered with the associated trigger command, if the
496  * @data: Trigger-specific data
526  * @name: The name of the event trigger
528  * @data: Trigger-specific data
534  * trigger command and then invokes this.
561  * @data: Trigger-specific data
563  * Common implementation of event trigger initialization.
565  * Usually used directly as the @init method in event trigger
578  * @data: Trigger-specific data
580  * Common implementation of event trigger de-initialization.
582  * Usually used directly as the @free method in event trigger
620  * For each trigger, the triggering event has its tm_ref decremented
624  * combination effectively reverses the soft-mode/trigger state added
625  * by trigger registration.
650  * a post_trigger, trigger invocation needs to be deferred until after
678  * @glob: The raw string used to register the trigger
679  * @data: Trigger-specific data to associate with the trigger
682  * Common implementation for event trigger registration.
721  * True if the trigger was found and unregistered, else false.
753  * @glob: The raw string used to register the trigger
754  * @test: Trigger-specific data used to find the trigger to remove
757  * Common implementation for event trigger unregistration.
770  * Event trigger parsing helper functions.
772  * These functions help make it easier to write an event trigger
774  * function responsible for parsing and registering a trigger command
775  * written to the 'trigger' file.
777  * A trigger command (or just 'trigger' for short) takes the form:
778  *   [trigger] [if filter]
781  * event_command functions) refer to several components of a trigger
782  * command.  Those same components are referenced by the event trigger
785  *   cmd               - the trigger command name
786  *   glob              - the trigger command name optionally prefaced with '!'
794  *   echo 'traceon:5 if pid == 0' > trigger
800  *   echo 'enable_event:sys:event:n' > trigger
806  *   echo 'hist:keys=pid if prio > 50' > trigger
812  *   echo '!enable_event:sys:event:n' > trigger
819  *   echo 'traceoff' > trigger
825  * There are a few different categories of event trigger covered by
831  *    optional 'n' param (n = number of times the trigger should fire)
836  * depends on the complexity of the trigger, and the granularity of
839  * won't need certain functions.  For instance, the hist trigger
845  * event_trigger_check_remove - check whether an event trigger specifies remove
846  * @glob: The trigger command string, with optional remove(!) operator
848  * The event trigger callback implementations pass in 'glob' as a
851  * determines whether the command corresponds to a trigger removal or
852  * a trigger addition.
863  * @param: The trigger param string
865  * The event trigger callback implementations pass in 'param' as a
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
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
889  * NULL, they will contain strings corresponding to the trigger and
897  * trigger with :n (n = number of times the trigger should fire) and
947  * trigger_data_alloc - allocate and init event_trigger_data for a trigger
948  * @cmd_ops: The event_command operations for the trigger
951  * @private_data: User data to associate with the event trigger
954  * @cmd_ops defines how the trigger will operate. If @param is set,
956  * data->count is set to @param and before the trigger is executed, the
958  * false, the @cmd_ops->trigger_ops->trigger() function will not be called.
991  * event_trigger_parse_num - parse and return the number param for a trigger
993  * @trigger_data: The trigger_data for the trigger
995  * Parse the :n (n = number of times the trigger should fire) param
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
1027  * @trigger_data: The trigger_data for the trigger
1029  * Set the filter for the trigger.  If the filter is NULL, just return
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
1050  * Reset the filter for the trigger to no filter.
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
1066  * Register an event trigger.  The @cmd_ops are used to call the
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
1086  * Unregister an event trigger.  The @cmd_ops are used to call the
1098  * End event trigger parsing helper functions.
1103  * @cmd_ops: The command ops, used for trigger registration
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
1109  * Common implementation for event command parsing and trigger
1171  * @filter_str: The filter string for the trigger, NULL to remove filter
1172  * @trigger_data: Trigger-specific data
1205 	/* The filter is for the 'trigger' event, not the triggered event */  in set_trigger_filter()
1253  * find_named_trigger - Find the common named trigger associated with @name
1257  * trigger data.  The first named trigger registered with a given name
1258  * owns the common trigger data that the others subsequently
1260  * returns the common trigger data associated with that first
1263  * Return: the common trigger data for the given named trigger on
1284  * is_named_trigger - determine if a given trigger is a named trigger
1285  * @test: The trigger data to test
1287  * Return: true if 'test' is a named trigger, false otherwise.
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
1320  * del_named_trigger - delete a trigger from the named trigger list
1321  * @data: The trigger data to delete
1349  * @data: The trigger data of a named trigger to pause
1351  * Pauses a named trigger along with all other triggers having the
1353  * pausing only one is meaningless, so pausing one named trigger needs
1363  * @data: The trigger data of a named trigger to unpause
1365  * Un-pauses a named trigger along with all other triggers having the
1367  * unpausing only one is meaningless, so unpausing one named trigger
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
1381  * trigger data.  The first named trigger registered with a given name
1382  * owns the common trigger data that the others subsequently
1384  * associates the common trigger data from the first trigger with the
1385  * given trigger.
1496 	.trigger		= traceon_trigger,
1511 	.trigger		= traceoff_trigger,
1570 	.trigger		= snapshot_trigger,
1636 	.trigger		= stacktrace_trigger,
1918 	.trigger		= event_enable_trigger,
1932 	.trigger		= event_enable_trigger,