suse man page for utrace_finish_examine

UTRACE_FINISH_EXAMIN(9) 					  utrace core API					   UTRACE_FINISH_EXAMIN(9)

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
	   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.					     July 2010						   UTRACE_FINISH_EXAMIN(9)