NAME¶

utrace_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

engine

exam

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.