1*24205027SMateusz Piotrowski.\" 2*24205027SMateusz Piotrowski.\" SPDX-License-Identifier: BSD-2-Clause 3*24205027SMateusz Piotrowski.\" 4*24205027SMateusz Piotrowski.\" Copyright (c) 2026 Mateusz Piotrowski <0mp@FreeBSD.org> 5*24205027SMateusz Piotrowski.\" 6*24205027SMateusz Piotrowski.Dd May 7, 2026 7*24205027SMateusz Piotrowski.Dt DTRACE_SYSCALL 4 8*24205027SMateusz Piotrowski.Os 9*24205027SMateusz Piotrowski.Sh NAME 10*24205027SMateusz Piotrowski.Nm dtrace_syscall 11*24205027SMateusz Piotrowski.Nd a DTrace provider for system calls 12*24205027SMateusz Piotrowski.Sh SYNOPSIS 13*24205027SMateusz Piotrowski.Nm syscall Ns Cm \&: Ns Ar abi Ns Cm \&: Ns Ar syscall Ns Cm :entry 14*24205027SMateusz Piotrowski.Nm syscall Ns Cm \&: Ns Ar abi Ns Cm \&: Ns Ar syscall Ns Cm :return 15*24205027SMateusz Piotrowski.Sh DESCRIPTION 16*24205027SMateusz PiotrowskiThe 17*24205027SMateusz Piotrowski.Nm syscall 18*24205027SMateusz Piotrowskiprovider provides entry and return probes for system calls. 19*24205027SMateusz Piotrowski.Pp 20*24205027SMateusz PiotrowskiThe module in the probe's description is 21*24205027SMateusz Piotrowski.Ar abi , 22*24205027SMateusz Piotrowskiwhich indicates what system call ABI a 23*24205027SMateusz Piotrowski.Ar syscall 24*24205027SMateusz Piotrowskibelongs to. 25*24205027SMateusz Piotrowski.Nm 26*24205027SMateusz Piotrowskisupports the following system call ABIs: 27*24205027SMateusz Piotrowski.Pp 28*24205027SMateusz Piotrowski.Bl -tag -offset indent -width freebsd32 -compact 29*24205027SMateusz Piotrowski.It Cm freebsd 30*24205027SMateusz PiotrowskiNative ABI. 31*24205027SMateusz Piotrowski.It Cm freebsd32 32*24205027SMateusz PiotrowskiNon-native, 32-bit ABI. 33*24205027SMateusz Piotrowski.It Cm linux 34*24205027SMateusz PiotrowskiRefer to 35*24205027SMateusz Piotrowski.Xr linux 4 . 36*24205027SMateusz Piotrowski.It Cm linux32 37*24205027SMateusz PiotrowskiRefer to 38*24205027SMateusz Piotrowski.Xr linux 4 . 39*24205027SMateusz Piotrowski.El 40*24205027SMateusz Piotrowski.Pp 41*24205027SMateusz PiotrowskiThe arguments to the 42*24205027SMateusz Piotrowski.Cm entry 43*24205027SMateusz Piotrowskiprobes are the arguments passed to the system call. 44*24205027SMateusz Piotrowski.Pp 45*24205027SMateusz PiotrowskiThe 46*24205027SMateusz Piotrowski.Cm return 47*24205027SMateusz Piotrowskiprobe stores the system call's return value in both 48*24205027SMateusz Piotrowski.Fa arg0 49*24205027SMateusz Piotrowskiand 50*24205027SMateusz Piotrowski.Fa arg1 . 51*24205027SMateusz Piotrowski.Pp 52*24205027SMateusz PiotrowskiInspect the 53*24205027SMateusz Piotrowski.Xr d 7 Ap s 54*24205027SMateusz Piotrowski.Va errno 55*24205027SMateusz Piotrowskivariable to check if a system call failed. 56*24205027SMateusz Piotrowski.Sh EXAMPLES 57*24205027SMateusz Piotrowski.Ss Example 1 : Count Up System Calls 58*24205027SMateusz PiotrowskiThe following script traces all system calls and counts them for every process 59*24205027SMateusz Piotrowskion the system. 60*24205027SMateusz Piotrowski.Bd -literal -offset 2n 61*24205027SMateusz Piotrowskisyscall:::entry { 62*24205027SMateusz Piotrowski @[execname, pid] = count(); 63*24205027SMateusz Piotrowski} 64*24205027SMateusz Piotrowski.Ed 65*24205027SMateusz Piotrowski.Sh SEE ALSO 66*24205027SMateusz Piotrowski.Xr dtrace 1 , 67*24205027SMateusz Piotrowski.Xr intro 2 , 68*24205027SMateusz Piotrowski.Xr tracing 7 69*24205027SMateusz Piotrowski.Rs 70*24205027SMateusz Piotrowski.%B The illumos Dynamic Tracing Guide 71*24205027SMateusz Piotrowski.%O Chapter syscall Provider 72*24205027SMateusz Piotrowski.%D 2008 73*24205027SMateusz Piotrowski.%U https://illumos.org/books/dtrace/chp-syscall.html 74*24205027SMateusz Piotrowski.Re 75*24205027SMateusz Piotrowski.Rs 76*24205027SMateusz Piotrowski.%A Brendan Gregg 77*24205027SMateusz Piotrowski.%A Jim Mauro 78*24205027SMateusz Piotrowski.%B DTrace: Dynamic Tracing in Oracle Solaris, Mac OS X and FreeBSD 79*24205027SMateusz Piotrowski.%I Prentice Hall 80*24205027SMateusz Piotrowski.%O Chapter Syscall Provider 81*24205027SMateusz Piotrowski.%P pp. 315\(en327 82*24205027SMateusz Piotrowski.%D 2011 83*24205027SMateusz Piotrowski.%U https://www.brendangregg.com/dtracebook/ 84*24205027SMateusz Piotrowski.Re 85*24205027SMateusz Piotrowski.Sh AUTHORS 86*24205027SMateusz PiotrowskiThis manual page was written by 87*24205027SMateusz Piotrowski.An Mateusz Piotrowski Aq Mt 0mp@FreeBSD.org . 88