Changes in Makefile

434283fda99e89af20c3fe95fde427624ae96d04 - dwatch: add nine diagnostic modules; grow errno, io, proc, sched

Wed, 29 Jul 2026 01:32:57 +0200

dwatch: add nine diagnostic modules; grow errno, io, proc, schedGrow the module collection to answer, each with a single command, thefirst questions asked when diagnosing a sick system: why is myapplication stalling, where is the kernel fighting over locks, whatfile could it not find, why is this process getting EPERM, what killedmy process, will that fatal signal actually leave a core behind, whatwas my process stuck on, where is my kernel memory going, who iscreating or entering jails, is the network slow because TCP isresending, how long did my thread wait to run, and is the disk itselfslow. Every module keeps to the house style: invocation-nameoverloading through hard links, predicate-only D with inline lookuptables (no if-statements), and stable providers only (syscall, proc,sched, io, dtmalloc, and the lockstat, vfs, priv, and mib SDTproviders), so the modules remain drop-in compatible with olderreleases (the one documented exception is noted below). No kernelchanges: new and extended profiles under cddl/usr.sbin/dwatch/libexecplus one libdtrace inline table (priv.d).slow (slow-fsync, slow-open, slow-read, slow-syscall, slow-write, orany slow-NAME by new link) records syscall entry timestamps inthread-local storage and prints, at return, any call whose latencymeets a threshold (DWATCH_SLOW_MS, default 100), naming the syscall,the elapsed time to the microsecond, and any errno returned. The bareprofile watches a curated set of filesystem-related calls expected tobe fast; slow-syscall watches everything; unrecognized invocationnames fall through to syscall::NAME:return with the matching entryprobe derived mechanically from the return probe list.lock (lock-adaptive, lock-block, lock-lockmgr, lock-rw, lock-spin,lock-sx, lock-thread) rides the dtrace_lockstat(4) block and spinprobes, printing the held-off thread (free from the standard eventtag), the holdoff duration, the lock class, the lo_name of the lockthrough a single cast of arg0 to struct lock_object (the first memberof every kernel lock), and reader/writer intent on the probes thatreport it. Holdoffs shorter than DWATCH_LOCK_MS (default 1; 0 showseverything) are suppressed.namei (namei-enoent, namei-entry, namei-failure) records the pathnameat vfs:namei:lookup:entry and reports it with the result at return.Unlike the vop_lookup profile, which reconstructs paths from the namecache one component at a time, this sees the whole path exactly as theprocess requested it. namei-enoent hunts file-not-found storms -- thesingle most common use of truss(1) -- without stopping the victim.priv (priv-err, priv-ok) watches priv_check(9) verdicts, naming theexact privilege denied -- something no syscall tracer can see, becauseby the time EPERM surfaces the priv(9) value is gone. The number isdecoded by priv_string[], a new libdtrace inline table in the errno.dand signal.d tradition, mechanically generated from sys/priv.h (247entries) and installed to /usr/lib/dtrace where dtrace(1) auto-loadsit; on older releases it is a drop-in file like the module itself.coredump (coredump-top) watches for delivery of signals whose defaultaction produces a core, per the SIGPROP_CORE entries of the sigproptblin kern_sig.c, and renders a verdict the same way and in the sameorder the kernel will decide it: ignored or caught per the target'sstruct sigacts, then the coredump() gauntlet of kern.coredump,kern.sugid_coredump vs P_SUGID, procctl(2) PROC_TRACE_CTL, andRLIMIT_CORE -- the sysctl knobs read live through kernel globals.Where a coredump-worthy signal will produce no core, the verdict saysprecisely which policy ate it. coredump-top maintains a cumulativecatalog of coredump-worthy signals by process and signal, refreshedevery 3 seconds in the style of systop; combine the event profile with`-O cmd' to capture state as each event occurs.hang (hang-top) pairs sched:::sleep with sched:::wakeup through atid-keyed timestamp array and prints, as each thread wakes, any sleepthat meets a threshold (DWATCH_HANG_MS, default 1000), naming thesleeper in the details and the waker in the standard event tag. Thisis the blocking the slow module structurally cannot see: a syscallthat never returns never reports its latency, while hang reports themoment the wait ends, with the full duration. hang-top maintains acumulative catalog of long sleeps by process (count and maximum) inthe style of coredump-top.jail (jail-attach, jail-get, jail-remove, jail-set) watches the jailmanagement plane -- jail(2), jail_set(2), jail_get(2), jail_attach(2),and jail_remove(2) -- naming the operation, the jail id (taken fromthe entry argument for attach/remove, from the return value for theothers), and any errno. Complements the dwatch `-j jail' filter,which scopes any profile to processes inside one jail; this watcheswho manipulates jails, from any jail or none.dtmalloc (dtmalloc-top, or any dtmalloc-NAME by new link) rides thedtmalloc provider (one malloc and one free probe per malloc(9) type).The event profile prints allocations and frees meeting a sizethreshold (DWATCH_MALLOC_MIN, default 65536) -- who is allocating hugekernel buffers. dtmalloc-top maintains a running catalog of net bytesand outstanding allocation balance by type, sorted by net bytes soleak suspects rise: a type that climbs without bound while the systemis in steady state is the suspect. The catalog reflects activitysince the watch began, and is honest about caches holding what theyallocate.mib (tcp-retransmit, or any mib-NAME by new link) rides theper-counter mib SDT probes of the network stack. The tcp-retransmitprofile curates the counters that signal send-path congestion or loss-- data packet retransmissions, unnecessary retransmissions,retransmit timer expirations, and connections dropped by retransmitexhaustion -- decoded through an inline description table, answering"is this network slow because TCP is resending?" as events withprocess context rather than netstat(1) deltas. NB: the mib probesexist only in kernels built with options KDTRACE_MIB_SDT (default in-CURRENT via std.debug); the module documents this and dtrace(1)refuses the script elsewhere, making the dependency self-announcing.Four existing modules gain personalities. proc growsproc-signal-fatal, filtering signal-send to signals whose defaultdisposition terminates the receiver, most-notably includingkernel-generated SIGSEGV/SIGBUS/SIGILL/SIGFPE that no kill(2) watcherwill ever see. errno now reads its invocation name: errno-NAME showsonly syscalls returning that errno, where NAME is a symbolic name fromerrno.d or a number; links are installed for errno-EACCES,errno-ECAPMODE, errno-ENOENT, errno-ENOTCAPABLE, and errno-EPERM (thelatter pairs covering capsicum(4) capability-mode violations), and anyother errno needs only a new link. sched grows sched-latency,recording a timestamp at sched:::enqueue keyed by tid and printing atsched:::on-cpu any run-queue wait meeting a threshold (DWATCH_SCHED_MS,default 10) -- the literal measurement of scheduler delay on a systemwith idle CPU that still feels sluggish. io grows io-slow, pairingio:::start with io:::done through a bio-keyed timestamp array andprinting any request that meets a threshold (DWATCH_IO_MS, default100), naming the device, command, size, and elapsed time; watchedagainst zvols and a pool's leaf vdevs this brackets where in a ZFSstack the time is going, without touching unstable providers.Document all of the above plus the DWATCH_HANG_MS, DWATCH_IO_MS,DWATCH_LOCK_MS, DWATCH_MALLOC_MIN, DWATCH_SCHED_MS, and DWATCH_SLOW_MSknobs in dwatch(1).All 46 new invocation names were exercised through `dwatch -d' with aprofile-path sandbox emulating the installed hard links: every onesources cleanly and emits the intended D -- probe selection per alias,entry/return and sleep/wakeup pairing through thread-local and globalassociative arrays, threshold and mask predicates picking up theirknobs, aggregation clauses and printa column layout in the -topprofiles, multi-line predicate rendering, and `-t' correctlydisplacing each module's default test were verified by inspection ofthe generated scripts. Invocations untouched by this pass generate Didentical to their previous output. Modules pass sh -n, fit 80columns, and dwatch.1 passes mandoc -Tlint with no new warnings. Avalidation harness performing a `dwatch -e' compile per profileagainst the live kernel globs every staged profile for runs whereverthe dtrace device is present.Reviewed by: markjDifferential Revision: https://reviews.freebsd.org/D58093 List of files: /freebsd/cddl/lib/libdtrace/Makefile

