suse man page for utrace_attach_pid

UTRACE_ATTACH_PID(9)						  utrace core API					      UTRACE_ATTACH_PID(9)

NAME
       utrace_attach_pid - attach new engine, or look up an attached engine

SYNOPSIS
       struct utrace_engine * utrace_attach_pid(struct pid * pid, int flags, const struct utrace_engine_ops * ops, void * data);

ARGUMENTS
       pid

	   struct pid pointer representing thread to attach to

       flags
	   flag bits combined with OR, see utrace_attach_task

       ops
	   callback table for new engine

       data
	   engine private data pointer

DESCRIPTION
       This is the same as utrace_attach_task, but takes a struct pid pointer rather than a struct task_struct pointer. The caller must hold a ref
       on pid, but does not need to worry about the task staying valid. If it's been reaped so that pid points nowhere, then this call returns
       -ESRCH.

Kernel Hackers Manual 2.6.					     July 2010						      UTRACE_ATTACH_PID(9)