UTRACE_FINISH_EXAMIN(9) utrace core API UTRACE_FINISH_EXAMIN(9)NAMEutrace_finish_examine - complete an examination of thread state
SYNOPSIS
int utrace_finish_examine(struct task_struct * target,
struct utrace_engine * engine,
struct utrace_examiner * exam);
ARGUMENTS
target
thread of interest, a struct task_struct pointer
engine
engine pointer returned by utrace_attach_task
exam
pointer passed to utrace_prepare_examine call
DESCRIPTION
This call completes an examination on the thread target begun by a
paired utrace_prepare_examine call with the same arguments that
returned success (zero).
When target is current, this call is superfluous. When target is
another thread, this returns zero if target has remained unscheduled
since the paired utrace_prepare_examine call returned zero.
When this returns an error, any examination done since the paired
utrace_prepare_examine call is unreliable and the data extracted should
be discarded. The error is -EINVAL if engine is not keeping target
stopped, or -EAGAIN if target woke up unexpectedly.
Kernel Hackers Manual 2.6. November 2013 UTRACE_FINISH_EXAMIN(9)