efb77950fdd6fb03dc172a44b3875948609b7804 - dtrace: Add definitiosn for the cam dtrace provider

Thu, 08 Jan 2026 07:20:28 +0100

dtrace: Add definitiosn for the cam dtrace providerSponsored by: NetflixReviewed by: adrianDifferential Revision: https://reviews.freebsd.org/D54471 List of files: /freebsd/cddl/lib/libdtrace/Makefile

e928afc531e68b7a142ee49d8f7e5c8426d54033 - Use ZFSTOP more broadly

Mon, 24 Nov 2025 16:47:10 +0100

Use ZFSTOP more broadlyReviewed by: brooksObtained from: CheriBSDDifferential Revision: https://reviews.freebsd.org/D53791 List of files: /freebsd/cddl/lib/libdtrace/Makefile

4303bde4297a3d19cabdb08ce1550f682578d2ba - zfs: fix build after openzfs/zfs@e63d026b9

Sun, 16 Nov 2025 12:15:14 +0100

zfs: fix build after openzfs/zfs@e63d026b9Fix MakefilesUpdate zfs_config.h and zfs_gitrev.h List of files: /freebsd/cddl/lib/libdtrace/Makefile

e9ac41698b2f322d55ccf9da50a3596edb2c1800 - Remove residual blank line at start of Makefile

