From b71b19f0a262fc3263f5272cdbebf25e10dca6fa Mon Sep 17 00:00:00 2001 From: marcel Date: Mon, 12 Jul 2004 04:43:58 +0000 Subject: Document the new PT_LWPINFO request. In fact, the request is so new it hasn't even been implemented yet. I just wanted to be the first to try a new approach to development ;-) --- lib/libc/sys/ptrace.2 | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) (limited to 'lib') diff --git a/lib/libc/sys/ptrace.2 b/lib/libc/sys/ptrace.2 index 18683fa..a8910d7 100644 --- a/lib/libc/sys/ptrace.2 +++ b/lib/libc/sys/ptrace.2 @@ -278,6 +278,25 @@ it loads the traced process's debug registers from the .In machine/reg.h ) pointed to by .Fa addr . +.It Dv PT_LWPINFO +This request can be used to obtain information about the kernel thread, +also known as light-weight process, that caused the traced process to stop. +The +.Fa addr +argument specifies a pointer to a +.Vt "struct ptrace_lwpinfo" , +which is defined as follows: +.Bd -literal +struct ptrace_lwpinfo { + lwpid_t pl_lwpid; /* LWP described. */ + int pl_event; /* Event received. */ +}; +.Ed +.Pp +The +.Fa data +argument is to be set to the size of the structure known to the caller. +This allows the structure to grow without affecting older programs. .El .Pp Additionally, machine-specific requests can exist. -- cgit v1.1