[src/trunk]: src/share/man/man2 Document TRAP_SCE and TRAP_SCX in siginfo(2)

[kamil <kamil%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/0f77531374fc
branches:  trunk
changeset: 999214:0f77531374fc
user:      kamil <kamil%NetBSD.org@localhost>
date:      Sat May 25 05:11:14 2019 +0000

description:
Document TRAP_SCE and TRAP_SCX in siginfo(2)

diffstat:

 share/man/man2/siginfo.2 |  74 ++++++++++++++++++++++++++++++++++++++---------
 1 files changed, 59 insertions(+), 15 deletions(-)

diffs (138 lines):

diff -r 48aee589a3d8 -r 0f77531374fc share/man/man2/siginfo.2
--- a/share/man/man2/siginfo.2  Sat May 25 04:41:53 2019 +0000
+++ b/share/man/man2/siginfo.2  Sat May 25 05:11:14 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: siginfo.2,v 1.22 2017/02/17 01:14:31 kamil Exp $
+.\"    $NetBSD: siginfo.2,v 1.23 2019/05/25 05:11:14 kamil Exp $
 .\"
 .\" Copyright (c) 2003 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd January 14, 2017
+.Dd May 25, 2019
 .Dt SIGINFO 2
 .Os
 .Sh NAME
@@ -237,6 +237,10 @@
 Process exec trap
 .It TRAP_LWP
 Process LWP trap
+.It TRAP_SCE
+Process syscall entry trap
+.It TRAP_SCX
+Process syscall exit trap
 .It TRAP_TRACE
 Process trace trap
 .El
@@ -273,9 +277,11 @@
 .El
 .Pp
 For
-.Dv SIGILL , SIGFPE ,
+.Dv SIGILL ,
+.Dv SIGFPE , 
+.Dv SIGBUS
 and
-.Dv SIGTRAP
+.Dv SIGSEGV
 the
 .Nm
 structure contains the following additional members:
@@ -285,14 +291,17 @@
 .Ed
 .Pp
 .Fa si_addr
-contains the address of the faulting instruction and
+contains the address of the faulting instruction or data and
 .Fa si_trap
 contains a hardware specific reason.
 .Pp
 For
-.Dv SIGBUS
+.Dv SIGTRAP
 and
-.Dv SIGSEGV
+.Dv TRAP_BRKPT ,
+.Dv TRAP_TRACE
+or
+.Dv TRAP_DBREG
 the
 .Nm
 structure contains the following additional members:
@@ -306,10 +315,34 @@
 .Fa si_trap
 contains a hardware specific reason.
 .Pp
-For some architectures
-the value of
-.Fa si_addr
-may be inaccurate.
+For
+.Dv SIGTRAP
+and
+.Dv TRAP_SCE
+or
+.Dv TRAP_SCX
+the
+.Nm
+structure contains the following additional members:
+.Bd -literal -offset indent
+int si_sysnum;
+int si_retval[2];
+int si_error;
+uint64_t si_args[8];
+.Ed
+.Pp
+.Fa si_sysnum
+contains the syscall number,
+.Fa si_retval
+contains the syscall return value (meaningful for
+.Dv TRAP_SCX
+only),
+.Fa si_error
+contains the syscall error value (meaningful for
+.Dv TRAP_SCX
+only) and
+.Fa si_args[8]
+contains the syscall arguments,
 .Pp
 For
 .Dv SIGIO
@@ -374,9 +407,11 @@
 The
 .Dv TRAP_CHLD ,
 .Dv TRAP_DBREG ,
-.Dv TRAP_EXEC
+.Dv TRAP_EXEC ,
+.Dv TRAP_LWP ,
+.Dv TRAP_SCE
 and
-.Dv TRAP_LWP
+.Dv TRAP_SCX
 signal specific reasons of
 .Dv SIGTRAP
 are
@@ -390,9 +425,18 @@
 .Pp
 .Dv TRAP_CHLD ,
 .Dv TRAP_DBREG ,
-.Dv TRAP_EXEC
+.Dv TRAP_EXEC ,
+.Dv TRAP_LWP ,
+.Dv TRAP_SCE
 and
-.Dv TRAP_LWP
+.Dv TRAP_SCX
 first appeared
 in
 .Nx 8 .
+.Pp
+The additional parameters with syscall information in
+.Dv TRAP_SCE
+and
+.Dv TRAP_SCX
+first appeared in
+.Nx 9 .