1UTRACE_FINISH_EXAMIN(9)         utrace core API        UTRACE_FINISH_EXAMIN(9)
2
3
4

NAME

6       utrace_finish_examine - complete an examination of thread state
7

SYNOPSIS

9       int utrace_finish_examine(struct task_struct * target,
10                                 struct utrace_engine * engine,
11                                 struct utrace_examiner * exam);
12

ARGUMENTS

14       target
15           thread of interest, a struct task_struct pointer
16
17       engine
18           engine pointer returned by utrace_attach_task
19
20       exam
21           pointer passed to utrace_prepare_examine call
22

DESCRIPTION

24       This call completes an examination on the thread target begun by a
25       paired utrace_prepare_examine call with the same arguments that
26       returned success (zero).
27
28       When target is current, this call is superfluous. When target is
29       another thread, this returns zero if target has remained unscheduled
30       since the paired utrace_prepare_examine call returned zero.
31
32       When this returns an error, any examination done since the paired
33       utrace_prepare_examine call is unreliable and the data extracted should
34       be discarded. The error is -EINVAL if engine is not keeping target
35       stopped, or -EAGAIN if target woke up unexpectedly.
36
37
38
39Kernel Hackers Manual 2.6.         June 2019           UTRACE_FINISH_EXAMIN(9)
Impressum