Mon, 15 Jul 2024 06:46:32 +0200

Remove residual blank line at start of MakefileThis is a residual of the $FreeBSD$ removal.MFC After: 3 days (though I'll just run the command on the branches)Sponsored by: Netflix List of files: /freebsd/cddl/lib/libdtrace/Makefile

93f27766a7e1af009c5b1e4ca538632857c91aa1 - dtrace: Add the 'oformat' libdtrace option

Wed, 03 Jan 2024 15:58:01 +0100

dtrace: Add the 'oformat' libdtrace optionThis option can be used to specify a format to use in DTrace output.The following formats are supported: - json - xml - html - none (default DTrace output)This is implemented using libxo and integrated into libdtrace. Clientcode only works with the following API: - dtrace_oformat_setup(dtrace_hdl_t *) -- to be called when output is starting. - dtrace_oformat_teardown(dtrace_hdl_t *) -- to be called when output is finished - dtrace_oformat(dtrace_hdl_t *) -- check if oformat is enabled. - dtrace_set_outfp(FILE *) -- sets the output file for oformat. - Ensure that oformat is correctly checked in the drop handler and record processing callbacks.This commit also adds tests which check if the generated output isvalid (JSON, XML) and extends the dtrace(1) describing the structured output.Reviewed by: markjDiscussed with: philMFC after: 2 monthsSponsored by: Innovate UKDifferential Revision: https://reviews.freebsd.org/D41745 List of files: /freebsd/cddl/lib/libdtrace/Makefile

d0b2dbfa0ecf2bbc9709efc5e20baf8e4b44bbbf - Remove $FreeBSD$: one-line sh pattern

Wed, 16 Aug 2023 19:55:03 +0200

Remove $FreeBSD$: one-line sh patternRemove /^\s*#[#!]?\s*\$FreeBSD\$.*$\n/ List of files: /freebsd/cddl/lib/libdtrace/Makefile

6de02228409fd2b7ca1d7e3b8d9043a105093cdd - dtrace: Add WITH_DTRACE_ASAN

Wed, 02 Aug 2023 02:10:46 +0200

dtrace: Add WITH_DTRACE_ASANSee commit 4ae6991228105eb34989c870194ae7b0a1e23be4. This version ofthe commit avoids inadvertently changing SHLIBDIR for libdtrace.so. List of files: /freebsd/cddl/lib/libdtrace/Makefile

5cdaac92e119d41063d4f0155a78a4abe767f15e - dtrace: Revert the addition of WITH_DTRACE_ASAN

Tue, 01 Aug 2023 19:01:37 +0200

dtrace: Revert the addition of WITH_DTRACE_ASANThe follow-up fix triggers a lib32 build failure, revert everythinguntil the problem is addressed. List of files: /freebsd/cddl/lib/libdtrace/Makefile

848ff9bc1b97b04a0b7328ec7079fb031fef452d - libdtrace: Explicitly set SHLIBDIR and SHLIB_MAJOR

Tue, 01 Aug 2023 16:11:23 +0200

libdtrace: Explicitly set SHLIBDIR and SHLIB_MAJORThey were previously being defined by cddl/lib/Makefile.inc, and as ofcommit 4ae699122810 were being overridden by defaults in bsd.own.mk,which changed SHLIBDIR to /usr/lib.Reported by: Domagoj Stolfa Fixes: 4ae699122810 ("dtrace: Add WITH_DTRACE_ASAN") List of files: /freebsd/cddl/lib/libdtrace/Makefile

4ae6991228105eb34989c870194ae7b0a1e23be4 - dtrace: Add WITH_DTRACE_ASAN

Thu, 27 Jul 2023 20:27:42 +0200

dtrace: Add WITH_DTRACE_ASANThis option is a blanket for all the DTrace-related software. The optionwhen enabled passes in -fsanitize=address -fsanitize=undeifned, enablingASAN and UBSAN in the following components: - libdtrace - dtrace(1) - lockstat(1) - plockstat(1)The option defaults to "no" and is intended as a developer aid.Reviewed by: markjDifferential Revision: https://reviews.freebsd.org/D41157 List of files: /freebsd/cddl/lib/libdtrace/Makefile

21a16d55cc15b12809b982c2026a26bcf97fe79b - dtrace: add register bindings for arm64

Tue, 23 May 2023 16:19:25 +0200

dtrace: add register bindings for arm64Reviewed by: mhorne, markjApproved by: markj (mentor)Sponsored by: The FreeBSD FoundationDifferential Revision: https://reviews.freebsd.org/D39956 List of files: /freebsd/cddl/lib/libdtrace/Makefile

db05f9fbfb1a92caccaf37154666a99373028588 - dtrace: implement dtrace_instr_size() for arm64

Tue, 23 May 2023 16:19:15 +0200

dtrace: implement dtrace_instr_size() for arm64Reviewed by: markjApproved by; markj (mentor)Sponsored by: The FreeBSD FoundationDifferential Revision: https://reviews.freebsd.org/D39955 List of files: /freebsd/cddl/lib/libdtrace/Makefile

1fef7abdc76bd6f0c93775bd0c1b62b523abd20d - dtrace: add register bindings for RISC-V

Thu, 20 Apr 2023 18:25:37 +0200

dtrace: add register bindings for RISC-VReviewed by: mhorne, markjMFC after: 1 weekSponsored by: The FreeBSD FoundationDifferential Revision: https://reviews.freebsd.org/D39611 List of files: /freebsd/cddl/lib/libdtrace/Makefile

080e56a6c98c7e7a241a4260d4c19d3cad5b22af - dtrace: expose dtrace_instr_size() to userland and implement it for riscv

Thu, 20 Apr 2023 18:21:46 +0200

dtrace: expose dtrace_instr_size() to userland and implement it for riscvdtrace_instr_size() is needed by the forthcoming RISC-V port of kinst,as well as by libdtrace in D38825 for both amd64 and RISC-V.Reviewed by: markj, mhorneMFC after: 1 weekSponsored by: The FreeBSD FoundationDifferential Revision: https://reviews.freebsd.org/D39489 List of files: /freebsd/cddl/lib/libdtrace/Makefile

2179a159ea93e37b7fb2126ae0b1627b875f808b - libdtrace: Add kinst support

Tue, 11 Oct 2022 17:33:52 +0200

libdtrace: Add kinst supportkinst does not instantiate its probes automatically, it only does so ondemand via an ioctl interface implemented by /dev/kinst. This changemodifies libdtrace to perform that work when the script references thekinst provider, similar to the way pid provider probes are implemented.Reviewed by: markjMFC after: 3 monthsSponsored by: Google, Inc. (GSoC 2022)Differential Revision: https://reviews.freebsd.org/D36852 List of files: /freebsd/cddl/lib/libdtrace/Makefile

711d50bd9e0716ced63ab77a5e2b7fa7c5ed10b3 - dtrace: Remove local mips support

Fri, 01 Jul 2022 09:33:17 +0200

dtrace: Remove local mips supportRemove the stub pid probe and all the build glue.Reviewed by: imp, jhbSponsored by: DARPA, AFRLDifferential Revision: https://reviews.freebsd.org/D35541 List of files: /freebsd/cddl/lib/libdtrace/Makefile

2d5d2a986ce1a93b8567dbdf3f80bc2b545d6998 - ctf: Import ctf.h from OpenBSD

Mon, 07 Mar 2022 14:42:57 +0100

ctf: Import ctf.h from OpenBSDUse it instead of the existing ctf.h from OpenSolaris. This makes iteasier to use CTF in the core kernel, and to extend the CTF format tosupport wider type IDs.The imported ctf.h is modified to depend only on _types.h, and also toprovide macros which use the "parent" bit of a type ID to refer to typesin a parent CTF container.No functional change intended.Reviewed by: Domagoj Stolfa, emasteMFC after: 1 monthSponsored by: The FreeBSD FoundationDifferential Revision: https://reviews.freebsd.org/D34358 List of files: /freebsd/cddl/lib/libdtrace/Makefile

79ac3c12a714bcd3f2354c52d948aed9575c46d6 - pkgbase: Put dtrace in its own package

Sat, 19 Jun 2021 17:49:31 +0200

pkgbase: Put dtrace in its own packageWhile dtrace is usefull some people might not want it.Differential Revision: https://reviews.freebsd.org/D30752Sponsored by: Diablotin Systems List of files: /freebsd/cddl/lib/libdtrace/Makefile

8ba333e02eaa59337a4e1d5534d4e894344c8226 - libdtrace: Stop relying on lex compatibility

Wed, 17 Feb 2021 16:49:38 +0100

libdtrace: Stop relying on lex compatibilityIt does not appear to be required, and as of commit 6b7e592c215f("lex: Do not let input() return 0 when end-of-file is reached") itcauses input to return 0 instead of EOF when end-of-input is reached.PR: 253440MFC after: 3 daysSponsored by: The FreeBSD Foundation List of files: /freebsd/cddl/lib/libdtrace/Makefile