diff options
Diffstat (limited to 'stapprobes.5.in')
| -rw-r--r-- | stapprobes.5.in | 41 |
1 files changed, 26 insertions, 15 deletions
diff --git a/stapprobes.5.in b/stapprobes.5.in index 3633fd39..5d400cb6 100644 --- a/stapprobes.5.in +++ b/stapprobes.5.in @@ -256,7 +256,12 @@ linux source directory, although an absolute path may be necessary for some kern If a relative pathname doesn't work, try absolute. .IP \(bu 4 Finally, the third part is optional if the file name part was given, -and identifies the line number in the source file, preceded by a ":". +and identifies the line number in the source file preceded by a ":" +or a "+". The line number is assumed to be an +absolute line number if preceded by a ":", or relative to the entry of +the function if preceded by a "+". +All the lines in the function can be matched with ":*". +A range of lines x through y can be matched with ":x-y". .PP As an alternative, PATTERN may be a numeric constant, indicating an (module-relative or kernel-_stext-relative) address. In guru mode @@ -309,12 +314,14 @@ All threads of that process will be probed. .PP Additional user-space probing is available in the following forms: .SAMPLE -process(PID).clone -process("PATH").clone -process(PID).exec -process("PATH").exec -process(PID).death -process("PATH").death +process(PID).begin +process("PATH").begin +process(PID).thread.begin +process("PATH").thread.begin +process(PID).end +process("PATH").end +process(PID).thread.end +process("PATH").thread.end process(PID).syscall process("PATH").syscall process(PID).syscall.return @@ -322,15 +329,16 @@ process("PATH").syscall.return .ESAMPLE .PP A -.B .clone -probe gets called when a thread described by PID or PATH creates a new -thread. +.B .begin +probe gets called when new process described by PID or PATH gets created. A -.B .exec -probe gets called when a thread described by PID or PATH returns from -.IR exec() . +.B .thread.begin +probe gets called when a new thread described by PID or PATH gets created. A -.B .death +.B .end +probe gets called when process described by PID or PATH dies. +A +.B .thread.end probe gets called when a thread described by PID or PATH dies. A .B .syscall @@ -490,7 +498,10 @@ refers to the first byte of the statement whose compiled instructions include the given address in the kernel. .TP kernel.statement("*@kernel/sched.c:2917") -refers to the statement of line 2917 within the "kernel/sched.c". +refers to the statement of line 2917 within "kernel/sched.c". +.TP +kernel.statement("bio_init@fs/bio.c+3") +refers to the statement at line bio_init+3 within "fs/bio.c". .TP syscall.*.return refers to the group of probe aliases with any name in the third position |