diff options
Diffstat (limited to 'Documentation')
| -rw-r--r-- | Documentation/trace/kprobetrace.txt | 16 |
1 files changed, 15 insertions, 1 deletions
diff --git a/Documentation/trace/kprobetrace.txt b/Documentation/trace/kprobetrace.txt index 5f77d94598dd..6d27ab8d6e9f 100644 --- a/Documentation/trace/kprobetrace.txt +++ b/Documentation/trace/kprobetrace.txt | |||
| @@ -42,11 +42,25 @@ Synopsis of kprobe_events | |||
| 42 | +|-offs(FETCHARG) : Fetch memory at FETCHARG +|- offs address.(**) | 42 | +|-offs(FETCHARG) : Fetch memory at FETCHARG +|- offs address.(**) |
| 43 | NAME=FETCHARG : Set NAME as the argument name of FETCHARG. | 43 | NAME=FETCHARG : Set NAME as the argument name of FETCHARG. |
| 44 | FETCHARG:TYPE : Set TYPE as the type of FETCHARG. Currently, basic types | 44 | FETCHARG:TYPE : Set TYPE as the type of FETCHARG. Currently, basic types |
| 45 | (u8/u16/u32/u64/s8/s16/s32/s64) and string are supported. | 45 | (u8/u16/u32/u64/s8/s16/s32/s64), "string" and bitfield |
| 46 | are supported. | ||
| 46 | 47 | ||
| 47 | (*) only for return probe. | 48 | (*) only for return probe. |
| 48 | (**) this is useful for fetching a field of data structures. | 49 | (**) this is useful for fetching a field of data structures. |
| 49 | 50 | ||
| 51 | Types | ||
| 52 | ----- | ||
| 53 | Several types are supported for fetch-args. Kprobe tracer will access memory | ||
| 54 | by given type. Prefix 's' and 'u' means those types are signed and unsigned | ||
| 55 | respectively. Traced arguments are shown in decimal (signed) or hex (unsigned). | ||
| 56 | String type is a special type, which fetches a "null-terminated" string from | ||
| 57 | kernel space. This means it will fail and store NULL if the string container | ||
| 58 | has been paged out. | ||
| 59 | Bitfield is another special type, which takes 3 parameters, bit-width, bit- | ||
| 60 | offset, and container-size (usually 32). The syntax is; | ||
| 61 | |||
| 62 | b<bit-width>@<bit-offset>/<container-size> | ||
| 63 | |||
| 50 | 64 | ||
| 51 | Per-Probe Event Filtering | 65 | Per-Probe Event Filtering |
| 52 | ------------------------- | 66 | ------------------------- |
