Module Name: src Committed By: kamil Date: Sat May 25 05:11:14 UTC 2019
Modified Files: src/share/man/man2: siginfo.2 Log Message: Document TRAP_SCE and TRAP_SCX in siginfo(2) To generate a diff of this commit: cvs rdiff -u -r1.22 -r1.23 src/share/man/man2/siginfo.2 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
Modified files: Index: src/share/man/man2/siginfo.2 diff -u src/share/man/man2/siginfo.2:1.22 src/share/man/man2/siginfo.2:1.23 --- src/share/man/man2/siginfo.2:1.22 Fri Feb 17 01:14:31 2017 +++ src/share/man/man2/siginfo.2 Sat May 25 05:11:14 2019 @@ -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 hardware debug register trap 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 @@ High priority input available .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 @@ int si_trap; .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 @@ contains the address of the faulting dat .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 @@ extensions. 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 @@ functionality first appeared in .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 .