Orange Pi5 kernel

Deprecated Linux kernel 5.10.110 for OrangePi 5/5B/5+ boards

3 Commits   0 Branches   0 Tags
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300    1) ================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300    2) Event Histograms
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300    3) ================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300    4) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300    5) Documentation written by Tom Zanussi
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300    6) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300    7) 1. Introduction
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300    8) ===============
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300    9) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   10)   Histogram triggers are special event triggers that can be used to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   11)   aggregate trace event data into histograms.  For information on
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   12)   trace events and event triggers, see Documentation/trace/events.rst.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   13) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   14) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   15) 2. Histogram Trigger Command
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   16) ============================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   17) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   18)   A histogram trigger command is an event trigger command that
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   19)   aggregates event hits into a hash table keyed on one or more trace
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   20)   event format fields (or stacktrace) and a set of running totals
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   21)   derived from one or more trace event format fields and/or event
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   22)   counts (hitcount).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   23) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   24)   The format of a hist trigger is as follows::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   25) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   26)         hist:keys=<field1[,field2,...]>[:values=<field1[,field2,...]>]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   27)           [:sort=<field1[,field2,...]>][:size=#entries][:pause][:continue]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   28)           [:clear][:name=histname1][:<handler>.<action>] [if <filter>]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   29) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   30)   When a matching event is hit, an entry is added to a hash table
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   31)   using the key(s) and value(s) named.  Keys and values correspond to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   32)   fields in the event's format description.  Values must correspond to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   33)   numeric fields - on an event hit, the value(s) will be added to a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   34)   sum kept for that field.  The special string 'hitcount' can be used
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   35)   in place of an explicit value field - this is simply a count of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   36)   event hits.  If 'values' isn't specified, an implicit 'hitcount'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   37)   value will be automatically created and used as the only value.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   38)   Keys can be any field, or the special string 'stacktrace', which
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   39)   will use the event's kernel stacktrace as the key.  The keywords
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   40)   'keys' or 'key' can be used to specify keys, and the keywords
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   41)   'values', 'vals', or 'val' can be used to specify values.  Compound
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   42)   keys consisting of up to two fields can be specified by the 'keys'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   43)   keyword.  Hashing a compound key produces a unique entry in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   44)   table for each unique combination of component keys, and can be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   45)   useful for providing more fine-grained summaries of event data.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   46)   Additionally, sort keys consisting of up to two fields can be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   47)   specified by the 'sort' keyword.  If more than one field is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   48)   specified, the result will be a 'sort within a sort': the first key
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   49)   is taken to be the primary sort key and the second the secondary
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   50)   key.  If a hist trigger is given a name using the 'name' parameter,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   51)   its histogram data will be shared with other triggers of the same
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   52)   name, and trigger hits will update this common data.  Only triggers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   53)   with 'compatible' fields can be combined in this way; triggers are
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   54)   'compatible' if the fields named in the trigger share the same
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   55)   number and type of fields and those fields also have the same names.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   56)   Note that any two events always share the compatible 'hitcount' and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   57)   'stacktrace' fields and can therefore be combined using those
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   58)   fields, however pointless that may be.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   59) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   60)   'hist' triggers add a 'hist' file to each event's subdirectory.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   61)   Reading the 'hist' file for the event will dump the hash table in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   62)   its entirety to stdout.  If there are multiple hist triggers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   63)   attached to an event, there will be a table for each trigger in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   64)   output.  The table displayed for a named trigger will be the same as
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   65)   any other instance having the same name. Each printed hash table
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   66)   entry is a simple list of the keys and values comprising the entry;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   67)   keys are printed first and are delineated by curly braces, and are
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   68)   followed by the set of value fields for the entry.  By default,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   69)   numeric fields are displayed as base-10 integers.  This can be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   70)   modified by appending any of the following modifiers to the field
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   71)   name:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   72) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   73) 	=========== ==========================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   74)         .hex        display a number as a hex value
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   75) 	.sym        display an address as a symbol
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   76) 	.sym-offset display an address as a symbol and offset
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   77) 	.syscall    display a syscall id as a system call name
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   78) 	.execname   display a common_pid as a program name
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   79) 	.log2       display log2 value rather than raw number
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   80) 	.usecs      display a common_timestamp in microseconds
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   81) 	=========== ==========================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   82) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   83)   Note that in general the semantics of a given field aren't
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   84)   interpreted when applying a modifier to it, but there are some
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   85)   restrictions to be aware of in this regard:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   86) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   87)     - only the 'hex' modifier can be used for values (because values
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   88)       are essentially sums, and the other modifiers don't make sense
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   89)       in that context).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   90)     - the 'execname' modifier can only be used on a 'common_pid'.  The
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   91)       reason for this is that the execname is simply the 'comm' value
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   92)       saved for the 'current' process when an event was triggered,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   93)       which is the same as the common_pid value saved by the event
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   94)       tracing code.  Trying to apply that comm value to other pid
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   95)       values wouldn't be correct, and typically events that care save
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   96)       pid-specific comm fields in the event itself.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   97) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   98)   A typical usage scenario would be the following to enable a hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   99)   trigger, read its current contents, and then turn it off::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  100) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  101)     # echo 'hist:keys=skbaddr.hex:vals=len' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  102)       /sys/kernel/debug/tracing/events/net/netif_rx/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  103) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  104)     # cat /sys/kernel/debug/tracing/events/net/netif_rx/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  105) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  106)     # echo '!hist:keys=skbaddr.hex:vals=len' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  107)       /sys/kernel/debug/tracing/events/net/netif_rx/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  108) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  109)   The trigger file itself can be read to show the details of the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  110)   currently attached hist trigger.  This information is also displayed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  111)   at the top of the 'hist' file when read.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  112) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  113)   By default, the size of the hash table is 2048 entries.  The 'size'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  114)   parameter can be used to specify more or fewer than that.  The units
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  115)   are in terms of hashtable entries - if a run uses more entries than
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  116)   specified, the results will show the number of 'drops', the number
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  117)   of hits that were ignored.  The size should be a power of 2 between
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  118)   128 and 131072 (any non- power-of-2 number specified will be rounded
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  119)   up).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  120) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  121)   The 'sort' parameter can be used to specify a value field to sort
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  122)   on.  The default if unspecified is 'hitcount' and the default sort
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  123)   order is 'ascending'.  To sort in the opposite direction, append
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  124)   .descending' to the sort key.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  125) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  126)   The 'pause' parameter can be used to pause an existing hist trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  127)   or to start a hist trigger but not log any events until told to do
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  128)   so.  'continue' or 'cont' can be used to start or restart a paused
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  129)   hist trigger.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  130) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  131)   The 'clear' parameter will clear the contents of a running hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  132)   trigger and leave its current paused/active state.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  133) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  134)   Note that the 'pause', 'cont', and 'clear' parameters should be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  135)   applied using 'append' shell operator ('>>') if applied to an
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  136)   existing trigger, rather than via the '>' operator, which will cause
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  137)   the trigger to be removed through truncation.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  138) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  139) - enable_hist/disable_hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  140) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  141)   The enable_hist and disable_hist triggers can be used to have one
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  142)   event conditionally start and stop another event's already-attached
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  143)   hist trigger.  Any number of enable_hist and disable_hist triggers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  144)   can be attached to a given event, allowing that event to kick off
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  145)   and stop aggregations on a host of other events.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  146) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  147)   The format is very similar to the enable/disable_event triggers::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  148) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  149)       enable_hist:<system>:<event>[:count]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  150)       disable_hist:<system>:<event>[:count]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  151) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  152)   Instead of enabling or disabling the tracing of the target event
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  153)   into the trace buffer as the enable/disable_event triggers do, the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  154)   enable/disable_hist triggers enable or disable the aggregation of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  155)   the target event into a hash table.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  156) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  157)   A typical usage scenario for the enable_hist/disable_hist triggers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  158)   would be to first set up a paused hist trigger on some event,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  159)   followed by an enable_hist/disable_hist pair that turns the hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  160)   aggregation on and off when conditions of interest are hit::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  161) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  162)    # echo 'hist:keys=skbaddr.hex:vals=len:pause' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  163)       /sys/kernel/debug/tracing/events/net/netif_receive_skb/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  164) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  165)     # echo 'enable_hist:net:netif_receive_skb if filename==/usr/bin/wget' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  166)       /sys/kernel/debug/tracing/events/sched/sched_process_exec/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  167) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  168)     # echo 'disable_hist:net:netif_receive_skb if comm==wget' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  169)       /sys/kernel/debug/tracing/events/sched/sched_process_exit/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  170) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  171)   The above sets up an initially paused hist trigger which is unpaused
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  172)   and starts aggregating events when a given program is executed, and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  173)   which stops aggregating when the process exits and the hist trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  174)   is paused again.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  175) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  176)   The examples below provide a more concrete illustration of the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  177)   concepts and typical usage patterns discussed above.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  178) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  179) 'special' event fields
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  180) ------------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  181) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  182)   There are a number of 'special event fields' available for use as
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  183)   keys or values in a hist trigger.  These look like and behave as if
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  184)   they were actual event fields, but aren't really part of the event's
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  185)   field definition or format file.  They are however available for any
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  186)   event, and can be used anywhere an actual event field could be.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  187)   They are:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  188) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  189)     ====================== ==== =======================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  190)     common_timestamp       u64  timestamp (from ring buffer) associated
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  191)                                 with the event, in nanoseconds.  May be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  192) 			        modified by .usecs to have timestamps
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  193) 			        interpreted as microseconds.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  194)     common_cpu             int  the cpu on which the event occurred.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  195)     ====================== ==== =======================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  196) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  197) Extended error information
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  198) --------------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  199) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  200)   For some error conditions encountered when invoking a hist trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  201)   command, extended error information is available via the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  202)   tracing/error_log file.  See Error Conditions in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  203)   :file:`Documentation/trace/ftrace.rst` for details.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  204) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  205) 6.2 'hist' trigger examples
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  206) ---------------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  207) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  208)   The first set of examples creates aggregations using the kmalloc
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  209)   event.  The fields that can be used for the hist trigger are listed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  210)   in the kmalloc event's format file::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  211) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  212)     # cat /sys/kernel/debug/tracing/events/kmem/kmalloc/format
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  213)     name: kmalloc
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  214)     ID: 374
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  215)     format:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  216) 	field:unsigned short common_type;	offset:0;	size:2;	signed:0;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  217) 	field:unsigned char common_flags;	offset:2;	size:1;	signed:0;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  218) 	field:unsigned char common_preempt_count;		offset:3;	size:1;	signed:0;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  219) 	field:int common_pid;					offset:4;	size:4;	signed:1;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  220) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  221) 	field:unsigned long call_site;				offset:8;	size:8;	signed:0;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  222) 	field:const void * ptr;					offset:16;	size:8;	signed:0;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  223) 	field:size_t bytes_req;					offset:24;	size:8;	signed:0;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  224) 	field:size_t bytes_alloc;				offset:32;	size:8;	signed:0;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  225) 	field:gfp_t gfp_flags;					offset:40;	size:4;	signed:0;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  226) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  227)   We'll start by creating a hist trigger that generates a simple table
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  228)   that lists the total number of bytes requested for each function in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  229)   the kernel that made one or more calls to kmalloc::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  230) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  231)     # echo 'hist:key=call_site:val=bytes_req' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  232)             /sys/kernel/debug/tracing/events/kmem/kmalloc/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  233) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  234)   This tells the tracing system to create a 'hist' trigger using the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  235)   call_site field of the kmalloc event as the key for the table, which
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  236)   just means that each unique call_site address will have an entry
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  237)   created for it in the table.  The 'val=bytes_req' parameter tells
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  238)   the hist trigger that for each unique entry (call_site) in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  239)   table, it should keep a running total of the number of bytes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  240)   requested by that call_site.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  241) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  242)   We'll let it run for awhile and then dump the contents of the 'hist'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  243)   file in the kmalloc event's subdirectory (for readability, a number
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  244)   of entries have been omitted)::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  245) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  246)     # cat /sys/kernel/debug/tracing/events/kmem/kmalloc/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  247)     # trigger info: hist:keys=call_site:vals=bytes_req:sort=hitcount:size=2048 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  248) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  249)     { call_site: 18446744072106379007 } hitcount:          1  bytes_req:        176
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  250)     { call_site: 18446744071579557049 } hitcount:          1  bytes_req:       1024
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  251)     { call_site: 18446744071580608289 } hitcount:          1  bytes_req:      16384
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  252)     { call_site: 18446744071581827654 } hitcount:          1  bytes_req:         24
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  253)     { call_site: 18446744071580700980 } hitcount:          1  bytes_req:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  254)     { call_site: 18446744071579359876 } hitcount:          1  bytes_req:        152
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  255)     { call_site: 18446744071580795365 } hitcount:          3  bytes_req:        144
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  256)     { call_site: 18446744071581303129 } hitcount:          3  bytes_req:        144
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  257)     { call_site: 18446744071580713234 } hitcount:          4  bytes_req:       2560
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  258)     { call_site: 18446744071580933750 } hitcount:          4  bytes_req:        736
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  259)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  260)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  261)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  262)     { call_site: 18446744072106047046 } hitcount:         69  bytes_req:       5576
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  263)     { call_site: 18446744071582116407 } hitcount:         73  bytes_req:       2336
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  264)     { call_site: 18446744072106054684 } hitcount:        136  bytes_req:     140504
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  265)     { call_site: 18446744072106224230 } hitcount:        136  bytes_req:      19584
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  266)     { call_site: 18446744072106078074 } hitcount:        153  bytes_req:       2448
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  267)     { call_site: 18446744072106062406 } hitcount:        153  bytes_req:      36720
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  268)     { call_site: 18446744071582507929 } hitcount:        153  bytes_req:      37088
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  269)     { call_site: 18446744072102520590 } hitcount:        273  bytes_req:      10920
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  270)     { call_site: 18446744071582143559 } hitcount:        358  bytes_req:        716
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  271)     { call_site: 18446744072106465852 } hitcount:        417  bytes_req:      56712
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  272)     { call_site: 18446744072102523378 } hitcount:        485  bytes_req:      27160
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  273)     { call_site: 18446744072099568646 } hitcount:       1676  bytes_req:      33520
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  274) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  275)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  276)         Hits: 4610
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  277)         Entries: 45
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  278)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  279) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  280)   The output displays a line for each entry, beginning with the key
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  281)   specified in the trigger, followed by the value(s) also specified in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  282)   the trigger.  At the beginning of the output is a line that displays
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  283)   the trigger info, which can also be displayed by reading the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  284)   'trigger' file::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  285) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  286)     # cat /sys/kernel/debug/tracing/events/kmem/kmalloc/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  287)     hist:keys=call_site:vals=bytes_req:sort=hitcount:size=2048 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  288) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  289)   At the end of the output are a few lines that display the overall
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  290)   totals for the run.  The 'Hits' field shows the total number of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  291)   times the event trigger was hit, the 'Entries' field shows the total
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  292)   number of used entries in the hash table, and the 'Dropped' field
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  293)   shows the number of hits that were dropped because the number of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  294)   used entries for the run exceeded the maximum number of entries
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  295)   allowed for the table (normally 0, but if not a hint that you may
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  296)   want to increase the size of the table using the 'size' parameter).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  297) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  298)   Notice in the above output that there's an extra field, 'hitcount',
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  299)   which wasn't specified in the trigger.  Also notice that in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  300)   trigger info output, there's a parameter, 'sort=hitcount', which
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  301)   wasn't specified in the trigger either.  The reason for that is that
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  302)   every trigger implicitly keeps a count of the total number of hits
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  303)   attributed to a given entry, called the 'hitcount'.  That hitcount
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  304)   information is explicitly displayed in the output, and in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  305)   absence of a user-specified sort parameter, is used as the default
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  306)   sort field.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  307) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  308)   The value 'hitcount' can be used in place of an explicit value in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  309)   the 'values' parameter if you don't really need to have any
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  310)   particular field summed and are mainly interested in hit
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  311)   frequencies.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  312) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  313)   To turn the hist trigger off, simply call up the trigger in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  314)   command history and re-execute it with a '!' prepended::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  315) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  316)     # echo '!hist:key=call_site:val=bytes_req' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  317)            /sys/kernel/debug/tracing/events/kmem/kmalloc/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  318) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  319)   Finally, notice that the call_site as displayed in the output above
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  320)   isn't really very useful.  It's an address, but normally addresses
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  321)   are displayed in hex.  To have a numeric field displayed as a hex
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  322)   value, simply append '.hex' to the field name in the trigger::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  323) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  324)     # echo 'hist:key=call_site.hex:val=bytes_req' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  325)            /sys/kernel/debug/tracing/events/kmem/kmalloc/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  326) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  327)     # cat /sys/kernel/debug/tracing/events/kmem/kmalloc/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  328)     # trigger info: hist:keys=call_site.hex:vals=bytes_req:sort=hitcount:size=2048 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  329) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  330)     { call_site: ffffffffa026b291 } hitcount:          1  bytes_req:        433
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  331)     { call_site: ffffffffa07186ff } hitcount:          1  bytes_req:        176
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  332)     { call_site: ffffffff811ae721 } hitcount:          1  bytes_req:      16384
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  333)     { call_site: ffffffff811c5134 } hitcount:          1  bytes_req:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  334)     { call_site: ffffffffa04a9ebb } hitcount:          1  bytes_req:        511
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  335)     { call_site: ffffffff8122e0a6 } hitcount:          1  bytes_req:         12
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  336)     { call_site: ffffffff8107da84 } hitcount:          1  bytes_req:        152
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  337)     { call_site: ffffffff812d8246 } hitcount:          1  bytes_req:         24
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  338)     { call_site: ffffffff811dc1e5 } hitcount:          3  bytes_req:        144
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  339)     { call_site: ffffffffa02515e8 } hitcount:          3  bytes_req:        648
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  340)     { call_site: ffffffff81258159 } hitcount:          3  bytes_req:        144
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  341)     { call_site: ffffffff811c80f4 } hitcount:          4  bytes_req:        544
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  342)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  343)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  344)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  345)     { call_site: ffffffffa06c7646 } hitcount:        106  bytes_req:       8024
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  346)     { call_site: ffffffffa06cb246 } hitcount:        132  bytes_req:      31680
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  347)     { call_site: ffffffffa06cef7a } hitcount:        132  bytes_req:       2112
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  348)     { call_site: ffffffff8137e399 } hitcount:        132  bytes_req:      23232
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  349)     { call_site: ffffffffa06c941c } hitcount:        185  bytes_req:     171360
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  350)     { call_site: ffffffffa06f2a66 } hitcount:        185  bytes_req:      26640
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  351)     { call_site: ffffffffa036a70e } hitcount:        265  bytes_req:      10600
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  352)     { call_site: ffffffff81325447 } hitcount:        292  bytes_req:        584
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  353)     { call_site: ffffffffa072da3c } hitcount:        446  bytes_req:      60656
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  354)     { call_site: ffffffffa036b1f2 } hitcount:        526  bytes_req:      29456
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  355)     { call_site: ffffffffa0099c06 } hitcount:       1780  bytes_req:      35600
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  356) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  357)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  358)         Hits: 4775
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  359)         Entries: 46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  360)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  361) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  362)   Even that's only marginally more useful - while hex values do look
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  363)   more like addresses, what users are typically more interested in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  364)   when looking at text addresses are the corresponding symbols
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  365)   instead.  To have an address displayed as symbolic value instead,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  366)   simply append '.sym' or '.sym-offset' to the field name in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  367)   trigger::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  368) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  369)     # echo 'hist:key=call_site.sym:val=bytes_req' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  370)            /sys/kernel/debug/tracing/events/kmem/kmalloc/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  371) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  372)     # cat /sys/kernel/debug/tracing/events/kmem/kmalloc/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  373)     # trigger info: hist:keys=call_site.sym:vals=bytes_req:sort=hitcount:size=2048 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  374) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  375)     { call_site: [ffffffff810adcb9] syslog_print_all                              } hitcount:          1  bytes_req:       1024
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  376)     { call_site: [ffffffff8154bc62] usb_control_msg                               } hitcount:          1  bytes_req:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  377)     { call_site: [ffffffffa00bf6fe] hidraw_send_report [hid]                      } hitcount:          1  bytes_req:          7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  378)     { call_site: [ffffffff8154acbe] usb_alloc_urb                                 } hitcount:          1  bytes_req:        192
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  379)     { call_site: [ffffffffa00bf1ca] hidraw_report_event [hid]                     } hitcount:          1  bytes_req:          7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  380)     { call_site: [ffffffff811e3a25] __seq_open_private                            } hitcount:          1  bytes_req:         40
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  381)     { call_site: [ffffffff8109524a] alloc_fair_sched_group                        } hitcount:          2  bytes_req:        128
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  382)     { call_site: [ffffffff811febd5] fsnotify_alloc_group                          } hitcount:          2  bytes_req:        528
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  383)     { call_site: [ffffffff81440f58] __tty_buffer_request_room                     } hitcount:          2  bytes_req:       2624
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  384)     { call_site: [ffffffff81200ba6] inotify_new_group                             } hitcount:          2  bytes_req:         96
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  385)     { call_site: [ffffffffa05e19af] ieee80211_start_tx_ba_session [mac80211]      } hitcount:          2  bytes_req:        464
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  386)     { call_site: [ffffffff81672406] tcp_get_metrics                               } hitcount:          2  bytes_req:        304
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  387)     { call_site: [ffffffff81097ec2] alloc_rt_sched_group                          } hitcount:          2  bytes_req:        128
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  388)     { call_site: [ffffffff81089b05] sched_create_group                            } hitcount:          2  bytes_req:       1424
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  389)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  390)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  391)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  392)     { call_site: [ffffffffa04a580c] intel_crtc_page_flip [i915]                   } hitcount:       1185  bytes_req:     123240
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  393)     { call_site: [ffffffffa0287592] drm_mode_page_flip_ioctl [drm]                } hitcount:       1185  bytes_req:     104280
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  394)     { call_site: [ffffffffa04c4a3c] intel_plane_duplicate_state [i915]            } hitcount:       1402  bytes_req:     190672
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  395)     { call_site: [ffffffff812891ca] ext4_find_extent                              } hitcount:       1518  bytes_req:     146208
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  396)     { call_site: [ffffffffa029070e] drm_vma_node_allow [drm]                      } hitcount:       1746  bytes_req:      69840
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  397)     { call_site: [ffffffffa045e7c4] i915_gem_do_execbuffer.isra.23 [i915]         } hitcount:       2021  bytes_req:     792312
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  398)     { call_site: [ffffffffa02911f2] drm_modeset_lock_crtc [drm]                   } hitcount:       2592  bytes_req:     145152
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  399)     { call_site: [ffffffffa0489a66] intel_ring_begin [i915]                       } hitcount:       2629  bytes_req:     378576
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  400)     { call_site: [ffffffffa046041c] i915_gem_execbuffer2 [i915]                   } hitcount:       2629  bytes_req:    3783248
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  401)     { call_site: [ffffffff81325607] apparmor_file_alloc_security                  } hitcount:       5192  bytes_req:      10384
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  402)     { call_site: [ffffffffa00b7c06] hid_report_raw_event [hid]                    } hitcount:       5529  bytes_req:     110584
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  403)     { call_site: [ffffffff8131ebf7] aa_alloc_task_context                         } hitcount:      21943  bytes_req:     702176
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  404)     { call_site: [ffffffff8125847d] ext4_htree_store_dirent                       } hitcount:      55759  bytes_req:    5074265
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  405) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  406)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  407)         Hits: 109928
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  408)         Entries: 71
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  409)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  410) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  411)   Because the default sort key above is 'hitcount', the above shows a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  412)   the list of call_sites by increasing hitcount, so that at the bottom
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  413)   we see the functions that made the most kmalloc calls during the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  414)   run.  If instead we we wanted to see the top kmalloc callers in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  415)   terms of the number of bytes requested rather than the number of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  416)   calls, and we wanted the top caller to appear at the top, we can use
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  417)   the 'sort' parameter, along with the 'descending' modifier::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  418) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  419)     # echo 'hist:key=call_site.sym:val=bytes_req:sort=bytes_req.descending' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  420)            /sys/kernel/debug/tracing/events/kmem/kmalloc/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  421) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  422)     # cat /sys/kernel/debug/tracing/events/kmem/kmalloc/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  423)     # trigger info: hist:keys=call_site.sym:vals=bytes_req:sort=bytes_req.descending:size=2048 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  424) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  425)     { call_site: [ffffffffa046041c] i915_gem_execbuffer2 [i915]                   } hitcount:       2186  bytes_req:    3397464
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  426)     { call_site: [ffffffffa045e7c4] i915_gem_do_execbuffer.isra.23 [i915]         } hitcount:       1790  bytes_req:     712176
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  427)     { call_site: [ffffffff8125847d] ext4_htree_store_dirent                       } hitcount:       8132  bytes_req:     513135
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  428)     { call_site: [ffffffff811e2a1b] seq_buf_alloc                                 } hitcount:        106  bytes_req:     440128
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  429)     { call_site: [ffffffffa0489a66] intel_ring_begin [i915]                       } hitcount:       2186  bytes_req:     314784
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  430)     { call_site: [ffffffff812891ca] ext4_find_extent                              } hitcount:       2174  bytes_req:     208992
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  431)     { call_site: [ffffffff811ae8e1] __kmalloc                                     } hitcount:          8  bytes_req:     131072
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  432)     { call_site: [ffffffffa04c4a3c] intel_plane_duplicate_state [i915]            } hitcount:        859  bytes_req:     116824
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  433)     { call_site: [ffffffffa02911f2] drm_modeset_lock_crtc [drm]                   } hitcount:       1834  bytes_req:     102704
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  434)     { call_site: [ffffffffa04a580c] intel_crtc_page_flip [i915]                   } hitcount:        972  bytes_req:     101088
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  435)     { call_site: [ffffffffa0287592] drm_mode_page_flip_ioctl [drm]                } hitcount:        972  bytes_req:      85536
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  436)     { call_site: [ffffffffa00b7c06] hid_report_raw_event [hid]                    } hitcount:       3333  bytes_req:      66664
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  437)     { call_site: [ffffffff8137e559] sg_kmalloc                                    } hitcount:        209  bytes_req:      61632
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  438)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  439)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  440)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  441)     { call_site: [ffffffff81095225] alloc_fair_sched_group                        } hitcount:          2  bytes_req:        128
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  442)     { call_site: [ffffffff81097ec2] alloc_rt_sched_group                          } hitcount:          2  bytes_req:        128
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  443)     { call_site: [ffffffff812d8406] copy_semundo                                  } hitcount:          2  bytes_req:         48
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  444)     { call_site: [ffffffff81200ba6] inotify_new_group                             } hitcount:          1  bytes_req:         48
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  445)     { call_site: [ffffffffa027121a] drm_getmagic [drm]                            } hitcount:          1  bytes_req:         48
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  446)     { call_site: [ffffffff811e3a25] __seq_open_private                            } hitcount:          1  bytes_req:         40
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  447)     { call_site: [ffffffff811c52f4] bprm_change_interp                            } hitcount:          2  bytes_req:         16
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  448)     { call_site: [ffffffff8154bc62] usb_control_msg                               } hitcount:          1  bytes_req:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  449)     { call_site: [ffffffffa00bf1ca] hidraw_report_event [hid]                     } hitcount:          1  bytes_req:          7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  450)     { call_site: [ffffffffa00bf6fe] hidraw_send_report [hid]                      } hitcount:          1  bytes_req:          7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  451) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  452)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  453)         Hits: 32133
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  454)         Entries: 81
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  455)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  456) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  457)   To display the offset and size information in addition to the symbol
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  458)   name, just use 'sym-offset' instead::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  459) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  460)     # echo 'hist:key=call_site.sym-offset:val=bytes_req:sort=bytes_req.descending' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  461)            /sys/kernel/debug/tracing/events/kmem/kmalloc/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  462) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  463)     # cat /sys/kernel/debug/tracing/events/kmem/kmalloc/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  464)     # trigger info: hist:keys=call_site.sym-offset:vals=bytes_req:sort=bytes_req.descending:size=2048 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  465) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  466)     { call_site: [ffffffffa046041c] i915_gem_execbuffer2+0x6c/0x2c0 [i915]                  } hitcount:       4569  bytes_req:    3163720
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  467)     { call_site: [ffffffffa0489a66] intel_ring_begin+0xc6/0x1f0 [i915]                      } hitcount:       4569  bytes_req:     657936
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  468)     { call_site: [ffffffffa045e7c4] i915_gem_do_execbuffer.isra.23+0x694/0x1020 [i915]      } hitcount:       1519  bytes_req:     472936
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  469)     { call_site: [ffffffffa045e646] i915_gem_do_execbuffer.isra.23+0x516/0x1020 [i915]      } hitcount:       3050  bytes_req:     211832
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  470)     { call_site: [ffffffff811e2a1b] seq_buf_alloc+0x1b/0x50                                 } hitcount:         34  bytes_req:     148384
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  471)     { call_site: [ffffffffa04a580c] intel_crtc_page_flip+0xbc/0x870 [i915]                  } hitcount:       1385  bytes_req:     144040
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  472)     { call_site: [ffffffff811ae8e1] __kmalloc+0x191/0x1b0                                   } hitcount:          8  bytes_req:     131072
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  473)     { call_site: [ffffffffa0287592] drm_mode_page_flip_ioctl+0x282/0x360 [drm]              } hitcount:       1385  bytes_req:     121880
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  474)     { call_site: [ffffffffa02911f2] drm_modeset_lock_crtc+0x32/0x100 [drm]                  } hitcount:       1848  bytes_req:     103488
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  475)     { call_site: [ffffffffa04c4a3c] intel_plane_duplicate_state+0x2c/0xa0 [i915]            } hitcount:        461  bytes_req:      62696
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  476)     { call_site: [ffffffffa029070e] drm_vma_node_allow+0x2e/0xd0 [drm]                      } hitcount:       1541  bytes_req:      61640
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  477)     { call_site: [ffffffff815f8d7b] sk_prot_alloc+0xcb/0x1b0                                } hitcount:         57  bytes_req:      57456
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  478)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  479)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  480)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  481)     { call_site: [ffffffff8109524a] alloc_fair_sched_group+0x5a/0x1a0                       } hitcount:          2  bytes_req:        128
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  482)     { call_site: [ffffffffa027b921] drm_vm_open_locked+0x31/0xa0 [drm]                      } hitcount:          3  bytes_req:         96
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  483)     { call_site: [ffffffff8122e266] proc_self_follow_link+0x76/0xb0                         } hitcount:          8  bytes_req:         96
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  484)     { call_site: [ffffffff81213e80] load_elf_binary+0x240/0x1650                            } hitcount:          3  bytes_req:         84
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  485)     { call_site: [ffffffff8154bc62] usb_control_msg+0x42/0x110                              } hitcount:          1  bytes_req:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  486)     { call_site: [ffffffffa00bf6fe] hidraw_send_report+0x7e/0x1a0 [hid]                     } hitcount:          1  bytes_req:          7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  487)     { call_site: [ffffffffa00bf1ca] hidraw_report_event+0x8a/0x120 [hid]                    } hitcount:          1  bytes_req:          7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  488) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  489)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  490)         Hits: 26098
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  491)         Entries: 64
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  492)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  493) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  494)   We can also add multiple fields to the 'values' parameter.  For
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  495)   example, we might want to see the total number of bytes allocated
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  496)   alongside bytes requested, and display the result sorted by bytes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  497)   allocated in a descending order::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  498) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  499)     # echo 'hist:keys=call_site.sym:values=bytes_req,bytes_alloc:sort=bytes_alloc.descending' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  500)            /sys/kernel/debug/tracing/events/kmem/kmalloc/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  501) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  502)     # cat /sys/kernel/debug/tracing/events/kmem/kmalloc/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  503)     # trigger info: hist:keys=call_site.sym:vals=bytes_req,bytes_alloc:sort=bytes_alloc.descending:size=2048 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  504) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  505)     { call_site: [ffffffffa046041c] i915_gem_execbuffer2 [i915]                   } hitcount:       7403  bytes_req:    4084360  bytes_alloc:    5958016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  506)     { call_site: [ffffffff811e2a1b] seq_buf_alloc                                 } hitcount:        541  bytes_req:    2213968  bytes_alloc:    2228224
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  507)     { call_site: [ffffffffa0489a66] intel_ring_begin [i915]                       } hitcount:       7404  bytes_req:    1066176  bytes_alloc:    1421568
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  508)     { call_site: [ffffffffa045e7c4] i915_gem_do_execbuffer.isra.23 [i915]         } hitcount:       1565  bytes_req:     557368  bytes_alloc:    1037760
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  509)     { call_site: [ffffffff8125847d] ext4_htree_store_dirent                       } hitcount:       9557  bytes_req:     595778  bytes_alloc:     695744
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  510)     { call_site: [ffffffffa045e646] i915_gem_do_execbuffer.isra.23 [i915]         } hitcount:       5839  bytes_req:     430680  bytes_alloc:     470400
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  511)     { call_site: [ffffffffa04c4a3c] intel_plane_duplicate_state [i915]            } hitcount:       2388  bytes_req:     324768  bytes_alloc:     458496
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  512)     { call_site: [ffffffffa02911f2] drm_modeset_lock_crtc [drm]                   } hitcount:       3911  bytes_req:     219016  bytes_alloc:     250304
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  513)     { call_site: [ffffffff815f8d7b] sk_prot_alloc                                 } hitcount:        235  bytes_req:     236880  bytes_alloc:     240640
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  514)     { call_site: [ffffffff8137e559] sg_kmalloc                                    } hitcount:        557  bytes_req:     169024  bytes_alloc:     221760
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  515)     { call_site: [ffffffffa00b7c06] hid_report_raw_event [hid]                    } hitcount:       9378  bytes_req:     187548  bytes_alloc:     206312
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  516)     { call_site: [ffffffffa04a580c] intel_crtc_page_flip [i915]                   } hitcount:       1519  bytes_req:     157976  bytes_alloc:     194432
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  517)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  518)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  519)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  520)     { call_site: [ffffffff8109bd3b] sched_autogroup_create_attach                 } hitcount:          2  bytes_req:        144  bytes_alloc:        192
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  521)     { call_site: [ffffffff81097ee8] alloc_rt_sched_group                          } hitcount:          2  bytes_req:        128  bytes_alloc:        128
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  522)     { call_site: [ffffffff8109524a] alloc_fair_sched_group                        } hitcount:          2  bytes_req:        128  bytes_alloc:        128
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  523)     { call_site: [ffffffff81095225] alloc_fair_sched_group                        } hitcount:          2  bytes_req:        128  bytes_alloc:        128
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  524)     { call_site: [ffffffff81097ec2] alloc_rt_sched_group                          } hitcount:          2  bytes_req:        128  bytes_alloc:        128
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  525)     { call_site: [ffffffff81213e80] load_elf_binary                               } hitcount:          3  bytes_req:         84  bytes_alloc:         96
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  526)     { call_site: [ffffffff81079a2e] kthread_create_on_node                        } hitcount:          1  bytes_req:         56  bytes_alloc:         64
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  527)     { call_site: [ffffffffa00bf6fe] hidraw_send_report [hid]                      } hitcount:          1  bytes_req:          7  bytes_alloc:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  528)     { call_site: [ffffffff8154bc62] usb_control_msg                               } hitcount:          1  bytes_req:          8  bytes_alloc:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  529)     { call_site: [ffffffffa00bf1ca] hidraw_report_event [hid]                     } hitcount:          1  bytes_req:          7  bytes_alloc:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  530) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  531)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  532)         Hits: 66598
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  533)         Entries: 65
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  534)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  535) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  536)   Finally, to finish off our kmalloc example, instead of simply having
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  537)   the hist trigger display symbolic call_sites, we can have the hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  538)   trigger additionally display the complete set of kernel stack traces
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  539)   that led to each call_site.  To do that, we simply use the special
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  540)   value 'stacktrace' for the key parameter::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  541) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  542)     # echo 'hist:keys=stacktrace:values=bytes_req,bytes_alloc:sort=bytes_alloc' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  543)            /sys/kernel/debug/tracing/events/kmem/kmalloc/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  544) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  545)   The above trigger will use the kernel stack trace in effect when an
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  546)   event is triggered as the key for the hash table.  This allows the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  547)   enumeration of every kernel callpath that led up to a particular
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  548)   event, along with a running total of any of the event fields for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  549)   that event.  Here we tally bytes requested and bytes allocated for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  550)   every callpath in the system that led up to a kmalloc (in this case
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  551)   every callpath to a kmalloc for a kernel compile)::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  552) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  553)     # cat /sys/kernel/debug/tracing/events/kmem/kmalloc/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  554)     # trigger info: hist:keys=stacktrace:vals=bytes_req,bytes_alloc:sort=bytes_alloc:size=2048 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  555) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  556)     { stacktrace:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  557)          __kmalloc_track_caller+0x10b/0x1a0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  558)          kmemdup+0x20/0x50
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  559)          hidraw_report_event+0x8a/0x120 [hid]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  560)          hid_report_raw_event+0x3ea/0x440 [hid]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  561)          hid_input_report+0x112/0x190 [hid]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  562)          hid_irq_in+0xc2/0x260 [usbhid]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  563)          __usb_hcd_giveback_urb+0x72/0x120
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  564)          usb_giveback_urb_bh+0x9e/0xe0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  565)          tasklet_hi_action+0xf8/0x100
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  566)          __do_softirq+0x114/0x2c0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  567)          irq_exit+0xa5/0xb0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  568)          do_IRQ+0x5a/0xf0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  569)          ret_from_intr+0x0/0x30
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  570)          cpuidle_enter+0x17/0x20
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  571)          cpu_startup_entry+0x315/0x3e0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  572)          rest_init+0x7c/0x80
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  573)     } hitcount:          3  bytes_req:         21  bytes_alloc:         24
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  574)     { stacktrace:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  575)          __kmalloc_track_caller+0x10b/0x1a0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  576)          kmemdup+0x20/0x50
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  577)          hidraw_report_event+0x8a/0x120 [hid]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  578)          hid_report_raw_event+0x3ea/0x440 [hid]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  579)          hid_input_report+0x112/0x190 [hid]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  580)          hid_irq_in+0xc2/0x260 [usbhid]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  581)          __usb_hcd_giveback_urb+0x72/0x120
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  582)          usb_giveback_urb_bh+0x9e/0xe0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  583)          tasklet_hi_action+0xf8/0x100
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  584)          __do_softirq+0x114/0x2c0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  585)          irq_exit+0xa5/0xb0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  586)          do_IRQ+0x5a/0xf0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  587)          ret_from_intr+0x0/0x30
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  588)     } hitcount:          3  bytes_req:         21  bytes_alloc:         24
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  589)     { stacktrace:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  590)          kmem_cache_alloc_trace+0xeb/0x150
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  591)          aa_alloc_task_context+0x27/0x40
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  592)          apparmor_cred_prepare+0x1f/0x50
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  593)          security_prepare_creds+0x16/0x20
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  594)          prepare_creds+0xdf/0x1a0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  595)          SyS_capset+0xb5/0x200
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  596)          system_call_fastpath+0x12/0x6a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  597)     } hitcount:          1  bytes_req:         32  bytes_alloc:         32
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  598)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  599)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  600)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  601)     { stacktrace:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  602)          __kmalloc+0x11b/0x1b0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  603)          i915_gem_execbuffer2+0x6c/0x2c0 [i915]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  604)          drm_ioctl+0x349/0x670 [drm]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  605)          do_vfs_ioctl+0x2f0/0x4f0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  606)          SyS_ioctl+0x81/0xa0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  607)          system_call_fastpath+0x12/0x6a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  608)     } hitcount:      17726  bytes_req:   13944120  bytes_alloc:   19593808
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  609)     { stacktrace:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  610)          __kmalloc+0x11b/0x1b0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  611)          load_elf_phdrs+0x76/0xa0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  612)          load_elf_binary+0x102/0x1650
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  613)          search_binary_handler+0x97/0x1d0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  614)          do_execveat_common.isra.34+0x551/0x6e0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  615)          SyS_execve+0x3a/0x50
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  616)          return_from_execve+0x0/0x23
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  617)     } hitcount:      33348  bytes_req:   17152128  bytes_alloc:   20226048
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  618)     { stacktrace:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  619)          kmem_cache_alloc_trace+0xeb/0x150
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  620)          apparmor_file_alloc_security+0x27/0x40
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  621)          security_file_alloc+0x16/0x20
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  622)          get_empty_filp+0x93/0x1c0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  623)          path_openat+0x31/0x5f0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  624)          do_filp_open+0x3a/0x90
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  625)          do_sys_open+0x128/0x220
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  626)          SyS_open+0x1e/0x20
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  627)          system_call_fastpath+0x12/0x6a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  628)     } hitcount:    4766422  bytes_req:    9532844  bytes_alloc:   38131376
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  629)     { stacktrace:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  630)          __kmalloc+0x11b/0x1b0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  631)          seq_buf_alloc+0x1b/0x50
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  632)          seq_read+0x2cc/0x370
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  633)          proc_reg_read+0x3d/0x80
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  634)          __vfs_read+0x28/0xe0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  635)          vfs_read+0x86/0x140
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  636)          SyS_read+0x46/0xb0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  637)          system_call_fastpath+0x12/0x6a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  638)     } hitcount:      19133  bytes_req:   78368768  bytes_alloc:   78368768
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  639) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  640)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  641)         Hits: 6085872
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  642)         Entries: 253
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  643)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  644) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  645)   If you key a hist trigger on common_pid, in order for example to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  646)   gather and display sorted totals for each process, you can use the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  647)   special .execname modifier to display the executable names for the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  648)   processes in the table rather than raw pids.  The example below
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  649)   keeps a per-process sum of total bytes read::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  650) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  651)     # echo 'hist:key=common_pid.execname:val=count:sort=count.descending' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  652)            /sys/kernel/debug/tracing/events/syscalls/sys_enter_read/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  653) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  654)     # cat /sys/kernel/debug/tracing/events/syscalls/sys_enter_read/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  655)     # trigger info: hist:keys=common_pid.execname:vals=count:sort=count.descending:size=2048 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  656) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  657)     { common_pid: gnome-terminal  [      3196] } hitcount:        280  count:    1093512
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  658)     { common_pid: Xorg            [      1309] } hitcount:        525  count:     256640
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  659)     { common_pid: compiz          [      2889] } hitcount:         59  count:     254400
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  660)     { common_pid: bash            [      8710] } hitcount:          3  count:      66369
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  661)     { common_pid: dbus-daemon-lau [      8703] } hitcount:         49  count:      47739
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  662)     { common_pid: irqbalance      [      1252] } hitcount:         27  count:      27648
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  663)     { common_pid: 01ifupdown      [      8705] } hitcount:          3  count:      17216
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  664)     { common_pid: dbus-daemon     [       772] } hitcount:         10  count:      12396
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  665)     { common_pid: Socket Thread   [      8342] } hitcount:         11  count:      11264
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  666)     { common_pid: nm-dhcp-client. [      8701] } hitcount:          6  count:       7424
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  667)     { common_pid: gmain           [      1315] } hitcount:         18  count:       6336
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  668)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  669)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  670)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  671)     { common_pid: postgres        [      1892] } hitcount:          2  count:         32
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  672)     { common_pid: postgres        [      1891] } hitcount:          2  count:         32
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  673)     { common_pid: gmain           [      8704] } hitcount:          2  count:         32
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  674)     { common_pid: upstart-dbus-br [      2740] } hitcount:         21  count:         21
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  675)     { common_pid: nm-dispatcher.a [      8696] } hitcount:          1  count:         16
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  676)     { common_pid: indicator-datet [      2904] } hitcount:          1  count:         16
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  677)     { common_pid: gdbus           [      2998] } hitcount:          1  count:         16
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  678)     { common_pid: rtkit-daemon    [      2052] } hitcount:          1  count:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  679)     { common_pid: init            [         1] } hitcount:          2  count:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  680) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  681)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  682)         Hits: 2116
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  683)         Entries: 51
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  684)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  685) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  686)   Similarly, if you key a hist trigger on syscall id, for example to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  687)   gather and display a list of systemwide syscall hits, you can use
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  688)   the special .syscall modifier to display the syscall names rather
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  689)   than raw ids.  The example below keeps a running total of syscall
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  690)   counts for the system during the run::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  691) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  692)     # echo 'hist:key=id.syscall:val=hitcount' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  693)            /sys/kernel/debug/tracing/events/raw_syscalls/sys_enter/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  694) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  695)     # cat /sys/kernel/debug/tracing/events/raw_syscalls/sys_enter/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  696)     # trigger info: hist:keys=id.syscall:vals=hitcount:sort=hitcount:size=2048 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  697) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  698)     { id: sys_fsync                     [ 74] } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  699)     { id: sys_newuname                  [ 63] } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  700)     { id: sys_prctl                     [157] } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  701)     { id: sys_statfs                    [137] } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  702)     { id: sys_symlink                   [ 88] } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  703)     { id: sys_sendmmsg                  [307] } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  704)     { id: sys_semctl                    [ 66] } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  705)     { id: sys_readlink                  [ 89] } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  706)     { id: sys_bind                      [ 49] } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  707)     { id: sys_getsockname               [ 51] } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  708)     { id: sys_unlink                    [ 87] } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  709)     { id: sys_rename                    [ 82] } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  710)     { id: unknown_syscall               [ 58] } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  711)     { id: sys_connect                   [ 42] } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  712)     { id: sys_getpid                    [ 39] } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  713)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  714)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  715)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  716)     { id: sys_rt_sigprocmask            [ 14] } hitcount:        952
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  717)     { id: sys_futex                     [202] } hitcount:       1534
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  718)     { id: sys_write                     [  1] } hitcount:       2689
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  719)     { id: sys_setitimer                 [ 38] } hitcount:       2797
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  720)     { id: sys_read                      [  0] } hitcount:       3202
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  721)     { id: sys_select                    [ 23] } hitcount:       3773
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  722)     { id: sys_writev                    [ 20] } hitcount:       4531
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  723)     { id: sys_poll                      [  7] } hitcount:       8314
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  724)     { id: sys_recvmsg                   [ 47] } hitcount:      13738
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  725)     { id: sys_ioctl                     [ 16] } hitcount:      21843
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  726) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  727)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  728)         Hits: 67612
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  729)         Entries: 72
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  730)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  731) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  732)   The syscall counts above provide a rough overall picture of system
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  733)   call activity on the system; we can see for example that the most
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  734)   popular system call on this system was the 'sys_ioctl' system call.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  735) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  736)   We can use 'compound' keys to refine that number and provide some
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  737)   further insight as to which processes exactly contribute to the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  738)   overall ioctl count.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  739) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  740)   The command below keeps a hitcount for every unique combination of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  741)   system call id and pid - the end result is essentially a table
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  742)   that keeps a per-pid sum of system call hits.  The results are
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  743)   sorted using the system call id as the primary key, and the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  744)   hitcount sum as the secondary key::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  745) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  746)     # echo 'hist:key=id.syscall,common_pid.execname:val=hitcount:sort=id,hitcount' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  747)            /sys/kernel/debug/tracing/events/raw_syscalls/sys_enter/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  748) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  749)     # cat /sys/kernel/debug/tracing/events/raw_syscalls/sys_enter/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  750)     # trigger info: hist:keys=id.syscall,common_pid.execname:vals=hitcount:sort=id.syscall,hitcount:size=2048 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  751) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  752)     { id: sys_read                      [  0], common_pid: rtkit-daemon    [      1877] } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  753)     { id: sys_read                      [  0], common_pid: gdbus           [      2976] } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  754)     { id: sys_read                      [  0], common_pid: console-kit-dae [      3400] } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  755)     { id: sys_read                      [  0], common_pid: postgres        [      1865] } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  756)     { id: sys_read                      [  0], common_pid: deja-dup-monito [      3543] } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  757)     { id: sys_read                      [  0], common_pid: NetworkManager  [       890] } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  758)     { id: sys_read                      [  0], common_pid: evolution-calen [      3048] } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  759)     { id: sys_read                      [  0], common_pid: postgres        [      1864] } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  760)     { id: sys_read                      [  0], common_pid: nm-applet       [      3022] } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  761)     { id: sys_read                      [  0], common_pid: whoopsie        [      1212] } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  762)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  763)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  764)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  765)     { id: sys_ioctl                     [ 16], common_pid: bash            [      8479] } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  766)     { id: sys_ioctl                     [ 16], common_pid: bash            [      3472] } hitcount:         12
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  767)     { id: sys_ioctl                     [ 16], common_pid: gnome-terminal  [      3199] } hitcount:         16
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  768)     { id: sys_ioctl                     [ 16], common_pid: Xorg            [      1267] } hitcount:       1808
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  769)     { id: sys_ioctl                     [ 16], common_pid: compiz          [      2994] } hitcount:       5580
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  770)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  771)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  772)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  773)     { id: sys_waitid                    [247], common_pid: upstart-dbus-br [      2690] } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  774)     { id: sys_waitid                    [247], common_pid: upstart-dbus-br [      2688] } hitcount:         16
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  775)     { id: sys_inotify_add_watch         [254], common_pid: gmain           [       975] } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  776)     { id: sys_inotify_add_watch         [254], common_pid: gmain           [      3204] } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  777)     { id: sys_inotify_add_watch         [254], common_pid: gmain           [      2888] } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  778)     { id: sys_inotify_add_watch         [254], common_pid: gmain           [      3003] } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  779)     { id: sys_inotify_add_watch         [254], common_pid: gmain           [      2873] } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  780)     { id: sys_inotify_add_watch         [254], common_pid: gmain           [      3196] } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  781)     { id: sys_openat                    [257], common_pid: java            [      2623] } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  782)     { id: sys_eventfd2                  [290], common_pid: ibus-ui-gtk3    [      2760] } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  783)     { id: sys_eventfd2                  [290], common_pid: compiz          [      2994] } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  784) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  785)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  786)         Hits: 31536
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  787)         Entries: 323
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  788)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  789) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  790)   The above list does give us a breakdown of the ioctl syscall by
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  791)   pid, but it also gives us quite a bit more than that, which we
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  792)   don't really care about at the moment.  Since we know the syscall
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  793)   id for sys_ioctl (16, displayed next to the sys_ioctl name), we
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  794)   can use that to filter out all the other syscalls::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  795) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  796)     # echo 'hist:key=id.syscall,common_pid.execname:val=hitcount:sort=id,hitcount if id == 16' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  797)            /sys/kernel/debug/tracing/events/raw_syscalls/sys_enter/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  798) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  799)     # cat /sys/kernel/debug/tracing/events/raw_syscalls/sys_enter/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  800)     # trigger info: hist:keys=id.syscall,common_pid.execname:vals=hitcount:sort=id.syscall,hitcount:size=2048 if id == 16 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  801) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  802)     { id: sys_ioctl                     [ 16], common_pid: gmain           [      2769] } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  803)     { id: sys_ioctl                     [ 16], common_pid: evolution-addre [      8571] } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  804)     { id: sys_ioctl                     [ 16], common_pid: gmain           [      3003] } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  805)     { id: sys_ioctl                     [ 16], common_pid: gmain           [      2781] } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  806)     { id: sys_ioctl                     [ 16], common_pid: gmain           [      2829] } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  807)     { id: sys_ioctl                     [ 16], common_pid: bash            [      8726] } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  808)     { id: sys_ioctl                     [ 16], common_pid: bash            [      8508] } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  809)     { id: sys_ioctl                     [ 16], common_pid: gmain           [      2970] } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  810)     { id: sys_ioctl                     [ 16], common_pid: gmain           [      2768] } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  811)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  812)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  813)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  814)     { id: sys_ioctl                     [ 16], common_pid: pool            [      8559] } hitcount:         45
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  815)     { id: sys_ioctl                     [ 16], common_pid: pool            [      8555] } hitcount:         48
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  816)     { id: sys_ioctl                     [ 16], common_pid: pool            [      8551] } hitcount:         48
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  817)     { id: sys_ioctl                     [ 16], common_pid: avahi-daemon    [       896] } hitcount:         66
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  818)     { id: sys_ioctl                     [ 16], common_pid: Xorg            [      1267] } hitcount:      26674
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  819)     { id: sys_ioctl                     [ 16], common_pid: compiz          [      2994] } hitcount:      73443
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  820) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  821)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  822)         Hits: 101162
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  823)         Entries: 103
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  824)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  825) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  826)   The above output shows that 'compiz' and 'Xorg' are far and away
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  827)   the heaviest ioctl callers (which might lead to questions about
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  828)   whether they really need to be making all those calls and to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  829)   possible avenues for further investigation.)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  830) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  831)   The compound key examples used a key and a sum value (hitcount) to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  832)   sort the output, but we can just as easily use two keys instead.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  833)   Here's an example where we use a compound key composed of the the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  834)   common_pid and size event fields.  Sorting with pid as the primary
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  835)   key and 'size' as the secondary key allows us to display an
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  836)   ordered summary of the recvfrom sizes, with counts, received by
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  837)   each process::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  838) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  839)     # echo 'hist:key=common_pid.execname,size:val=hitcount:sort=common_pid,size' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  840)            /sys/kernel/debug/tracing/events/syscalls/sys_enter_recvfrom/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  841) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  842)     # cat /sys/kernel/debug/tracing/events/syscalls/sys_enter_recvfrom/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  843)     # trigger info: hist:keys=common_pid.execname,size:vals=hitcount:sort=common_pid.execname,size:size=2048 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  844) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  845)     { common_pid: smbd            [       784], size:          4 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  846)     { common_pid: dnsmasq         [      1412], size:       4096 } hitcount:        672
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  847)     { common_pid: postgres        [      1796], size:       1000 } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  848)     { common_pid: postgres        [      1867], size:       1000 } hitcount:         10
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  849)     { common_pid: bamfdaemon      [      2787], size:         28 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  850)     { common_pid: bamfdaemon      [      2787], size:      14360 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  851)     { common_pid: compiz          [      2994], size:          8 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  852)     { common_pid: compiz          [      2994], size:         20 } hitcount:         11
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  853)     { common_pid: gnome-terminal  [      3199], size:          4 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  854)     { common_pid: firefox         [      8817], size:          4 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  855)     { common_pid: firefox         [      8817], size:          8 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  856)     { common_pid: firefox         [      8817], size:        588 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  857)     { common_pid: firefox         [      8817], size:        628 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  858)     { common_pid: firefox         [      8817], size:       6944 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  859)     { common_pid: firefox         [      8817], size:     408880 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  860)     { common_pid: firefox         [      8822], size:          8 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  861)     { common_pid: firefox         [      8822], size:        160 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  862)     { common_pid: firefox         [      8822], size:        320 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  863)     { common_pid: firefox         [      8822], size:        352 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  864)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  865)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  866)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  867)     { common_pid: pool            [      8923], size:       1960 } hitcount:         10
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  868)     { common_pid: pool            [      8923], size:       2048 } hitcount:         10
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  869)     { common_pid: pool            [      8924], size:       1960 } hitcount:         10
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  870)     { common_pid: pool            [      8924], size:       2048 } hitcount:         10
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  871)     { common_pid: pool            [      8928], size:       1964 } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  872)     { common_pid: pool            [      8928], size:       1965 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  873)     { common_pid: pool            [      8928], size:       2048 } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  874)     { common_pid: pool            [      8929], size:       1982 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  875)     { common_pid: pool            [      8929], size:       2048 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  876) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  877)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  878)         Hits: 2016
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  879)         Entries: 224
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  880)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  881) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  882)   The above example also illustrates the fact that although a compound
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  883)   key is treated as a single entity for hashing purposes, the sub-keys
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  884)   it's composed of can be accessed independently.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  885) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  886)   The next example uses a string field as the hash key and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  887)   demonstrates how you can manually pause and continue a hist trigger.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  888)   In this example, we'll aggregate fork counts and don't expect a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  889)   large number of entries in the hash table, so we'll drop it to a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  890)   much smaller number, say 256::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  891) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  892)     # echo 'hist:key=child_comm:val=hitcount:size=256' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  893)            /sys/kernel/debug/tracing/events/sched/sched_process_fork/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  894) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  895)     # cat /sys/kernel/debug/tracing/events/sched/sched_process_fork/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  896)     # trigger info: hist:keys=child_comm:vals=hitcount:sort=hitcount:size=256 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  897) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  898)     { child_comm: dconf worker                        } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  899)     { child_comm: ibus-daemon                         } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  900)     { child_comm: whoopsie                            } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  901)     { child_comm: smbd                                } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  902)     { child_comm: gdbus                               } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  903)     { child_comm: kthreadd                            } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  904)     { child_comm: dconf worker                        } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  905)     { child_comm: evolution-alarm                     } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  906)     { child_comm: Socket Thread                       } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  907)     { child_comm: postgres                            } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  908)     { child_comm: bash                                } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  909)     { child_comm: compiz                              } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  910)     { child_comm: evolution-sourc                     } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  911)     { child_comm: dhclient                            } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  912)     { child_comm: pool                                } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  913)     { child_comm: nm-dispatcher.a                     } hitcount:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  914)     { child_comm: firefox                             } hitcount:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  915)     { child_comm: dbus-daemon                         } hitcount:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  916)     { child_comm: glib-pacrunner                      } hitcount:         10
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  917)     { child_comm: evolution                           } hitcount:         23
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  918) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  919)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  920)         Hits: 89
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  921)         Entries: 20
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  922)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  923) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  924)   If we want to pause the hist trigger, we can simply append :pause to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  925)   the command that started the trigger.  Notice that the trigger info
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  926)   displays as [paused]::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  927) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  928)     # echo 'hist:key=child_comm:val=hitcount:size=256:pause' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  929)            /sys/kernel/debug/tracing/events/sched/sched_process_fork/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  930) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  931)     # cat /sys/kernel/debug/tracing/events/sched/sched_process_fork/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  932)     # trigger info: hist:keys=child_comm:vals=hitcount:sort=hitcount:size=256 [paused]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  933) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  934)     { child_comm: dconf worker                        } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  935)     { child_comm: kthreadd                            } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  936)     { child_comm: dconf worker                        } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  937)     { child_comm: gdbus                               } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  938)     { child_comm: ibus-daemon                         } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  939)     { child_comm: Socket Thread                       } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  940)     { child_comm: evolution-alarm                     } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  941)     { child_comm: smbd                                } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  942)     { child_comm: bash                                } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  943)     { child_comm: whoopsie                            } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  944)     { child_comm: compiz                              } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  945)     { child_comm: evolution-sourc                     } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  946)     { child_comm: pool                                } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  947)     { child_comm: postgres                            } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  948)     { child_comm: firefox                             } hitcount:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  949)     { child_comm: dhclient                            } hitcount:         10
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  950)     { child_comm: emacs                               } hitcount:         12
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  951)     { child_comm: dbus-daemon                         } hitcount:         20
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  952)     { child_comm: nm-dispatcher.a                     } hitcount:         20
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  953)     { child_comm: evolution                           } hitcount:         35
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  954)     { child_comm: glib-pacrunner                      } hitcount:         59
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  955) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  956)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  957)         Hits: 199
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  958)         Entries: 21
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  959)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  960) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  961)   To manually continue having the trigger aggregate events, append
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  962)   :cont instead.  Notice that the trigger info displays as [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  963)   again, and the data has changed::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  964) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  965)     # echo 'hist:key=child_comm:val=hitcount:size=256:cont' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  966)            /sys/kernel/debug/tracing/events/sched/sched_process_fork/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  967) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  968)     # cat /sys/kernel/debug/tracing/events/sched/sched_process_fork/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  969)     # trigger info: hist:keys=child_comm:vals=hitcount:sort=hitcount:size=256 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  970) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  971)     { child_comm: dconf worker                        } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  972)     { child_comm: dconf worker                        } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  973)     { child_comm: kthreadd                            } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  974)     { child_comm: gdbus                               } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  975)     { child_comm: ibus-daemon                         } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  976)     { child_comm: Socket Thread                       } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  977)     { child_comm: evolution-alarm                     } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  978)     { child_comm: smbd                                } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  979)     { child_comm: whoopsie                            } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  980)     { child_comm: compiz                              } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  981)     { child_comm: evolution-sourc                     } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  982)     { child_comm: bash                                } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  983)     { child_comm: pool                                } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  984)     { child_comm: postgres                            } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  985)     { child_comm: firefox                             } hitcount:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  986)     { child_comm: dhclient                            } hitcount:         11
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  987)     { child_comm: emacs                               } hitcount:         12
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  988)     { child_comm: dbus-daemon                         } hitcount:         22
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  989)     { child_comm: nm-dispatcher.a                     } hitcount:         22
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  990)     { child_comm: evolution                           } hitcount:         35
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  991)     { child_comm: glib-pacrunner                      } hitcount:         59
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  992) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  993)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  994)         Hits: 206
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  995)         Entries: 21
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  996)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  997) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  998)   The previous example showed how to start and stop a hist trigger by
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  999)   appending 'pause' and 'continue' to the hist trigger command.  A
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1000)   hist trigger can also be started in a paused state by initially
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1001)   starting the trigger with ':pause' appended.  This allows you to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1002)   start the trigger only when you're ready to start collecting data
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1003)   and not before.  For example, you could start the trigger in a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1004)   paused state, then unpause it and do something you want to measure,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1005)   then pause the trigger again when done.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1006) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1007)   Of course, doing this manually can be difficult and error-prone, but
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1008)   it is possible to automatically start and stop a hist trigger based
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1009)   on some condition, via the enable_hist and disable_hist triggers.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1010) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1011)   For example, suppose we wanted to take a look at the relative
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1012)   weights in terms of skb length for each callpath that leads to a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1013)   netif_receive_skb event when downloading a decent-sized file using
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1014)   wget.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1015) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1016)   First we set up an initially paused stacktrace trigger on the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1017)   netif_receive_skb event::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1018) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1019)     # echo 'hist:key=stacktrace:vals=len:pause' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1020)            /sys/kernel/debug/tracing/events/net/netif_receive_skb/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1021) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1022)   Next, we set up an 'enable_hist' trigger on the sched_process_exec
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1023)   event, with an 'if filename==/usr/bin/wget' filter.  The effect of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1024)   this new trigger is that it will 'unpause' the hist trigger we just
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1025)   set up on netif_receive_skb if and only if it sees a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1026)   sched_process_exec event with a filename of '/usr/bin/wget'.  When
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1027)   that happens, all netif_receive_skb events are aggregated into a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1028)   hash table keyed on stacktrace::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1029) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1030)     # echo 'enable_hist:net:netif_receive_skb if filename==/usr/bin/wget' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1031)            /sys/kernel/debug/tracing/events/sched/sched_process_exec/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1032) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1033)   The aggregation continues until the netif_receive_skb is paused
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1034)   again, which is what the following disable_hist event does by
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1035)   creating a similar setup on the sched_process_exit event, using the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1036)   filter 'comm==wget'::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1037) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1038)     # echo 'disable_hist:net:netif_receive_skb if comm==wget' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1039)            /sys/kernel/debug/tracing/events/sched/sched_process_exit/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1040) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1041)   Whenever a process exits and the comm field of the disable_hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1042)   trigger filter matches 'comm==wget', the netif_receive_skb hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1043)   trigger is disabled.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1044) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1045)   The overall effect is that netif_receive_skb events are aggregated
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1046)   into the hash table for only the duration of the wget.  Executing a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1047)   wget command and then listing the 'hist' file will display the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1048)   output generated by the wget command::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1049) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1050)     $ wget https://www.kernel.org/pub/linux/kernel/v3.x/patch-3.19.xz
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1051) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1052)     # cat /sys/kernel/debug/tracing/events/net/netif_receive_skb/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1053)     # trigger info: hist:keys=stacktrace:vals=len:sort=hitcount:size=2048 [paused]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1054) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1055)     { stacktrace:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1056)          __netif_receive_skb_core+0x46d/0x990
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1057)          __netif_receive_skb+0x18/0x60
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1058)          netif_receive_skb_internal+0x23/0x90
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1059)          napi_gro_receive+0xc8/0x100
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1060)          ieee80211_deliver_skb+0xd6/0x270 [mac80211]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1061)          ieee80211_rx_handlers+0xccf/0x22f0 [mac80211]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1062)          ieee80211_prepare_and_rx_handle+0x4e7/0xc40 [mac80211]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1063)          ieee80211_rx+0x31d/0x900 [mac80211]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1064)          iwlagn_rx_reply_rx+0x3db/0x6f0 [iwldvm]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1065)          iwl_rx_dispatch+0x8e/0xf0 [iwldvm]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1066)          iwl_pcie_irq_handler+0xe3c/0x12f0 [iwlwifi]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1067)          irq_thread_fn+0x20/0x50
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1068)          irq_thread+0x11f/0x150
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1069)          kthread+0xd2/0xf0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1070)          ret_from_fork+0x42/0x70
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1071)     } hitcount:         85  len:      28884
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1072)     { stacktrace:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1073)          __netif_receive_skb_core+0x46d/0x990
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1074)          __netif_receive_skb+0x18/0x60
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1075)          netif_receive_skb_internal+0x23/0x90
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1076)          napi_gro_complete+0xa4/0xe0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1077)          dev_gro_receive+0x23a/0x360
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1078)          napi_gro_receive+0x30/0x100
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1079)          ieee80211_deliver_skb+0xd6/0x270 [mac80211]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1080)          ieee80211_rx_handlers+0xccf/0x22f0 [mac80211]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1081)          ieee80211_prepare_and_rx_handle+0x4e7/0xc40 [mac80211]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1082)          ieee80211_rx+0x31d/0x900 [mac80211]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1083)          iwlagn_rx_reply_rx+0x3db/0x6f0 [iwldvm]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1084)          iwl_rx_dispatch+0x8e/0xf0 [iwldvm]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1085)          iwl_pcie_irq_handler+0xe3c/0x12f0 [iwlwifi]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1086)          irq_thread_fn+0x20/0x50
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1087)          irq_thread+0x11f/0x150
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1088)          kthread+0xd2/0xf0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1089)     } hitcount:         98  len:     664329
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1090)     { stacktrace:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1091)          __netif_receive_skb_core+0x46d/0x990
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1092)          __netif_receive_skb+0x18/0x60
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1093)          process_backlog+0xa8/0x150
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1094)          net_rx_action+0x15d/0x340
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1095)          __do_softirq+0x114/0x2c0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1096)          do_softirq_own_stack+0x1c/0x30
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1097)          do_softirq+0x65/0x70
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1098)          __local_bh_enable_ip+0xb5/0xc0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1099)          ip_finish_output+0x1f4/0x840
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1100)          ip_output+0x6b/0xc0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1101)          ip_local_out_sk+0x31/0x40
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1102)          ip_send_skb+0x1a/0x50
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1103)          udp_send_skb+0x173/0x2a0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1104)          udp_sendmsg+0x2bf/0x9f0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1105)          inet_sendmsg+0x64/0xa0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1106)          sock_sendmsg+0x3d/0x50
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1107)     } hitcount:        115  len:      13030
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1108)     { stacktrace:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1109)          __netif_receive_skb_core+0x46d/0x990
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1110)          __netif_receive_skb+0x18/0x60
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1111)          netif_receive_skb_internal+0x23/0x90
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1112)          napi_gro_complete+0xa4/0xe0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1113)          napi_gro_flush+0x6d/0x90
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1114)          iwl_pcie_irq_handler+0x92a/0x12f0 [iwlwifi]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1115)          irq_thread_fn+0x20/0x50
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1116)          irq_thread+0x11f/0x150
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1117)          kthread+0xd2/0xf0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1118)          ret_from_fork+0x42/0x70
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1119)     } hitcount:        934  len:    5512212
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1120) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1121)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1122)         Hits: 1232
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1123)         Entries: 4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1124)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1125) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1126)   The above shows all the netif_receive_skb callpaths and their total
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1127)   lengths for the duration of the wget command.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1128) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1129)   The 'clear' hist trigger param can be used to clear the hash table.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1130)   Suppose we wanted to try another run of the previous example but
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1131)   this time also wanted to see the complete list of events that went
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1132)   into the histogram.  In order to avoid having to set everything up
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1133)   again, we can just clear the histogram first::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1134) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1135)     # echo 'hist:key=stacktrace:vals=len:clear' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1136)            /sys/kernel/debug/tracing/events/net/netif_receive_skb/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1137) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1138)   Just to verify that it is in fact cleared, here's what we now see in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1139)   the hist file::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1140) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1141)     # cat /sys/kernel/debug/tracing/events/net/netif_receive_skb/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1142)     # trigger info: hist:keys=stacktrace:vals=len:sort=hitcount:size=2048 [paused]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1143) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1144)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1145)         Hits: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1146)         Entries: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1147)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1148) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1149)   Since we want to see the detailed list of every netif_receive_skb
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1150)   event occurring during the new run, which are in fact the same
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1151)   events being aggregated into the hash table, we add some additional
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1152)   'enable_event' events to the triggering sched_process_exec and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1153)   sched_process_exit events as such::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1154) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1155)     # echo 'enable_event:net:netif_receive_skb if filename==/usr/bin/wget' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1156)            /sys/kernel/debug/tracing/events/sched/sched_process_exec/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1157) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1158)     # echo 'disable_event:net:netif_receive_skb if comm==wget' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1159)            /sys/kernel/debug/tracing/events/sched/sched_process_exit/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1160) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1161)   If you read the trigger files for the sched_process_exec and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1162)   sched_process_exit triggers, you should see two triggers for each:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1163)   one enabling/disabling the hist aggregation and the other
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1164)   enabling/disabling the logging of events::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1165) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1166)     # cat /sys/kernel/debug/tracing/events/sched/sched_process_exec/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1167)     enable_event:net:netif_receive_skb:unlimited if filename==/usr/bin/wget
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1168)     enable_hist:net:netif_receive_skb:unlimited if filename==/usr/bin/wget
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1169) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1170)     # cat /sys/kernel/debug/tracing/events/sched/sched_process_exit/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1171)     enable_event:net:netif_receive_skb:unlimited if comm==wget
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1172)     disable_hist:net:netif_receive_skb:unlimited if comm==wget
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1173) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1174)   In other words, whenever either of the sched_process_exec or
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1175)   sched_process_exit events is hit and matches 'wget', it enables or
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1176)   disables both the histogram and the event log, and what you end up
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1177)   with is a hash table and set of events just covering the specified
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1178)   duration.  Run the wget command again::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1179) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1180)     $ wget https://www.kernel.org/pub/linux/kernel/v3.x/patch-3.19.xz
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1181) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1182)   Displaying the 'hist' file should show something similar to what you
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1183)   saw in the last run, but this time you should also see the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1184)   individual events in the trace file::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1185) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1186)     # cat /sys/kernel/debug/tracing/trace
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1187) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1188)     # tracer: nop
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1189)     #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1190)     # entries-in-buffer/entries-written: 183/1426   #P:4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1191)     #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1192)     #                              _-----=> irqs-off
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1193)     #                             / _----=> need-resched
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1194)     #                            | / _---=> hardirq/softirq
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1195)     #                            || / _--=> preempt-depth
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1196)     #                            ||| /     delay
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1197)     #           TASK-PID   CPU#  ||||    TIMESTAMP  FUNCTION
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1198)     #              | |       |   ||||       |         |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1199)                 wget-15108 [000] ..s1 31769.606929: netif_receive_skb: dev=lo skbaddr=ffff88009c353100 len=60
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1200)                 wget-15108 [000] ..s1 31769.606999: netif_receive_skb: dev=lo skbaddr=ffff88009c353200 len=60
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1201)              dnsmasq-1382  [000] ..s1 31769.677652: netif_receive_skb: dev=lo skbaddr=ffff88009c352b00 len=130
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1202)              dnsmasq-1382  [000] ..s1 31769.685917: netif_receive_skb: dev=lo skbaddr=ffff88009c352200 len=138
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1203)     ##### CPU 2 buffer started ####
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1204)       irq/29-iwlwifi-559   [002] ..s. 31772.031529: netif_receive_skb: dev=wlan0 skbaddr=ffff88009d433d00 len=2948
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1205)       irq/29-iwlwifi-559   [002] ..s. 31772.031572: netif_receive_skb: dev=wlan0 skbaddr=ffff88009d432200 len=1500
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1206)       irq/29-iwlwifi-559   [002] ..s. 31772.032196: netif_receive_skb: dev=wlan0 skbaddr=ffff88009d433100 len=2948
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1207)       irq/29-iwlwifi-559   [002] ..s. 31772.032761: netif_receive_skb: dev=wlan0 skbaddr=ffff88009d433000 len=2948
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1208)       irq/29-iwlwifi-559   [002] ..s. 31772.033220: netif_receive_skb: dev=wlan0 skbaddr=ffff88009d432e00 len=1500
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1209)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1210)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1211)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1212) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1213)   The following example demonstrates how multiple hist triggers can be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1214)   attached to a given event.  This capability can be useful for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1215)   creating a set of different summaries derived from the same set of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1216)   events, or for comparing the effects of different filters, among
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1217)   other things::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1218) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1219)     # echo 'hist:keys=skbaddr.hex:vals=len if len < 0' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1220)            /sys/kernel/debug/tracing/events/net/netif_receive_skb/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1221)     # echo 'hist:keys=skbaddr.hex:vals=len if len > 4096' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1222)            /sys/kernel/debug/tracing/events/net/netif_receive_skb/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1223)     # echo 'hist:keys=skbaddr.hex:vals=len if len == 256' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1224)            /sys/kernel/debug/tracing/events/net/netif_receive_skb/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1225)     # echo 'hist:keys=skbaddr.hex:vals=len' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1226)            /sys/kernel/debug/tracing/events/net/netif_receive_skb/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1227)     # echo 'hist:keys=len:vals=common_preempt_count' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1228)            /sys/kernel/debug/tracing/events/net/netif_receive_skb/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1229) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1230)   The above set of commands create four triggers differing only in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1231)   their filters, along with a completely different though fairly
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1232)   nonsensical trigger.  Note that in order to append multiple hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1233)   triggers to the same file, you should use the '>>' operator to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1234)   append them ('>' will also add the new hist trigger, but will remove
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1235)   any existing hist triggers beforehand).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1236) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1237)   Displaying the contents of the 'hist' file for the event shows the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1238)   contents of all five histograms::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1239) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1240)     # cat /sys/kernel/debug/tracing/events/net/netif_receive_skb/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1241) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1242)     # event histogram
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1243)     #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1244)     # trigger info: hist:keys=len:vals=hitcount,common_preempt_count:sort=hitcount:size=2048 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1245)     #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1246) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1247)     { len:        176 } hitcount:          1  common_preempt_count:          0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1248)     { len:        223 } hitcount:          1  common_preempt_count:          0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1249)     { len:       4854 } hitcount:          1  common_preempt_count:          0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1250)     { len:        395 } hitcount:          1  common_preempt_count:          0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1251)     { len:        177 } hitcount:          1  common_preempt_count:          0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1252)     { len:        446 } hitcount:          1  common_preempt_count:          0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1253)     { len:       1601 } hitcount:          1  common_preempt_count:          0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1254)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1255)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1256)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1257)     { len:       1280 } hitcount:         66  common_preempt_count:          0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1258)     { len:        116 } hitcount:         81  common_preempt_count:         40
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1259)     { len:        708 } hitcount:        112  common_preempt_count:          0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1260)     { len:         46 } hitcount:        221  common_preempt_count:          0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1261)     { len:       1264 } hitcount:        458  common_preempt_count:          0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1262) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1263)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1264)         Hits: 1428
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1265)         Entries: 147
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1266)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1267) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1268) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1269)     # event histogram
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1270)     #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1271)     # trigger info: hist:keys=skbaddr.hex:vals=hitcount,len:sort=hitcount:size=2048 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1272)     #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1273) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1274)     { skbaddr: ffff8800baee5e00 } hitcount:          1  len:        130
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1275)     { skbaddr: ffff88005f3d5600 } hitcount:          1  len:       1280
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1276)     { skbaddr: ffff88005f3d4900 } hitcount:          1  len:       1280
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1277)     { skbaddr: ffff88009fed6300 } hitcount:          1  len:        115
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1278)     { skbaddr: ffff88009fe0ad00 } hitcount:          1  len:        115
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1279)     { skbaddr: ffff88008cdb1900 } hitcount:          1  len:         46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1280)     { skbaddr: ffff880064b5ef00 } hitcount:          1  len:        118
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1281)     { skbaddr: ffff880044e3c700 } hitcount:          1  len:         60
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1282)     { skbaddr: ffff880100065900 } hitcount:          1  len:         46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1283)     { skbaddr: ffff8800d46bd500 } hitcount:          1  len:        116
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1284)     { skbaddr: ffff88005f3d5f00 } hitcount:          1  len:       1280
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1285)     { skbaddr: ffff880100064700 } hitcount:          1  len:        365
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1286)     { skbaddr: ffff8800badb6f00 } hitcount:          1  len:         60
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1287)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1288)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1289)     .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1290)     { skbaddr: ffff88009fe0be00 } hitcount:         27  len:      24677
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1291)     { skbaddr: ffff88009fe0a400 } hitcount:         27  len:      23052
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1292)     { skbaddr: ffff88009fe0b700 } hitcount:         31  len:      25589
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1293)     { skbaddr: ffff88009fe0b600 } hitcount:         32  len:      27326
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1294)     { skbaddr: ffff88006a462800 } hitcount:         68  len:      71678
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1295)     { skbaddr: ffff88006a463700 } hitcount:         70  len:      72678
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1296)     { skbaddr: ffff88006a462b00 } hitcount:         71  len:      77589
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1297)     { skbaddr: ffff88006a463600 } hitcount:         73  len:      71307
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1298)     { skbaddr: ffff88006a462200 } hitcount:         81  len:      81032
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1299) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1300)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1301)         Hits: 1451
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1302)         Entries: 318
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1303)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1304) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1305) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1306)     # event histogram
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1307)     #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1308)     # trigger info: hist:keys=skbaddr.hex:vals=hitcount,len:sort=hitcount:size=2048 if len == 256 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1309)     #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1310) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1311) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1312)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1313)         Hits: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1314)         Entries: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1315)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1316) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1317) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1318)     # event histogram
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1319)     #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1320)     # trigger info: hist:keys=skbaddr.hex:vals=hitcount,len:sort=hitcount:size=2048 if len > 4096 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1321)     #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1322) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1323)     { skbaddr: ffff88009fd2c300 } hitcount:          1  len:       7212
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1324)     { skbaddr: ffff8800d2bcce00 } hitcount:          1  len:       7212
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1325)     { skbaddr: ffff8800d2bcd700 } hitcount:          1  len:       7212
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1326)     { skbaddr: ffff8800d2bcda00 } hitcount:          1  len:      21492
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1327)     { skbaddr: ffff8800ae2e2d00 } hitcount:          1  len:       7212
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1328)     { skbaddr: ffff8800d2bcdb00 } hitcount:          1  len:       7212
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1329)     { skbaddr: ffff88006a4df500 } hitcount:          1  len:       4854
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1330)     { skbaddr: ffff88008ce47b00 } hitcount:          1  len:      18636
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1331)     { skbaddr: ffff8800ae2e2200 } hitcount:          1  len:      12924
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1332)     { skbaddr: ffff88005f3e1000 } hitcount:          1  len:       4356
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1333)     { skbaddr: ffff8800d2bcdc00 } hitcount:          2  len:      24420
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1334)     { skbaddr: ffff8800d2bcc200 } hitcount:          2  len:      12996
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1335) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1336)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1337)         Hits: 14
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1338)         Entries: 12
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1339)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1340) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1341) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1342)     # event histogram
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1343)     #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1344)     # trigger info: hist:keys=skbaddr.hex:vals=hitcount,len:sort=hitcount:size=2048 if len < 0 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1345)     #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1346) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1347) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1348)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1349)         Hits: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1350)         Entries: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1351)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1352) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1353)   Named triggers can be used to have triggers share a common set of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1354)   histogram data.  This capability is mostly useful for combining the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1355)   output of events generated by tracepoints contained inside inline
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1356)   functions, but names can be used in a hist trigger on any event.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1357)   For example, these two triggers when hit will update the same 'len'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1358)   field in the shared 'foo' histogram data::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1359) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1360)     # echo 'hist:name=foo:keys=skbaddr.hex:vals=len' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1361)            /sys/kernel/debug/tracing/events/net/netif_receive_skb/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1362)     # echo 'hist:name=foo:keys=skbaddr.hex:vals=len' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1363)            /sys/kernel/debug/tracing/events/net/netif_rx/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1364) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1365)   You can see that they're updating common histogram data by reading
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1366)   each event's hist files at the same time::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1367) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1368)     # cat /sys/kernel/debug/tracing/events/net/netif_receive_skb/hist;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1369)       cat /sys/kernel/debug/tracing/events/net/netif_rx/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1370) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1371)     # event histogram
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1372)     #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1373)     # trigger info: hist:name=foo:keys=skbaddr.hex:vals=hitcount,len:sort=hitcount:size=2048 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1374)     #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1375) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1376)     { skbaddr: ffff88000ad53500 } hitcount:          1  len:         46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1377)     { skbaddr: ffff8800af5a1500 } hitcount:          1  len:         76
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1378)     { skbaddr: ffff8800d62a1900 } hitcount:          1  len:         46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1379)     { skbaddr: ffff8800d2bccb00 } hitcount:          1  len:        468
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1380)     { skbaddr: ffff8800d3c69900 } hitcount:          1  len:         46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1381)     { skbaddr: ffff88009ff09100 } hitcount:          1  len:         52
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1382)     { skbaddr: ffff88010f13ab00 } hitcount:          1  len:        168
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1383)     { skbaddr: ffff88006a54f400 } hitcount:          1  len:         46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1384)     { skbaddr: ffff8800d2bcc500 } hitcount:          1  len:        260
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1385)     { skbaddr: ffff880064505000 } hitcount:          1  len:         46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1386)     { skbaddr: ffff8800baf24e00 } hitcount:          1  len:         32
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1387)     { skbaddr: ffff88009fe0ad00 } hitcount:          1  len:         46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1388)     { skbaddr: ffff8800d3edff00 } hitcount:          1  len:         44
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1389)     { skbaddr: ffff88009fe0b400 } hitcount:          1  len:        168
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1390)     { skbaddr: ffff8800a1c55a00 } hitcount:          1  len:         40
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1391)     { skbaddr: ffff8800d2bcd100 } hitcount:          1  len:         40
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1392)     { skbaddr: ffff880064505f00 } hitcount:          1  len:        174
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1393)     { skbaddr: ffff8800a8bff200 } hitcount:          1  len:        160
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1394)     { skbaddr: ffff880044e3cc00 } hitcount:          1  len:         76
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1395)     { skbaddr: ffff8800a8bfe700 } hitcount:          1  len:         46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1396)     { skbaddr: ffff8800d2bcdc00 } hitcount:          1  len:         32
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1397)     { skbaddr: ffff8800a1f64800 } hitcount:          1  len:         46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1398)     { skbaddr: ffff8800d2bcde00 } hitcount:          1  len:        988
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1399)     { skbaddr: ffff88006a5dea00 } hitcount:          1  len:         46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1400)     { skbaddr: ffff88002e37a200 } hitcount:          1  len:         44
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1401)     { skbaddr: ffff8800a1f32c00 } hitcount:          2  len:        676
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1402)     { skbaddr: ffff88000ad52600 } hitcount:          2  len:        107
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1403)     { skbaddr: ffff8800a1f91e00 } hitcount:          2  len:         92
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1404)     { skbaddr: ffff8800af5a0200 } hitcount:          2  len:        142
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1405)     { skbaddr: ffff8800d2bcc600 } hitcount:          2  len:        220
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1406)     { skbaddr: ffff8800ba36f500 } hitcount:          2  len:         92
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1407)     { skbaddr: ffff8800d021f800 } hitcount:          2  len:         92
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1408)     { skbaddr: ffff8800a1f33600 } hitcount:          2  len:        675
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1409)     { skbaddr: ffff8800a8bfff00 } hitcount:          3  len:        138
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1410)     { skbaddr: ffff8800d62a1300 } hitcount:          3  len:        138
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1411)     { skbaddr: ffff88002e37a100 } hitcount:          4  len:        184
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1412)     { skbaddr: ffff880064504400 } hitcount:          4  len:        184
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1413)     { skbaddr: ffff8800a8bfec00 } hitcount:          4  len:        184
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1414)     { skbaddr: ffff88000ad53700 } hitcount:          5  len:        230
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1415)     { skbaddr: ffff8800d2bcdb00 } hitcount:          5  len:        196
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1416)     { skbaddr: ffff8800a1f90000 } hitcount:          6  len:        276
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1417)     { skbaddr: ffff88006a54f900 } hitcount:          6  len:        276
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1418) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1419)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1420)         Hits: 81
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1421)         Entries: 42
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1422)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1423)     # event histogram
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1424)     #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1425)     # trigger info: hist:name=foo:keys=skbaddr.hex:vals=hitcount,len:sort=hitcount:size=2048 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1426)     #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1427) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1428)     { skbaddr: ffff88000ad53500 } hitcount:          1  len:         46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1429)     { skbaddr: ffff8800af5a1500 } hitcount:          1  len:         76
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1430)     { skbaddr: ffff8800d62a1900 } hitcount:          1  len:         46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1431)     { skbaddr: ffff8800d2bccb00 } hitcount:          1  len:        468
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1432)     { skbaddr: ffff8800d3c69900 } hitcount:          1  len:         46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1433)     { skbaddr: ffff88009ff09100 } hitcount:          1  len:         52
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1434)     { skbaddr: ffff88010f13ab00 } hitcount:          1  len:        168
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1435)     { skbaddr: ffff88006a54f400 } hitcount:          1  len:         46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1436)     { skbaddr: ffff8800d2bcc500 } hitcount:          1  len:        260
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1437)     { skbaddr: ffff880064505000 } hitcount:          1  len:         46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1438)     { skbaddr: ffff8800baf24e00 } hitcount:          1  len:         32
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1439)     { skbaddr: ffff88009fe0ad00 } hitcount:          1  len:         46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1440)     { skbaddr: ffff8800d3edff00 } hitcount:          1  len:         44
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1441)     { skbaddr: ffff88009fe0b400 } hitcount:          1  len:        168
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1442)     { skbaddr: ffff8800a1c55a00 } hitcount:          1  len:         40
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1443)     { skbaddr: ffff8800d2bcd100 } hitcount:          1  len:         40
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1444)     { skbaddr: ffff880064505f00 } hitcount:          1  len:        174
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1445)     { skbaddr: ffff8800a8bff200 } hitcount:          1  len:        160
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1446)     { skbaddr: ffff880044e3cc00 } hitcount:          1  len:         76
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1447)     { skbaddr: ffff8800a8bfe700 } hitcount:          1  len:         46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1448)     { skbaddr: ffff8800d2bcdc00 } hitcount:          1  len:         32
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1449)     { skbaddr: ffff8800a1f64800 } hitcount:          1  len:         46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1450)     { skbaddr: ffff8800d2bcde00 } hitcount:          1  len:        988
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1451)     { skbaddr: ffff88006a5dea00 } hitcount:          1  len:         46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1452)     { skbaddr: ffff88002e37a200 } hitcount:          1  len:         44
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1453)     { skbaddr: ffff8800a1f32c00 } hitcount:          2  len:        676
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1454)     { skbaddr: ffff88000ad52600 } hitcount:          2  len:        107
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1455)     { skbaddr: ffff8800a1f91e00 } hitcount:          2  len:         92
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1456)     { skbaddr: ffff8800af5a0200 } hitcount:          2  len:        142
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1457)     { skbaddr: ffff8800d2bcc600 } hitcount:          2  len:        220
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1458)     { skbaddr: ffff8800ba36f500 } hitcount:          2  len:         92
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1459)     { skbaddr: ffff8800d021f800 } hitcount:          2  len:         92
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1460)     { skbaddr: ffff8800a1f33600 } hitcount:          2  len:        675
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1461)     { skbaddr: ffff8800a8bfff00 } hitcount:          3  len:        138
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1462)     { skbaddr: ffff8800d62a1300 } hitcount:          3  len:        138
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1463)     { skbaddr: ffff88002e37a100 } hitcount:          4  len:        184
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1464)     { skbaddr: ffff880064504400 } hitcount:          4  len:        184
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1465)     { skbaddr: ffff8800a8bfec00 } hitcount:          4  len:        184
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1466)     { skbaddr: ffff88000ad53700 } hitcount:          5  len:        230
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1467)     { skbaddr: ffff8800d2bcdb00 } hitcount:          5  len:        196
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1468)     { skbaddr: ffff8800a1f90000 } hitcount:          6  len:        276
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1469)     { skbaddr: ffff88006a54f900 } hitcount:          6  len:        276
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1470) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1471)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1472)         Hits: 81
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1473)         Entries: 42
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1474)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1475) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1476)   And here's an example that shows how to combine histogram data from
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1477)   any two events even if they don't share any 'compatible' fields
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1478)   other than 'hitcount' and 'stacktrace'.  These commands create a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1479)   couple of triggers named 'bar' using those fields::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1480) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1481)     # echo 'hist:name=bar:key=stacktrace:val=hitcount' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1482)            /sys/kernel/debug/tracing/events/sched/sched_process_fork/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1483)     # echo 'hist:name=bar:key=stacktrace:val=hitcount' > \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1484)           /sys/kernel/debug/tracing/events/net/netif_rx/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1485) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1486)   And displaying the output of either shows some interesting if
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1487)   somewhat confusing output::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1488) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1489)     # cat /sys/kernel/debug/tracing/events/sched/sched_process_fork/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1490)     # cat /sys/kernel/debug/tracing/events/net/netif_rx/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1491) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1492)     # event histogram
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1493)     #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1494)     # trigger info: hist:name=bar:keys=stacktrace:vals=hitcount:sort=hitcount:size=2048 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1495)     #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1496) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1497)     { stacktrace:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1498)              kernel_clone+0x18e/0x330
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1499)              kernel_thread+0x29/0x30
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1500)              kthreadd+0x154/0x1b0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1501)              ret_from_fork+0x3f/0x70
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1502)     } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1503)     { stacktrace:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1504)              netif_rx_internal+0xb2/0xd0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1505)              netif_rx_ni+0x20/0x70
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1506)              dev_loopback_xmit+0xaa/0xd0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1507)              ip_mc_output+0x126/0x240
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1508)              ip_local_out_sk+0x31/0x40
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1509)              igmp_send_report+0x1e9/0x230
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1510)              igmp_timer_expire+0xe9/0x120
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1511)              call_timer_fn+0x39/0xf0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1512)              run_timer_softirq+0x1e1/0x290
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1513)              __do_softirq+0xfd/0x290
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1514)              irq_exit+0x98/0xb0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1515)              smp_apic_timer_interrupt+0x4a/0x60
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1516)              apic_timer_interrupt+0x6d/0x80
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1517)              cpuidle_enter+0x17/0x20
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1518)              call_cpuidle+0x3b/0x60
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1519)              cpu_startup_entry+0x22d/0x310
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1520)     } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1521)     { stacktrace:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1522)              netif_rx_internal+0xb2/0xd0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1523)              netif_rx_ni+0x20/0x70
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1524)              dev_loopback_xmit+0xaa/0xd0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1525)              ip_mc_output+0x17f/0x240
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1526)              ip_local_out_sk+0x31/0x40
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1527)              ip_send_skb+0x1a/0x50
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1528)              udp_send_skb+0x13e/0x270
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1529)              udp_sendmsg+0x2bf/0x980
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1530)              inet_sendmsg+0x67/0xa0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1531)              sock_sendmsg+0x38/0x50
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1532)              SYSC_sendto+0xef/0x170
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1533)              SyS_sendto+0xe/0x10
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1534)              entry_SYSCALL_64_fastpath+0x12/0x6a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1535)     } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1536)     { stacktrace:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1537)              netif_rx_internal+0xb2/0xd0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1538)              netif_rx+0x1c/0x60
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1539)              loopback_xmit+0x6c/0xb0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1540)              dev_hard_start_xmit+0x219/0x3a0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1541)              __dev_queue_xmit+0x415/0x4f0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1542)              dev_queue_xmit_sk+0x13/0x20
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1543)              ip_finish_output2+0x237/0x340
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1544)              ip_finish_output+0x113/0x1d0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1545)              ip_output+0x66/0xc0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1546)              ip_local_out_sk+0x31/0x40
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1547)              ip_send_skb+0x1a/0x50
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1548)              udp_send_skb+0x16d/0x270
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1549)              udp_sendmsg+0x2bf/0x980
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1550)              inet_sendmsg+0x67/0xa0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1551)              sock_sendmsg+0x38/0x50
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1552)              ___sys_sendmsg+0x14e/0x270
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1553)     } hitcount:         76
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1554)     { stacktrace:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1555)              netif_rx_internal+0xb2/0xd0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1556)              netif_rx+0x1c/0x60
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1557)              loopback_xmit+0x6c/0xb0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1558)              dev_hard_start_xmit+0x219/0x3a0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1559)              __dev_queue_xmit+0x415/0x4f0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1560)              dev_queue_xmit_sk+0x13/0x20
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1561)              ip_finish_output2+0x237/0x340
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1562)              ip_finish_output+0x113/0x1d0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1563)              ip_output+0x66/0xc0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1564)              ip_local_out_sk+0x31/0x40
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1565)              ip_send_skb+0x1a/0x50
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1566)              udp_send_skb+0x16d/0x270
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1567)              udp_sendmsg+0x2bf/0x980
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1568)              inet_sendmsg+0x67/0xa0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1569)              sock_sendmsg+0x38/0x50
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1570)              ___sys_sendmsg+0x269/0x270
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1571)     } hitcount:         77
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1572)     { stacktrace:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1573)              netif_rx_internal+0xb2/0xd0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1574)              netif_rx+0x1c/0x60
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1575)              loopback_xmit+0x6c/0xb0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1576)              dev_hard_start_xmit+0x219/0x3a0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1577)              __dev_queue_xmit+0x415/0x4f0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1578)              dev_queue_xmit_sk+0x13/0x20
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1579)              ip_finish_output2+0x237/0x340
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1580)              ip_finish_output+0x113/0x1d0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1581)              ip_output+0x66/0xc0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1582)              ip_local_out_sk+0x31/0x40
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1583)              ip_send_skb+0x1a/0x50
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1584)              udp_send_skb+0x16d/0x270
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1585)              udp_sendmsg+0x2bf/0x980
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1586)              inet_sendmsg+0x67/0xa0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1587)              sock_sendmsg+0x38/0x50
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1588)              SYSC_sendto+0xef/0x170
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1589)     } hitcount:         88
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1590)     { stacktrace:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1591)              kernel_clone+0x18e/0x330
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1592)              SyS_clone+0x19/0x20
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1593)              entry_SYSCALL_64_fastpath+0x12/0x6a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1594)     } hitcount:        244
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1595) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1596)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1597)         Hits: 489
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1598)         Entries: 7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1599)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1600) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1601) 2.2 Inter-event hist triggers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1602) -----------------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1603) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1604) Inter-event hist triggers are hist triggers that combine values from
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1605) one or more other events and create a histogram using that data.  Data
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1606) from an inter-event histogram can in turn become the source for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1607) further combined histograms, thus providing a chain of related
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1608) histograms, which is important for some applications.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1609) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1610) The most important example of an inter-event quantity that can be used
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1611) in this manner is latency, which is simply a difference in timestamps
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1612) between two events.  Although latency is the most important
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1613) inter-event quantity, note that because the support is completely
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1614) general across the trace event subsystem, any event field can be used
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1615) in an inter-event quantity.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1616) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1617) An example of a histogram that combines data from other histograms
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1618) into a useful chain would be a 'wakeupswitch latency' histogram that
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1619) combines a 'wakeup latency' histogram and a 'switch latency'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1620) histogram.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1621) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1622) Normally, a hist trigger specification consists of a (possibly
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1623) compound) key along with one or more numeric values, which are
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1624) continually updated sums associated with that key.  A histogram
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1625) specification in this case consists of individual key and value
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1626) specifications that refer to trace event fields associated with a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1627) single event type.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1628) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1629) The inter-event hist trigger extension allows fields from multiple
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1630) events to be referenced and combined into a multi-event histogram
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1631) specification.  In support of this overall goal, a few enabling
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1632) features have been added to the hist trigger support:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1633) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1634)   - In order to compute an inter-event quantity, a value from one
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1635)     event needs to saved and then referenced from another event.  This
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1636)     requires the introduction of support for histogram 'variables'.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1637) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1638)   - The computation of inter-event quantities and their combination
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1639)     require some minimal amount of support for applying simple
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1640)     expressions to variables (+ and -).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1641) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1642)   - A histogram consisting of inter-event quantities isn't logically a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1643)     histogram on either event (so having the 'hist' file for either
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1644)     event host the histogram output doesn't really make sense).  To
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1645)     address the idea that the histogram is associated with a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1646)     combination of events, support is added allowing the creation of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1647)     'synthetic' events that are events derived from other events.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1648)     These synthetic events are full-fledged events just like any other
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1649)     and can be used as such, as for instance to create the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1650)     'combination' histograms mentioned previously.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1651) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1652)   - A set of 'actions' can be associated with histogram entries -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1653)     these can be used to generate the previously mentioned synthetic
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1654)     events, but can also be used for other purposes, such as for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1655)     example saving context when a 'max' latency has been hit.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1656) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1657)   - Trace events don't have a 'timestamp' associated with them, but
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1658)     there is an implicit timestamp saved along with an event in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1659)     underlying ftrace ring buffer.  This timestamp is now exposed as a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1660)     a synthetic field named 'common_timestamp' which can be used in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1661)     histograms as if it were any other event field; it isn't an actual
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1662)     field in the trace format but rather is a synthesized value that
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1663)     nonetheless can be used as if it were an actual field.  By default
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1664)     it is in units of nanoseconds; appending '.usecs' to a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1665)     common_timestamp field changes the units to microseconds.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1666) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1667) A note on inter-event timestamps: If common_timestamp is used in a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1668) histogram, the trace buffer is automatically switched over to using
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1669) absolute timestamps and the "global" trace clock, in order to avoid
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1670) bogus timestamp differences with other clocks that aren't coherent
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1671) across CPUs.  This can be overridden by specifying one of the other
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1672) trace clocks instead, using the "clock=XXX" hist trigger attribute,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1673) where XXX is any of the clocks listed in the tracing/trace_clock
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1674) pseudo-file.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1675) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1676) These features are described in more detail in the following sections.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1677) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1678) 2.2.1 Histogram Variables
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1679) -------------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1680) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1681) Variables are simply named locations used for saving and retrieving
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1682) values between matching events.  A 'matching' event is defined as an
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1683) event that has a matching key - if a variable is saved for a histogram
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1684) entry corresponding to that key, any subsequent event with a matching
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1685) key can access that variable.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1686) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1687) A variable's value is normally available to any subsequent event until
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1688) it is set to something else by a subsequent event.  The one exception
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1689) to that rule is that any variable used in an expression is essentially
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1690) 'read-once' - once it's used by an expression in a subsequent event,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1691) it's reset to its 'unset' state, which means it can't be used again
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1692) unless it's set again.  This ensures not only that an event doesn't
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1693) use an uninitialized variable in a calculation, but that that variable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1694) is used only once and not for any unrelated subsequent match.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1695) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1696) The basic syntax for saving a variable is to simply prefix a unique
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1697) variable name not corresponding to any keyword along with an '=' sign
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1698) to any event field.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1699) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1700) Either keys or values can be saved and retrieved in this way.  This
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1701) creates a variable named 'ts0' for a histogram entry with the key
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1702) 'next_pid'::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1703) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1704)   # echo 'hist:keys=next_pid:vals=$ts0:ts0=common_timestamp ... >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1705) 	event/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1706) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1707) The ts0 variable can be accessed by any subsequent event having the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1708) same pid as 'next_pid'.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1709) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1710) Variable references are formed by prepending the variable name with
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1711) the '$' sign.  Thus for example, the ts0 variable above would be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1712) referenced as '$ts0' in expressions.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1713) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1714) Because 'vals=' is used, the common_timestamp variable value above
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1715) will also be summed as a normal histogram value would (though for a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1716) timestamp it makes little sense).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1717) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1718) The below shows that a key value can also be saved in the same way::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1719) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1720)   # echo 'hist:timer_pid=common_pid:key=timer_pid ...' >> event/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1721) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1722) If a variable isn't a key variable or prefixed with 'vals=', the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1723) associated event field will be saved in a variable but won't be summed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1724) as a value::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1725) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1726)   # echo 'hist:keys=next_pid:ts1=common_timestamp ...' >> event/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1727) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1728) Multiple variables can be assigned at the same time.  The below would
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1729) result in both ts0 and b being created as variables, with both
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1730) common_timestamp and field1 additionally being summed as values::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1731) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1732)   # echo 'hist:keys=pid:vals=$ts0,$b:ts0=common_timestamp,b=field1 ...' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1733) 	event/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1734) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1735) Note that variable assignments can appear either preceding or
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1736) following their use.  The command below behaves identically to the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1737) command above::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1738) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1739)   # echo 'hist:keys=pid:ts0=common_timestamp,b=field1:vals=$ts0,$b ...' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1740) 	event/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1741) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1742) Any number of variables not bound to a 'vals=' prefix can also be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1743) assigned by simply separating them with colons.  Below is the same
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1744) thing but without the values being summed in the histogram::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1745) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1746)   # echo 'hist:keys=pid:ts0=common_timestamp:b=field1 ...' >> event/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1747) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1748) Variables set as above can be referenced and used in expressions on
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1749) another event.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1750) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1751) For example, here's how a latency can be calculated::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1752) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1753)   # echo 'hist:keys=pid,prio:ts0=common_timestamp ...' >> event1/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1754)   # echo 'hist:keys=next_pid:wakeup_lat=common_timestamp-$ts0 ...' >> event2/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1755) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1756) In the first line above, the event's timestamp is saved into the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1757) variable ts0.  In the next line, ts0 is subtracted from the second
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1758) event's timestamp to produce the latency, which is then assigned into
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1759) yet another variable, 'wakeup_lat'.  The hist trigger below in turn
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1760) makes use of the wakeup_lat variable to compute a combined latency
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1761) using the same key and variable from yet another event::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1762) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1763)   # echo 'hist:key=pid:wakeupswitch_lat=$wakeup_lat+$switchtime_lat ...' >> event3/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1764) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1765) 2.2.2 Synthetic Events
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1766) ----------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1767) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1768) Synthetic events are user-defined events generated from hist trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1769) variables or fields associated with one or more other events.  Their
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1770) purpose is to provide a mechanism for displaying data spanning
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1771) multiple events consistent with the existing and already familiar
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1772) usage for normal events.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1773) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1774) To define a synthetic event, the user writes a simple specification
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1775) consisting of the name of the new event along with one or more
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1776) variables and their types, which can be any valid field type,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1777) separated by semicolons, to the tracing/synthetic_events file.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1778) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1779) See synth_field_size() for available types.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1780) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1781) If field_name contains [n], the field is considered to be a static array.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1782) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1783) If field_names contains[] (no subscript), the field is considered to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1784) be a dynamic array, which will only take as much space in the event as
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1785) is required to hold the array.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1786) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1787) A string field can be specified using either the static notation:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1788) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1789)   char name[32];
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1790) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1791) Or the dynamic:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1792) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1793)   char name[];
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1794) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1795) The size limit for either is 256.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1796) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1797) For instance, the following creates a new event named 'wakeup_latency'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1798) with 3 fields: lat, pid, and prio.  Each of those fields is simply a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1799) variable reference to a variable on another event::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1800) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1801)   # echo 'wakeup_latency \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1802)           u64 lat; \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1803)           pid_t pid; \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1804) 	  int prio' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1805) 	  /sys/kernel/debug/tracing/synthetic_events
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1806) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1807) Reading the tracing/synthetic_events file lists all the currently
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1808) defined synthetic events, in this case the event defined above::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1809) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1810)   # cat /sys/kernel/debug/tracing/synthetic_events
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1811)     wakeup_latency u64 lat; pid_t pid; int prio
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1812) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1813) An existing synthetic event definition can be removed by prepending
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1814) the command that defined it with a '!'::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1815) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1816)   # echo '!wakeup_latency u64 lat pid_t pid int prio' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1817)     /sys/kernel/debug/tracing/synthetic_events
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1818) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1819) At this point, there isn't yet an actual 'wakeup_latency' event
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1820) instantiated in the event subsystem - for this to happen, a 'hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1821) trigger action' needs to be instantiated and bound to actual fields
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1822) and variables defined on other events (see Section 2.2.3 below on
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1823) how that is done using hist trigger 'onmatch' action). Once that is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1824) done, the 'wakeup_latency' synthetic event instance is created.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1825) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1826) A histogram can now be defined for the new synthetic event::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1827) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1828)   # echo 'hist:keys=pid,prio,lat.log2:sort=pid,lat' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1829)         /sys/kernel/debug/tracing/events/synthetic/wakeup_latency/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1830) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1831) The new event is created under the tracing/events/synthetic/ directory
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1832) and looks and behaves just like any other event::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1833) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1834)   # ls /sys/kernel/debug/tracing/events/synthetic/wakeup_latency
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1835)         enable  filter  format  hist  id  trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1836) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1837) Like any other event, once a histogram is enabled for the event, the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1838) output can be displayed by reading the event's 'hist' file.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1839) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1840) 2.2.3 Hist trigger 'handlers' and 'actions'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1841) -------------------------------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1842) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1843) A hist trigger 'action' is a function that's executed (in most cases
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1844) conditionally) whenever a histogram entry is added or updated.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1845) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1846) When a histogram entry is added or updated, a hist trigger 'handler'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1847) is what decides whether the corresponding action is actually invoked
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1848) or not.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1849) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1850) Hist trigger handlers and actions are paired together in the general
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1851) form:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1852) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1853)   <handler>.<action>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1854) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1855) To specify a handler.action pair for a given event, simply specify
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1856) that handler.action pair between colons in the hist trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1857) specification.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1858) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1859) In theory, any handler can be combined with any action, but in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1860) practice, not every handler.action combination is currently supported;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1861) if a given handler.action combination isn't supported, the hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1862) trigger will fail with -EINVAL;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1863) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1864) The default 'handler.action' if none is explicitly specified is as it
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1865) always has been, to simply update the set of values associated with an
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1866) entry.  Some applications, however, may want to perform additional
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1867) actions at that point, such as generate another event, or compare and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1868) save a maximum.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1869) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1870) The supported handlers and actions are listed below, and each is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1871) described in more detail in the following paragraphs, in the context
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1872) of descriptions of some common and useful handler.action combinations.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1873) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1874) The available handlers are:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1875) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1876)   - onmatch(matching.event)    - invoke action on any addition or update
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1877)   - onmax(var)                 - invoke action if var exceeds current max
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1878)   - onchange(var)              - invoke action if var changes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1879) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1880) The available actions are:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1881) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1882)   - trace(<synthetic_event_name>,param list)   - generate synthetic event
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1883)   - save(field,...)                            - save current event fields
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1884)   - snapshot()                                 - snapshot the trace buffer
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1885) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1886) The following commonly-used handler.action pairs are available:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1887) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1888)   - onmatch(matching.event).trace(<synthetic_event_name>,param list)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1889) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1890)     The 'onmatch(matching.event).trace(<synthetic_event_name>,param
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1891)     list)' hist trigger action is invoked whenever an event matches
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1892)     and the histogram entry would be added or updated.  It causes the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1893)     named synthetic event to be generated with the values given in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1894)     'param list'.  The result is the generation of a synthetic event
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1895)     that consists of the values contained in those variables at the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1896)     time the invoking event was hit.  For example, if the synthetic
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1897)     event name is 'wakeup_latency', a wakeup_latency event is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1898)     generated using onmatch(event).trace(wakeup_latency,arg1,arg2).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1899) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1900)     There is also an equivalent alternative form available for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1901)     generating synthetic events.  In this form, the synthetic event
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1902)     name is used as if it were a function name.  For example, using
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1903)     the 'wakeup_latency' synthetic event name again, the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1904)     wakeup_latency event would be generated by invoking it as if it
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1905)     were a function call, with the event field values passed in as
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1906)     arguments: onmatch(event).wakeup_latency(arg1,arg2).  The syntax
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1907)     for this form is:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1908) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1909)       onmatch(matching.event).<synthetic_event_name>(param list)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1910) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1911)     In either case, the 'param list' consists of one or more
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1912)     parameters which may be either variables or fields defined on
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1913)     either the 'matching.event' or the target event.  The variables or
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1914)     fields specified in the param list may be either fully-qualified
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1915)     or unqualified.  If a variable is specified as unqualified, it
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1916)     must be unique between the two events.  A field name used as a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1917)     param can be unqualified if it refers to the target event, but
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1918)     must be fully qualified if it refers to the matching event.  A
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1919)     fully-qualified name is of the form 'system.event_name.$var_name'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1920)     or 'system.event_name.field'.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1921) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1922)     The 'matching.event' specification is simply the fully qualified
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1923)     event name of the event that matches the target event for the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1924)     onmatch() functionality, in the form 'system.event_name'. Histogram
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1925)     keys of both events are compared to find if events match. In case
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1926)     multiple histogram keys are used, they all must match in the specified
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1927)     order.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1928) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1929)     Finally, the number and type of variables/fields in the 'param
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1930)     list' must match the number and types of the fields in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1931)     synthetic event being generated.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1932) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1933)     As an example the below defines a simple synthetic event and uses
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1934)     a variable defined on the sched_wakeup_new event as a parameter
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1935)     when invoking the synthetic event.  Here we define the synthetic
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1936)     event::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1937) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1938)       # echo 'wakeup_new_test pid_t pid' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1939)              /sys/kernel/debug/tracing/synthetic_events
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1940) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1941)       # cat /sys/kernel/debug/tracing/synthetic_events
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1942)             wakeup_new_test pid_t pid
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1943) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1944)     The following hist trigger both defines the missing testpid
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1945)     variable and specifies an onmatch() action that generates a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1946)     wakeup_new_test synthetic event whenever a sched_wakeup_new event
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1947)     occurs, which because of the 'if comm == "cyclictest"' filter only
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1948)     happens when the executable is cyclictest::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1949) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1950)       # echo 'hist:keys=$testpid:testpid=pid:onmatch(sched.sched_wakeup_new).\
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1951)               wakeup_new_test($testpid) if comm=="cyclictest"' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1952)               /sys/kernel/debug/tracing/events/sched/sched_wakeup_new/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1953) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1954)     Or, equivalently, using the 'trace' keyword syntax:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1955) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1956)     # echo 'hist:keys=$testpid:testpid=pid:onmatch(sched.sched_wakeup_new).\
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1957)             trace(wakeup_new_test,$testpid) if comm=="cyclictest"' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1958)             /sys/kernel/debug/tracing/events/sched/sched_wakeup_new/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1959) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1960)     Creating and displaying a histogram based on those events is now
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1961)     just a matter of using the fields and new synthetic event in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1962)     tracing/events/synthetic directory, as usual::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1963) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1964)       # echo 'hist:keys=pid:sort=pid' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1965)              /sys/kernel/debug/tracing/events/synthetic/wakeup_new_test/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1966) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1967)     Running 'cyclictest' should cause wakeup_new events to generate
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1968)     wakeup_new_test synthetic events which should result in histogram
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1969)     output in the wakeup_new_test event's hist file::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1970) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1971)       # cat /sys/kernel/debug/tracing/events/synthetic/wakeup_new_test/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1972) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1973)     A more typical usage would be to use two events to calculate a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1974)     latency.  The following example uses a set of hist triggers to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1975)     produce a 'wakeup_latency' histogram.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1976) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1977)     First, we define a 'wakeup_latency' synthetic event::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1978) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1979)       # echo 'wakeup_latency u64 lat; pid_t pid; int prio' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1980)               /sys/kernel/debug/tracing/synthetic_events
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1981) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1982)     Next, we specify that whenever we see a sched_waking event for a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1983)     cyclictest thread, save the timestamp in a 'ts0' variable::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1984) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1985)       # echo 'hist:keys=$saved_pid:saved_pid=pid:ts0=common_timestamp.usecs \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1986)               if comm=="cyclictest"' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1987) 	      /sys/kernel/debug/tracing/events/sched/sched_waking/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1988) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1989)     Then, when the corresponding thread is actually scheduled onto the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1990)     CPU by a sched_switch event (saved_pid matches next_pid), calculate
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1991)     the latency and use that along with another variable and an event field
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1992)     to generate a wakeup_latency synthetic event::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1993) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1994)       # echo 'hist:keys=next_pid:wakeup_lat=common_timestamp.usecs-$ts0:\
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1995)               onmatch(sched.sched_waking).wakeup_latency($wakeup_lat,\
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1996) 	              $saved_pid,next_prio) if next_comm=="cyclictest"' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1997) 	      /sys/kernel/debug/tracing/events/sched/sched_switch/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1998) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1999)     We also need to create a histogram on the wakeup_latency synthetic
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2000)     event in order to aggregate the generated synthetic event data::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2001) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2002)       # echo 'hist:keys=pid,prio,lat:sort=pid,lat' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2003)               /sys/kernel/debug/tracing/events/synthetic/wakeup_latency/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2004) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2005)     Finally, once we've run cyclictest to actually generate some
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2006)     events, we can see the output by looking at the wakeup_latency
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2007)     synthetic event's hist file::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2008) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2009)       # cat /sys/kernel/debug/tracing/events/synthetic/wakeup_latency/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2010) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2011)   - onmax(var).save(field,..	.)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2012) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2013)     The 'onmax(var).save(field,...)' hist trigger action is invoked
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2014)     whenever the value of 'var' associated with a histogram entry
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2015)     exceeds the current maximum contained in that variable.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2016) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2017)     The end result is that the trace event fields specified as the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2018)     onmax.save() params will be saved if 'var' exceeds the current
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2019)     maximum for that hist trigger entry.  This allows context from the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2020)     event that exhibited the new maximum to be saved for later
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2021)     reference.  When the histogram is displayed, additional fields
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2022)     displaying the saved values will be printed.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2023) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2024)     As an example the below defines a couple of hist triggers, one for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2025)     sched_waking and another for sched_switch, keyed on pid.  Whenever
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2026)     a sched_waking occurs, the timestamp is saved in the entry
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2027)     corresponding to the current pid, and when the scheduler switches
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2028)     back to that pid, the timestamp difference is calculated.  If the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2029)     resulting latency, stored in wakeup_lat, exceeds the current
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2030)     maximum latency, the values specified in the save() fields are
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2031)     recorded::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2032) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2033)       # echo 'hist:keys=pid:ts0=common_timestamp.usecs \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2034)               if comm=="cyclictest"' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2035)               /sys/kernel/debug/tracing/events/sched/sched_waking/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2036) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2037)       # echo 'hist:keys=next_pid:\
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2038)               wakeup_lat=common_timestamp.usecs-$ts0:\
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2039)               onmax($wakeup_lat).save(next_comm,prev_pid,prev_prio,prev_comm) \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2040)               if next_comm=="cyclictest"' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2041)               /sys/kernel/debug/tracing/events/sched/sched_switch/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2042) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2043)     When the histogram is displayed, the max value and the saved
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2044)     values corresponding to the max are displayed following the rest
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2045)     of the fields::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2046) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2047)       # cat /sys/kernel/debug/tracing/events/sched/sched_switch/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2048)         { next_pid:       2255 } hitcount:        239
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2049)           common_timestamp-ts0:          0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2050)           max:         27
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2051) 	  next_comm: cyclictest
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2052)           prev_pid:          0  prev_prio:        120  prev_comm: swapper/1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2053) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2054)         { next_pid:       2256 } hitcount:       2355
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2055)           common_timestamp-ts0: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2056)           max:         49  next_comm: cyclictest
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2057)           prev_pid:          0  prev_prio:        120  prev_comm: swapper/0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2058) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2059)         Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2060)             Hits: 12970
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2061)             Entries: 2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2062)             Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2063) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2064)   - onmax(var).snapshot()
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2065) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2066)     The 'onmax(var).snapshot()' hist trigger action is invoked
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2067)     whenever the value of 'var' associated with a histogram entry
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2068)     exceeds the current maximum contained in that variable.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2069) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2070)     The end result is that a global snapshot of the trace buffer will
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2071)     be saved in the tracing/snapshot file if 'var' exceeds the current
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2072)     maximum for any hist trigger entry.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2073) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2074)     Note that in this case the maximum is a global maximum for the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2075)     current trace instance, which is the maximum across all buckets of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2076)     the histogram.  The key of the specific trace event that caused
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2077)     the global maximum and the global maximum itself are displayed,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2078)     along with a message stating that a snapshot has been taken and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2079)     where to find it.  The user can use the key information displayed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2080)     to locate the corresponding bucket in the histogram for even more
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2081)     detail.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2082) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2083)     As an example the below defines a couple of hist triggers, one for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2084)     sched_waking and another for sched_switch, keyed on pid.  Whenever
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2085)     a sched_waking event occurs, the timestamp is saved in the entry
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2086)     corresponding to the current pid, and when the scheduler switches
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2087)     back to that pid, the timestamp difference is calculated.  If the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2088)     resulting latency, stored in wakeup_lat, exceeds the current
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2089)     maximum latency, a snapshot is taken.  As part of the setup, all
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2090)     the scheduler events are also enabled, which are the events that
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2091)     will show up in the snapshot when it is taken at some point:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2092) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2093)     # echo 1 > /sys/kernel/debug/tracing/events/sched/enable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2094) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2095)     # echo 'hist:keys=pid:ts0=common_timestamp.usecs \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2096)             if comm=="cyclictest"' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2097)             /sys/kernel/debug/tracing/events/sched/sched_waking/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2098) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2099)     # echo 'hist:keys=next_pid:wakeup_lat=common_timestamp.usecs-$ts0: \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2100)             onmax($wakeup_lat).save(next_prio,next_comm,prev_pid,prev_prio, \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2101) 	    prev_comm):onmax($wakeup_lat).snapshot() \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2102) 	    if next_comm=="cyclictest"' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2103) 	    /sys/kernel/debug/tracing/events/sched/sched_switch/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2104) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2105)     When the histogram is displayed, for each bucket the max value
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2106)     and the saved values corresponding to the max are displayed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2107)     following the rest of the fields.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2108) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2109)     If a snapshot was taken, there is also a message indicating that,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2110)     along with the value and event that triggered the global maximum:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2111) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2112)     # cat /sys/kernel/debug/tracing/events/sched/sched_switch/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2113)       { next_pid:       2101 } hitcount:        200
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2114) 	max:         52  next_prio:        120  next_comm: cyclictest \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2115)         prev_pid:          0  prev_prio:        120  prev_comm: swapper/6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2116) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2117)       { next_pid:       2103 } hitcount:       1326
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2118) 	max:        572  next_prio:         19  next_comm: cyclictest \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2119)         prev_pid:          0  prev_prio:        120  prev_comm: swapper/1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2120) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2121)       { next_pid:       2102 } hitcount:       1982 \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2122) 	max:         74  next_prio:         19  next_comm: cyclictest \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2123)         prev_pid:          0  prev_prio:        120  prev_comm: swapper/5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2124) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2125)     Snapshot taken (see tracing/snapshot).  Details:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2126) 	triggering value { onmax($wakeup_lat) }:        572	\
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2127) 	triggered by event with key: { next_pid:       2103 }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2128) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2129)     Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2130)         Hits: 3508
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2131)         Entries: 3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2132)         Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2133) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2134)     In the above case, the event that triggered the global maximum has
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2135)     the key with next_pid == 2103.  If you look at the bucket that has
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2136)     2103 as the key, you'll find the additional values save()'d along
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2137)     with the local maximum for that bucket, which should be the same
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2138)     as the global maximum (since that was the same value that
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2139)     triggered the global snapshot).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2140) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2141)     And finally, looking at the snapshot data should show at or near
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2142)     the end the event that triggered the snapshot (in this case you
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2143)     can verify the timestamps between the sched_waking and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2144)     sched_switch events, which should match the time displayed in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2145)     global maximum)::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2146) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2147)      # cat /sys/kernel/debug/tracing/snapshot
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2148) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2149)          <...>-2103  [005] d..3   309.873125: sched_switch: prev_comm=cyclictest prev_pid=2103 prev_prio=19 prev_state=D ==> next_comm=swapper/5 next_pid=0 next_prio=120
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2150)          <idle>-0     [005] d.h3   309.873611: sched_waking: comm=cyclictest pid=2102 prio=19 target_cpu=005
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2151)          <idle>-0     [005] dNh4   309.873613: sched_wakeup: comm=cyclictest pid=2102 prio=19 target_cpu=005
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2152)          <idle>-0     [005] d..3   309.873616: sched_switch: prev_comm=swapper/5 prev_pid=0 prev_prio=120 prev_state=S ==> next_comm=cyclictest next_pid=2102 next_prio=19
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2153)          <...>-2102  [005] d..3   309.873625: sched_switch: prev_comm=cyclictest prev_pid=2102 prev_prio=19 prev_state=D ==> next_comm=swapper/5 next_pid=0 next_prio=120
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2154)          <idle>-0     [005] d.h3   309.874624: sched_waking: comm=cyclictest pid=2102 prio=19 target_cpu=005
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2155)          <idle>-0     [005] dNh4   309.874626: sched_wakeup: comm=cyclictest pid=2102 prio=19 target_cpu=005
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2156)          <idle>-0     [005] dNh3   309.874628: sched_waking: comm=cyclictest pid=2103 prio=19 target_cpu=005
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2157)          <idle>-0     [005] dNh4   309.874630: sched_wakeup: comm=cyclictest pid=2103 prio=19 target_cpu=005
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2158)          <idle>-0     [005] d..3   309.874633: sched_switch: prev_comm=swapper/5 prev_pid=0 prev_prio=120 prev_state=S ==> next_comm=cyclictest next_pid=2102 next_prio=19
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2159)          <idle>-0     [004] d.h3   309.874757: sched_waking: comm=gnome-terminal- pid=1699 prio=120 target_cpu=004
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2160)          <idle>-0     [004] dNh4   309.874762: sched_wakeup: comm=gnome-terminal- pid=1699 prio=120 target_cpu=004
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2161)          <idle>-0     [004] d..3   309.874766: sched_switch: prev_comm=swapper/4 prev_pid=0 prev_prio=120 prev_state=S ==> next_comm=gnome-terminal- next_pid=1699 next_prio=120
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2162)      gnome-terminal--1699  [004] d.h2   309.874941: sched_stat_runtime: comm=gnome-terminal- pid=1699 runtime=180706 [ns] vruntime=1126870572 [ns]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2163)          <idle>-0     [003] d.s4   309.874956: sched_waking: comm=rcu_sched pid=9 prio=120 target_cpu=007
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2164)          <idle>-0     [003] d.s5   309.874960: sched_wake_idle_without_ipi: cpu=7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2165)          <idle>-0     [003] d.s5   309.874961: sched_wakeup: comm=rcu_sched pid=9 prio=120 target_cpu=007
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2166)          <idle>-0     [007] d..3   309.874963: sched_switch: prev_comm=swapper/7 prev_pid=0 prev_prio=120 prev_state=S ==> next_comm=rcu_sched next_pid=9 next_prio=120
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2167)       rcu_sched-9     [007] d..3   309.874973: sched_stat_runtime: comm=rcu_sched pid=9 runtime=13646 [ns] vruntime=22531430286 [ns]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2168)       rcu_sched-9     [007] d..3   309.874978: sched_switch: prev_comm=rcu_sched prev_pid=9 prev_prio=120 prev_state=R+ ==> next_comm=swapper/7 next_pid=0 next_prio=120
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2169)           <...>-2102  [005] d..4   309.874994: sched_migrate_task: comm=cyclictest pid=2103 prio=19 orig_cpu=5 dest_cpu=1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2170)           <...>-2102  [005] d..4   309.875185: sched_wake_idle_without_ipi: cpu=1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2171)          <idle>-0     [001] d..3   309.875200: sched_switch: prev_comm=swapper/1 prev_pid=0 prev_prio=120 prev_state=S ==> next_comm=cyclictest next_pid=2103 next_prio=19
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2172) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2173)   - onchange(var).save(field,..	.)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2174) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2175)     The 'onchange(var).save(field,...)' hist trigger action is invoked
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2176)     whenever the value of 'var' associated with a histogram entry
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2177)     changes.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2178) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2179)     The end result is that the trace event fields specified as the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2180)     onchange.save() params will be saved if 'var' changes for that
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2181)     hist trigger entry.  This allows context from the event that
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2182)     changed the value to be saved for later reference.  When the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2183)     histogram is displayed, additional fields displaying the saved
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2184)     values will be printed.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2185) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2186)   - onchange(var).snapshot()
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2187) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2188)     The 'onchange(var).snapshot()' hist trigger action is invoked
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2189)     whenever the value of 'var' associated with a histogram entry
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2190)     changes.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2191) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2192)     The end result is that a global snapshot of the trace buffer will
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2193)     be saved in the tracing/snapshot file if 'var' changes for any
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2194)     hist trigger entry.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2195) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2196)     Note that in this case the changed value is a global variable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2197)     associated with current trace instance.  The key of the specific
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2198)     trace event that caused the value to change and the global value
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2199)     itself are displayed, along with a message stating that a snapshot
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2200)     has been taken and where to find it.  The user can use the key
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2201)     information displayed to locate the corresponding bucket in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2202)     histogram for even more detail.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2203) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2204)     As an example the below defines a hist trigger on the tcp_probe
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2205)     event, keyed on dport.  Whenever a tcp_probe event occurs, the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2206)     cwnd field is checked against the current value stored in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2207)     $cwnd variable.  If the value has changed, a snapshot is taken.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2208)     As part of the setup, all the scheduler and tcp events are also
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2209)     enabled, which are the events that will show up in the snapshot
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2210)     when it is taken at some point:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2211) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2212)     # echo 1 > /sys/kernel/debug/tracing/events/sched/enable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2213)     # echo 1 > /sys/kernel/debug/tracing/events/tcp/enable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2214) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2215)     # echo 'hist:keys=dport:cwnd=snd_cwnd: \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2216)             onchange($cwnd).save(snd_wnd,srtt,rcv_wnd): \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2217) 	    onchange($cwnd).snapshot()' >> \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2218) 	    /sys/kernel/debug/tracing/events/tcp/tcp_probe/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2219) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2220)     When the histogram is displayed, for each bucket the tracked value
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2221)     and the saved values corresponding to that value are displayed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2222)     following the rest of the fields.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2223) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2224)     If a snapshot was taken, there is also a message indicating that,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2225)     along with the value and event that triggered the snapshot::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2226) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2227)       # cat /sys/kernel/debug/tracing/events/tcp/tcp_probe/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2228) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2229)       { dport:       1521 } hitcount:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2230) 	changed:         10  snd_wnd:      35456  srtt:     154262  rcv_wnd:      42112
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2231) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2232)       { dport:         80 } hitcount:         23
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2233) 	changed:         10  snd_wnd:      28960  srtt:      19604  rcv_wnd:      29312
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2234) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2235)       { dport:       9001 } hitcount:        172
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2236) 	changed:         10  snd_wnd:      48384  srtt:     260444  rcv_wnd:      55168
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2237) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2238)       { dport:        443 } hitcount:        211
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2239) 	changed:         10  snd_wnd:      26960  srtt:      17379  rcv_wnd:      28800
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2240) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2241)     Snapshot taken (see tracing/snapshot).  Details::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2242) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2243)         triggering value { onchange($cwnd) }:         10
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2244)         triggered by event with key: { dport:         80 }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2245) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2246)       Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2247)           Hits: 414
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2248)           Entries: 4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2249)           Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2250) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2251)     In the above case, the event that triggered the snapshot has the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2252)     key with dport == 80.  If you look at the bucket that has 80 as
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2253)     the key, you'll find the additional values save()'d along with the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2254)     changed value for that bucket, which should be the same as the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2255)     global changed value (since that was the same value that triggered
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2256)     the global snapshot).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2257) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2258)     And finally, looking at the snapshot data should show at or near
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2259)     the end the event that triggered the snapshot::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2260) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2261)       # cat /sys/kernel/debug/tracing/snapshot
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2262) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2263)          gnome-shell-1261  [006] dN.3    49.823113: sched_stat_runtime: comm=gnome-shell pid=1261 runtime=49347 [ns] vruntime=1835730389 [ns]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2264)        kworker/u16:4-773   [003] d..3    49.823114: sched_switch: prev_comm=kworker/u16:4 prev_pid=773 prev_prio=120 prev_state=R+ ==> next_comm=kworker/3:2 next_pid=135 next_prio=120
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2265)          gnome-shell-1261  [006] d..3    49.823114: sched_switch: prev_comm=gnome-shell prev_pid=1261 prev_prio=120 prev_state=R+ ==> next_comm=kworker/6:2 next_pid=387 next_prio=120
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2266)          kworker/3:2-135   [003] d..3    49.823118: sched_stat_runtime: comm=kworker/3:2 pid=135 runtime=5339 [ns] vruntime=17815800388 [ns]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2267)          kworker/6:2-387   [006] d..3    49.823120: sched_stat_runtime: comm=kworker/6:2 pid=387 runtime=9594 [ns] vruntime=14589605367 [ns]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2268)          kworker/6:2-387   [006] d..3    49.823122: sched_switch: prev_comm=kworker/6:2 prev_pid=387 prev_prio=120 prev_state=R+ ==> next_comm=gnome-shell next_pid=1261 next_prio=120
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2269)          kworker/3:2-135   [003] d..3    49.823123: sched_switch: prev_comm=kworker/3:2 prev_pid=135 prev_prio=120 prev_state=T ==> next_comm=swapper/3 next_pid=0 next_prio=120
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2270)               <idle>-0     [004] ..s7    49.823798: tcp_probe: src=10.0.0.10:54326 dest=23.215.104.193:80 mark=0x0 length=32 snd_nxt=0xe3ae2ff5 snd_una=0xe3ae2ecd snd_cwnd=10 ssthresh=2147483647 snd_wnd=28960 srtt=19604 rcv_wnd=29312
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2271) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2272) 3. User space creating a trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2273) --------------------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2274) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2275) Writing into /sys/kernel/tracing/trace_marker writes into the ftrace
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2276) ring buffer. This can also act like an event, by writing into the trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2277) file located in /sys/kernel/tracing/events/ftrace/print/
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2278) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2279) Modifying cyclictest to write into the trace_marker file before it sleeps
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2280) and after it wakes up, something like this::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2281) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2282)   static void traceputs(char *str)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2283)   {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2284) 	/* tracemark_fd is the trace_marker file descriptor */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2285) 	if (tracemark_fd < 0)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2286) 		return;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2287) 	/* write the tracemark message */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2288) 	write(tracemark_fd, str, strlen(str));
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2289)   }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2290) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2291) And later add something like::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2292) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2293) 	traceputs("start");
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2294) 	clock_nanosleep(...);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2295) 	traceputs("end");
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2296) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2297) We can make a histogram from this::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2298) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2299)  # cd /sys/kernel/tracing
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2300)  # echo 'latency u64 lat' > synthetic_events
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2301)  # echo 'hist:keys=common_pid:ts0=common_timestamp.usecs if buf == "start"' > events/ftrace/print/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2302)  # echo 'hist:keys=common_pid:lat=common_timestamp.usecs-$ts0:onmatch(ftrace.print).latency($lat) if buf == "end"' >> events/ftrace/print/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2303)  # echo 'hist:keys=lat,common_pid:sort=lat' > events/synthetic/latency/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2304) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2305) The above created a synthetic event called "latency" and two histograms
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2306) against the trace_marker, one gets triggered when "start" is written into the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2307) trace_marker file and the other when "end" is written. If the pids match, then
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2308) it will call the "latency" synthetic event with the calculated latency as its
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2309) parameter. Finally, a histogram is added to the latency synthetic event to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2310) record the calculated latency along with the pid.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2311) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2312) Now running cyclictest with::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2313) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2314)  # ./cyclictest -p80 -d0 -i250 -n -a -t --tracemark -b 1000
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2315) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2316)  -p80  : run threads at priority 80
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2317)  -d0   : have all threads run at the same interval
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2318)  -i250 : start the interval at 250 microseconds (all threads will do this)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2319)  -n    : sleep with nanosleep
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2320)  -a    : affine all threads to a separate CPU
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2321)  -t    : one thread per available CPU
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2322)  --tracemark : enable trace mark writing
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2323)  -b 1000 : stop if any latency is greater than 1000 microseconds
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2324) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2325) Note, the -b 1000 is used just to make --tracemark available.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2326) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2327) Then we can see the histogram created by this with::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2328) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2329)  # cat events/synthetic/latency/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2330)  # event histogram
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2331)  #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2332)  # trigger info: hist:keys=lat,common_pid:vals=hitcount:sort=lat:size=2048 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2333)  #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2334) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2335)  { lat:        107, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2336)  { lat:        122, common_pid:       2041 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2337)  { lat:        166, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2338)  { lat:        174, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2339)  { lat:        194, common_pid:       2041 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2340)  { lat:        196, common_pid:       2036 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2341)  { lat:        197, common_pid:       2038 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2342)  { lat:        198, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2343)  { lat:        199, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2344)  { lat:        200, common_pid:       2041 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2345)  { lat:        201, common_pid:       2039 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2346)  { lat:        202, common_pid:       2038 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2347)  { lat:        202, common_pid:       2043 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2348)  { lat:        203, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2349)  { lat:        203, common_pid:       2036 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2350)  { lat:        203, common_pid:       2041 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2351)  { lat:        206, common_pid:       2038 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2352)  { lat:        207, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2353)  { lat:        207, common_pid:       2036 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2354)  { lat:        208, common_pid:       2040 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2355)  { lat:        209, common_pid:       2043 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2356)  { lat:        210, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2357)  { lat:        211, common_pid:       2039 } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2358)  { lat:        212, common_pid:       2043 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2359)  { lat:        212, common_pid:       2039 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2360)  { lat:        213, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2361)  { lat:        214, common_pid:       2038 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2362)  { lat:        214, common_pid:       2039 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2363)  { lat:        214, common_pid:       2042 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2364)  { lat:        215, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2365)  { lat:        217, common_pid:       2036 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2366)  { lat:        217, common_pid:       2040 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2367)  { lat:        217, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2368)  { lat:        218, common_pid:       2039 } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2369)  { lat:        219, common_pid:       2039 } hitcount:          9
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2370)  { lat:        220, common_pid:       2039 } hitcount:         11
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2371)  { lat:        221, common_pid:       2039 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2372)  { lat:        221, common_pid:       2042 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2373)  { lat:        222, common_pid:       2039 } hitcount:          7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2374)  { lat:        223, common_pid:       2036 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2375)  { lat:        223, common_pid:       2039 } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2376)  { lat:        224, common_pid:       2039 } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2377)  { lat:        224, common_pid:       2037 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2378)  { lat:        224, common_pid:       2036 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2379)  { lat:        225, common_pid:       2039 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2380)  { lat:        225, common_pid:       2042 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2381)  { lat:        226, common_pid:       2039 } hitcount:          7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2382)  { lat:        226, common_pid:       2036 } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2383)  { lat:        227, common_pid:       2039 } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2384)  { lat:        227, common_pid:       2036 } hitcount:         12
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2385)  { lat:        227, common_pid:       2043 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2386)  { lat:        228, common_pid:       2039 } hitcount:          7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2387)  { lat:        228, common_pid:       2036 } hitcount:         14
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2388)  { lat:        229, common_pid:       2039 } hitcount:          9
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2389)  { lat:        229, common_pid:       2036 } hitcount:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2390)  { lat:        229, common_pid:       2038 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2391)  { lat:        230, common_pid:       2039 } hitcount:         11
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2392)  { lat:        230, common_pid:       2036 } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2393)  { lat:        230, common_pid:       2043 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2394)  { lat:        230, common_pid:       2042 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2395)  { lat:        231, common_pid:       2041 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2396)  { lat:        231, common_pid:       2036 } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2397)  { lat:        231, common_pid:       2043 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2398)  { lat:        231, common_pid:       2039 } hitcount:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2399)  { lat:        232, common_pid:       2037 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2400)  { lat:        232, common_pid:       2039 } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2401)  { lat:        232, common_pid:       2040 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2402)  { lat:        232, common_pid:       2036 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2403)  { lat:        232, common_pid:       2043 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2404)  { lat:        233, common_pid:       2036 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2405)  { lat:        233, common_pid:       2039 } hitcount:         11
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2406)  { lat:        234, common_pid:       2039 } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2407)  { lat:        234, common_pid:       2038 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2408)  { lat:        234, common_pid:       2043 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2409)  { lat:        234, common_pid:       2036 } hitcount:         11
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2410)  { lat:        234, common_pid:       2040 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2411)  { lat:        235, common_pid:       2037 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2412)  { lat:        235, common_pid:       2036 } hitcount:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2413)  { lat:        235, common_pid:       2043 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2414)  { lat:        235, common_pid:       2039 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2415)  { lat:        235, common_pid:       2042 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2416)  { lat:        235, common_pid:       2040 } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2417)  { lat:        235, common_pid:       2041 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2418)  { lat:        236, common_pid:       2036 } hitcount:          7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2419)  { lat:        236, common_pid:       2037 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2420)  { lat:        236, common_pid:       2041 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2421)  { lat:        236, common_pid:       2039 } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2422)  { lat:        236, common_pid:       2043 } hitcount:          9
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2423)  { lat:        236, common_pid:       2040 } hitcount:          7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2424)  { lat:        237, common_pid:       2037 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2425)  { lat:        237, common_pid:       2040 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2426)  { lat:        237, common_pid:       2036 } hitcount:          9
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2427)  { lat:        237, common_pid:       2039 } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2428)  { lat:        237, common_pid:       2043 } hitcount:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2429)  { lat:        237, common_pid:       2042 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2430)  { lat:        237, common_pid:       2041 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2431)  { lat:        238, common_pid:       2043 } hitcount:         10
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2432)  { lat:        238, common_pid:       2040 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2433)  { lat:        238, common_pid:       2037 } hitcount:          9
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2434)  { lat:        238, common_pid:       2038 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2435)  { lat:        238, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2436)  { lat:        238, common_pid:       2042 } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2437)  { lat:        238, common_pid:       2036 } hitcount:          7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2438)  { lat:        239, common_pid:       2041 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2439)  { lat:        239, common_pid:       2043 } hitcount:         11
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2440)  { lat:        239, common_pid:       2037 } hitcount:         11
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2441)  { lat:        239, common_pid:       2038 } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2442)  { lat:        239, common_pid:       2036 } hitcount:          7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2443)  { lat:        239, common_pid:       2040 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2444)  { lat:        239, common_pid:       2042 } hitcount:          9
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2445)  { lat:        240, common_pid:       2037 } hitcount:         29
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2446)  { lat:        240, common_pid:       2043 } hitcount:         15
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2447)  { lat:        240, common_pid:       2040 } hitcount:         44
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2448)  { lat:        240, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2449)  { lat:        240, common_pid:       2041 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2450)  { lat:        240, common_pid:       2038 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2451)  { lat:        240, common_pid:       2036 } hitcount:         10
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2452)  { lat:        240, common_pid:       2042 } hitcount:         13
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2453)  { lat:        241, common_pid:       2036 } hitcount:         21
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2454)  { lat:        241, common_pid:       2041 } hitcount:         36
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2455)  { lat:        241, common_pid:       2037 } hitcount:         34
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2456)  { lat:        241, common_pid:       2042 } hitcount:         14
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2457)  { lat:        241, common_pid:       2040 } hitcount:         94
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2458)  { lat:        241, common_pid:       2039 } hitcount:         12
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2459)  { lat:        241, common_pid:       2038 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2460)  { lat:        241, common_pid:       2043 } hitcount:         28
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2461)  { lat:        242, common_pid:       2040 } hitcount:        109
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2462)  { lat:        242, common_pid:       2041 } hitcount:        506
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2463)  { lat:        242, common_pid:       2039 } hitcount:        155
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2464)  { lat:        242, common_pid:       2042 } hitcount:         21
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2465)  { lat:        242, common_pid:       2037 } hitcount:         52
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2466)  { lat:        242, common_pid:       2043 } hitcount:         21
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2467)  { lat:        242, common_pid:       2036 } hitcount:         16
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2468)  { lat:        242, common_pid:       2038 } hitcount:        156
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2469)  { lat:        243, common_pid:       2037 } hitcount:         46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2470)  { lat:        243, common_pid:       2039 } hitcount:         40
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2471)  { lat:        243, common_pid:       2042 } hitcount:        119
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2472)  { lat:        243, common_pid:       2041 } hitcount:        611
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2473)  { lat:        243, common_pid:       2036 } hitcount:         69
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2474)  { lat:        243, common_pid:       2038 } hitcount:        784
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2475)  { lat:        243, common_pid:       2040 } hitcount:        323
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2476)  { lat:        243, common_pid:       2043 } hitcount:         14
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2477)  { lat:        244, common_pid:       2043 } hitcount:         35
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2478)  { lat:        244, common_pid:       2042 } hitcount:        305
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2479)  { lat:        244, common_pid:       2039 } hitcount:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2480)  { lat:        244, common_pid:       2040 } hitcount:       4515
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2481)  { lat:        244, common_pid:       2038 } hitcount:        371
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2482)  { lat:        244, common_pid:       2037 } hitcount:         31
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2483)  { lat:        244, common_pid:       2036 } hitcount:        114
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2484)  { lat:        244, common_pid:       2041 } hitcount:       3396
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2485)  { lat:        245, common_pid:       2036 } hitcount:        700
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2486)  { lat:        245, common_pid:       2041 } hitcount:       2772
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2487)  { lat:        245, common_pid:       2037 } hitcount:        268
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2488)  { lat:        245, common_pid:       2039 } hitcount:        472
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2489)  { lat:        245, common_pid:       2038 } hitcount:       2758
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2490)  { lat:        245, common_pid:       2042 } hitcount:       3833
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2491)  { lat:        245, common_pid:       2040 } hitcount:       3105
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2492)  { lat:        245, common_pid:       2043 } hitcount:        645
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2493)  { lat:        246, common_pid:       2038 } hitcount:       3451
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2494)  { lat:        246, common_pid:       2041 } hitcount:        142
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2495)  { lat:        246, common_pid:       2037 } hitcount:       5101
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2496)  { lat:        246, common_pid:       2040 } hitcount:         68
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2497)  { lat:        246, common_pid:       2043 } hitcount:       5099
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2498)  { lat:        246, common_pid:       2039 } hitcount:       5608
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2499)  { lat:        246, common_pid:       2042 } hitcount:       3723
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2500)  { lat:        246, common_pid:       2036 } hitcount:       4738
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2501)  { lat:        247, common_pid:       2042 } hitcount:        312
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2502)  { lat:        247, common_pid:       2043 } hitcount:       2385
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2503)  { lat:        247, common_pid:       2041 } hitcount:        452
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2504)  { lat:        247, common_pid:       2038 } hitcount:        792
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2505)  { lat:        247, common_pid:       2040 } hitcount:         78
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2506)  { lat:        247, common_pid:       2036 } hitcount:       2375
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2507)  { lat:        247, common_pid:       2039 } hitcount:       1834
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2508)  { lat:        247, common_pid:       2037 } hitcount:       2655
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2509)  { lat:        248, common_pid:       2037 } hitcount:         36
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2510)  { lat:        248, common_pid:       2042 } hitcount:         11
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2511)  { lat:        248, common_pid:       2038 } hitcount:        122
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2512)  { lat:        248, common_pid:       2036 } hitcount:        135
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2513)  { lat:        248, common_pid:       2039 } hitcount:         26
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2514)  { lat:        248, common_pid:       2041 } hitcount:        503
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2515)  { lat:        248, common_pid:       2043 } hitcount:         66
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2516)  { lat:        248, common_pid:       2040 } hitcount:         46
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2517)  { lat:        249, common_pid:       2037 } hitcount:         29
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2518)  { lat:        249, common_pid:       2038 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2519)  { lat:        249, common_pid:       2043 } hitcount:         29
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2520)  { lat:        249, common_pid:       2039 } hitcount:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2521)  { lat:        249, common_pid:       2042 } hitcount:         56
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2522)  { lat:        249, common_pid:       2040 } hitcount:         27
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2523)  { lat:        249, common_pid:       2041 } hitcount:         11
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2524)  { lat:        249, common_pid:       2036 } hitcount:         27
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2525)  { lat:        250, common_pid:       2038 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2526)  { lat:        250, common_pid:       2036 } hitcount:         30
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2527)  { lat:        250, common_pid:       2040 } hitcount:         19
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2528)  { lat:        250, common_pid:       2043 } hitcount:         22
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2529)  { lat:        250, common_pid:       2042 } hitcount:         20
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2530)  { lat:        250, common_pid:       2041 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2531)  { lat:        250, common_pid:       2039 } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2532)  { lat:        250, common_pid:       2037 } hitcount:         48
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2533)  { lat:        251, common_pid:       2037 } hitcount:         43
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2534)  { lat:        251, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2535)  { lat:        251, common_pid:       2036 } hitcount:         12
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2536)  { lat:        251, common_pid:       2042 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2537)  { lat:        251, common_pid:       2041 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2538)  { lat:        251, common_pid:       2043 } hitcount:         15
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2539)  { lat:        251, common_pid:       2040 } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2540)  { lat:        252, common_pid:       2040 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2541)  { lat:        252, common_pid:       2036 } hitcount:         12
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2542)  { lat:        252, common_pid:       2037 } hitcount:         21
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2543)  { lat:        252, common_pid:       2043 } hitcount:         14
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2544)  { lat:        253, common_pid:       2037 } hitcount:         21
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2545)  { lat:        253, common_pid:       2039 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2546)  { lat:        253, common_pid:       2036 } hitcount:          9
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2547)  { lat:        253, common_pid:       2043 } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2548)  { lat:        253, common_pid:       2040 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2549)  { lat:        254, common_pid:       2036 } hitcount:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2550)  { lat:        254, common_pid:       2043 } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2551)  { lat:        254, common_pid:       2041 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2552)  { lat:        254, common_pid:       2042 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2553)  { lat:        254, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2554)  { lat:        254, common_pid:       2037 } hitcount:         12
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2555)  { lat:        255, common_pid:       2043 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2556)  { lat:        255, common_pid:       2037 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2557)  { lat:        255, common_pid:       2036 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2558)  { lat:        255, common_pid:       2039 } hitcount:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2559)  { lat:        256, common_pid:       2043 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2560)  { lat:        256, common_pid:       2036 } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2561)  { lat:        256, common_pid:       2039 } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2562)  { lat:        257, common_pid:       2039 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2563)  { lat:        257, common_pid:       2036 } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2564)  { lat:        258, common_pid:       2039 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2565)  { lat:        258, common_pid:       2036 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2566)  { lat:        259, common_pid:       2036 } hitcount:          7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2567)  { lat:        259, common_pid:       2039 } hitcount:          7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2568)  { lat:        260, common_pid:       2036 } hitcount:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2569)  { lat:        260, common_pid:       2039 } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2570)  { lat:        261, common_pid:       2036 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2571)  { lat:        261, common_pid:       2039 } hitcount:          7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2572)  { lat:        262, common_pid:       2039 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2573)  { lat:        262, common_pid:       2036 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2574)  { lat:        263, common_pid:       2039 } hitcount:          7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2575)  { lat:        263, common_pid:       2036 } hitcount:          7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2576)  { lat:        264, common_pid:       2039 } hitcount:          9
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2577)  { lat:        264, common_pid:       2036 } hitcount:          9
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2578)  { lat:        265, common_pid:       2036 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2579)  { lat:        265, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2580)  { lat:        266, common_pid:       2036 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2581)  { lat:        266, common_pid:       2039 } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2582)  { lat:        267, common_pid:       2036 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2583)  { lat:        267, common_pid:       2039 } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2584)  { lat:        268, common_pid:       2036 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2585)  { lat:        268, common_pid:       2039 } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2586)  { lat:        269, common_pid:       2036 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2587)  { lat:        269, common_pid:       2043 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2588)  { lat:        269, common_pid:       2039 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2589)  { lat:        270, common_pid:       2040 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2590)  { lat:        270, common_pid:       2039 } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2591)  { lat:        271, common_pid:       2041 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2592)  { lat:        271, common_pid:       2039 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2593)  { lat:        272, common_pid:       2039 } hitcount:         10
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2594)  { lat:        273, common_pid:       2039 } hitcount:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2595)  { lat:        274, common_pid:       2039 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2596)  { lat:        275, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2597)  { lat:        276, common_pid:       2039 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2598)  { lat:        276, common_pid:       2037 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2599)  { lat:        276, common_pid:       2038 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2600)  { lat:        277, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2601)  { lat:        277, common_pid:       2042 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2602)  { lat:        278, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2603)  { lat:        279, common_pid:       2039 } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2604)  { lat:        279, common_pid:       2043 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2605)  { lat:        280, common_pid:       2039 } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2606)  { lat:        283, common_pid:       2036 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2607)  { lat:        284, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2608)  { lat:        284, common_pid:       2043 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2609)  { lat:        288, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2610)  { lat:        289, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2611)  { lat:        300, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2612)  { lat:        384, common_pid:       2039 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2613) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2614)  Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2615)      Hits: 67625
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2616)      Entries: 278
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2617)      Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2618) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2619) Note, the writes are around the sleep, so ideally they will all be of 250
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2620) microseconds. If you are wondering how there are several that are under
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2621) 250 microseconds, that is because the way cyclictest works, is if one
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2622) iteration comes in late, the next one will set the timer to wake up less that
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2623) 250. That is, if an iteration came in 50 microseconds late, the next wake up
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2624) will be at 200 microseconds.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2625) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2626) But this could easily be done in userspace. To make this even more
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2627) interesting, we can mix the histogram between events that happened in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2628) kernel with trace_marker::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2629) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2630)  # cd /sys/kernel/tracing
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2631)  # echo 'latency u64 lat' > synthetic_events
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2632)  # echo 'hist:keys=pid:ts0=common_timestamp.usecs' > events/sched/sched_waking/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2633)  # echo 'hist:keys=common_pid:lat=common_timestamp.usecs-$ts0:onmatch(sched.sched_waking).latency($lat) if buf == "end"' > events/ftrace/print/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2634)  # echo 'hist:keys=lat,common_pid:sort=lat' > events/synthetic/latency/trigger
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2635) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2636) The difference this time is that instead of using the trace_marker to start
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2637) the latency, the sched_waking event is used, matching the common_pid for the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2638) trace_marker write with the pid that is being woken by sched_waking.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2639) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2640) After running cyclictest again with the same parameters, we now have::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2641) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2642)  # cat events/synthetic/latency/hist
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2643)  # event histogram
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2644)  #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2645)  # trigger info: hist:keys=lat,common_pid:vals=hitcount:sort=lat:size=2048 [active]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2646)  #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2647) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2648)  { lat:          7, common_pid:       2302 } hitcount:        640
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2649)  { lat:          7, common_pid:       2299 } hitcount:         42
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2650)  { lat:          7, common_pid:       2303 } hitcount:         18
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2651)  { lat:          7, common_pid:       2305 } hitcount:        166
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2652)  { lat:          7, common_pid:       2306 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2653)  { lat:          7, common_pid:       2301 } hitcount:         91
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2654)  { lat:          7, common_pid:       2300 } hitcount:         17
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2655)  { lat:          8, common_pid:       2303 } hitcount:       8296
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2656)  { lat:          8, common_pid:       2304 } hitcount:       6864
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2657)  { lat:          8, common_pid:       2305 } hitcount:       9464
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2658)  { lat:          8, common_pid:       2301 } hitcount:       9213
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2659)  { lat:          8, common_pid:       2306 } hitcount:       6246
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2660)  { lat:          8, common_pid:       2302 } hitcount:       8797
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2661)  { lat:          8, common_pid:       2299 } hitcount:       8771
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2662)  { lat:          8, common_pid:       2300 } hitcount:       8119
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2663)  { lat:          9, common_pid:       2305 } hitcount:       1519
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2664)  { lat:          9, common_pid:       2299 } hitcount:       2346
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2665)  { lat:          9, common_pid:       2303 } hitcount:       2841
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2666)  { lat:          9, common_pid:       2301 } hitcount:       1846
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2667)  { lat:          9, common_pid:       2304 } hitcount:       3861
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2668)  { lat:          9, common_pid:       2302 } hitcount:       1210
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2669)  { lat:          9, common_pid:       2300 } hitcount:       2762
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2670)  { lat:          9, common_pid:       2306 } hitcount:       4247
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2671)  { lat:         10, common_pid:       2299 } hitcount:         16
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2672)  { lat:         10, common_pid:       2306 } hitcount:        333
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2673)  { lat:         10, common_pid:       2303 } hitcount:         16
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2674)  { lat:         10, common_pid:       2304 } hitcount:        168
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2675)  { lat:         10, common_pid:       2302 } hitcount:        240
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2676)  { lat:         10, common_pid:       2301 } hitcount:         28
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2677)  { lat:         10, common_pid:       2300 } hitcount:         95
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2678)  { lat:         10, common_pid:       2305 } hitcount:         18
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2679)  { lat:         11, common_pid:       2303 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2680)  { lat:         11, common_pid:       2305 } hitcount:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2681)  { lat:         11, common_pid:       2306 } hitcount:        221
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2682)  { lat:         11, common_pid:       2302 } hitcount:         76
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2683)  { lat:         11, common_pid:       2304 } hitcount:         26
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2684)  { lat:         11, common_pid:       2300 } hitcount:        125
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2685)  { lat:         11, common_pid:       2299 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2686)  { lat:         12, common_pid:       2305 } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2687)  { lat:         12, common_pid:       2300 } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2688)  { lat:         12, common_pid:       2306 } hitcount:         90
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2689)  { lat:         12, common_pid:       2302 } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2690)  { lat:         12, common_pid:       2303 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2691)  { lat:         12, common_pid:       2304 } hitcount:        122
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2692)  { lat:         13, common_pid:       2300 } hitcount:         12
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2693)  { lat:         13, common_pid:       2301 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2694)  { lat:         13, common_pid:       2306 } hitcount:         32
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2695)  { lat:         13, common_pid:       2302 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2696)  { lat:         13, common_pid:       2305 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2697)  { lat:         13, common_pid:       2303 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2698)  { lat:         13, common_pid:       2304 } hitcount:         61
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2699)  { lat:         14, common_pid:       2303 } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2700)  { lat:         14, common_pid:       2306 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2701)  { lat:         14, common_pid:       2305 } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2702)  { lat:         14, common_pid:       2304 } hitcount:         62
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2703)  { lat:         14, common_pid:       2302 } hitcount:         19
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2704)  { lat:         14, common_pid:       2300 } hitcount:         33
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2705)  { lat:         14, common_pid:       2299 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2706)  { lat:         14, common_pid:       2301 } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2707)  { lat:         15, common_pid:       2305 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2708)  { lat:         15, common_pid:       2302 } hitcount:         25
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2709)  { lat:         15, common_pid:       2300 } hitcount:         11
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2710)  { lat:         15, common_pid:       2299 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2711)  { lat:         15, common_pid:       2301 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2712)  { lat:         15, common_pid:       2304 } hitcount:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2713)  { lat:         15, common_pid:       2303 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2714)  { lat:         15, common_pid:       2306 } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2715)  { lat:         16, common_pid:       2302 } hitcount:         31
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2716)  { lat:         16, common_pid:       2306 } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2717)  { lat:         16, common_pid:       2300 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2718)  { lat:         17, common_pid:       2302 } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2719)  { lat:         17, common_pid:       2303 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2720)  { lat:         18, common_pid:       2304 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2721)  { lat:         18, common_pid:       2302 } hitcount:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2722)  { lat:         18, common_pid:       2299 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2723)  { lat:         18, common_pid:       2301 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2724)  { lat:         19, common_pid:       2303 } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2725)  { lat:         19, common_pid:       2304 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2726)  { lat:         19, common_pid:       2302 } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2727)  { lat:         19, common_pid:       2299 } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2728)  { lat:         19, common_pid:       2306 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2729)  { lat:         19, common_pid:       2300 } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2730)  { lat:         19, common_pid:       2305 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2731)  { lat:         20, common_pid:       2299 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2732)  { lat:         20, common_pid:       2302 } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2733)  { lat:         20, common_pid:       2305 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2734)  { lat:         20, common_pid:       2300 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2735)  { lat:         20, common_pid:       2301 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2736)  { lat:         20, common_pid:       2303 } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2737)  { lat:         21, common_pid:       2305 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2738)  { lat:         21, common_pid:       2299 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2739)  { lat:         21, common_pid:       2303 } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2740)  { lat:         21, common_pid:       2302 } hitcount:          7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2741)  { lat:         21, common_pid:       2300 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2742)  { lat:         21, common_pid:       2301 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2743)  { lat:         21, common_pid:       2304 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2744)  { lat:         22, common_pid:       2302 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2745)  { lat:         22, common_pid:       2303 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2746)  { lat:         22, common_pid:       2306 } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2747)  { lat:         22, common_pid:       2301 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2748)  { lat:         22, common_pid:       2300 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2749)  { lat:         22, common_pid:       2299 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2750)  { lat:         22, common_pid:       2305 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2751)  { lat:         22, common_pid:       2304 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2752)  { lat:         23, common_pid:       2299 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2753)  { lat:         23, common_pid:       2306 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2754)  { lat:         23, common_pid:       2302 } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2755)  { lat:         24, common_pid:       2302 } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2756)  { lat:         24, common_pid:       2300 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2757)  { lat:         24, common_pid:       2306 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2758)  { lat:         24, common_pid:       2305 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2759)  { lat:         24, common_pid:       2299 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2760)  { lat:         25, common_pid:       2300 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2761)  { lat:         25, common_pid:       2302 } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2762)  { lat:         26, common_pid:       2302 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2763)  { lat:         27, common_pid:       2305 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2764)  { lat:         27, common_pid:       2300 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2765)  { lat:         27, common_pid:       2302 } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2766)  { lat:         28, common_pid:       2306 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2767)  { lat:         28, common_pid:       2302 } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2768)  { lat:         29, common_pid:       2302 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2769)  { lat:         29, common_pid:       2300 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2770)  { lat:         29, common_pid:       2306 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2771)  { lat:         29, common_pid:       2304 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2772)  { lat:         30, common_pid:       2302 } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2773)  { lat:         31, common_pid:       2302 } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2774)  { lat:         32, common_pid:       2302 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2775)  { lat:         33, common_pid:       2299 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2776)  { lat:         33, common_pid:       2302 } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2777)  { lat:         34, common_pid:       2302 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2778)  { lat:         35, common_pid:       2302 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2779)  { lat:         35, common_pid:       2304 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2780)  { lat:         36, common_pid:       2302 } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2781)  { lat:         37, common_pid:       2302 } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2782)  { lat:         38, common_pid:       2302 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2783)  { lat:         39, common_pid:       2302 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2784)  { lat:         39, common_pid:       2304 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2785)  { lat:         40, common_pid:       2304 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2786)  { lat:         40, common_pid:       2302 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2787)  { lat:         41, common_pid:       2304 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2788)  { lat:         41, common_pid:       2302 } hitcount:          8
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2789)  { lat:         42, common_pid:       2302 } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2790)  { lat:         42, common_pid:       2304 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2791)  { lat:         43, common_pid:       2302 } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2792)  { lat:         43, common_pid:       2304 } hitcount:          4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2793)  { lat:         44, common_pid:       2302 } hitcount:          6
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2794)  { lat:         45, common_pid:       2302 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2795)  { lat:         46, common_pid:       2302 } hitcount:          5
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2796)  { lat:         47, common_pid:       2302 } hitcount:          7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2797)  { lat:         48, common_pid:       2301 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2798)  { lat:         48, common_pid:       2302 } hitcount:          9
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2799)  { lat:         49, common_pid:       2302 } hitcount:          3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2800)  { lat:         50, common_pid:       2302 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2801)  { lat:         50, common_pid:       2301 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2802)  { lat:         51, common_pid:       2302 } hitcount:          2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2803)  { lat:         51, common_pid:       2301 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2804)  { lat:         61, common_pid:       2302 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2805)  { lat:        110, common_pid:       2302 } hitcount:          1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2806) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2807)  Totals:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2808)      Hits: 89565
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2809)      Entries: 158
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2810)      Dropped: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2811) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2812) This doesn't tell us any information about how late cyclictest may have
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2813) woken up, but it does show us a nice histogram of how long it took from
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2814) the time that cyclictest was woken to the time it made it into user space.