1*2020e764SMateusz Piotrowski.\" 2*2020e764SMateusz Piotrowski.\" Copyright (c) 2025 Mateusz Piotrowski <0mp@FreeBSD.org> 3*2020e764SMateusz Piotrowski.\" 4*2020e764SMateusz Piotrowski.\" SPDX-License-Identifier: BSD-2-Clause 5*2020e764SMateusz Piotrowski.\" 6*2020e764SMateusz Piotrowski.Dd November 3, 2025 7*2020e764SMateusz Piotrowski.Dt DTRACE_VFS 4 8*2020e764SMateusz Piotrowski.Os 9*2020e764SMateusz Piotrowski.Sh NAME 10*2020e764SMateusz Piotrowski.Nm dtrace_vfs 11*2020e764SMateusz Piotrowski.Nd a DTrace provider for Virtual File System 12*2020e764SMateusz Piotrowski.Sh SYNOPSIS 13*2020e764SMateusz Piotrowski.Sm off 14*2020e764SMateusz Piotrowski.Nm vfs Cm : fplookup : Ar function Cm : Ar name 15*2020e764SMateusz Piotrowski.Nm vfs Cm : namecache : Ar function Cm : Ar name 16*2020e764SMateusz Piotrowski.Nm vfs Cm : namei : Ar function Cm : Ar name 17*2020e764SMateusz Piotrowski.Nm vfs Cm : vop : Ar function Cm : Ar name 18*2020e764SMateusz Piotrowski.Sm on 19*2020e764SMateusz Piotrowski.Sh DESCRIPTION 20*2020e764SMateusz PiotrowskiThe DTrace 21*2020e764SMateusz Piotrowski.Nm vfs 22*2020e764SMateusz Piotrowskiprovider allows users to trace events in the 23*2020e764SMateusz Piotrowski.Xr VFS 9 24*2020e764SMateusz Piotrowskilayer, the kernel interface for file systems on 25*2020e764SMateusz Piotrowski.Fx . 26*2020e764SMateusz Piotrowski.Pp 27*2020e764SMateusz PiotrowskiRun 28*2020e764SMateusz Piotrowski.Ql dtrace -l -P vfs 29*2020e764SMateusz Piotrowskito list all 30*2020e764SMateusz Piotrowski.Nm vfs 31*2020e764SMateusz Piotrowskiprobes. 32*2020e764SMateusz PiotrowskiAdd 33*2020e764SMateusz Piotrowski.Fl v 34*2020e764SMateusz Piotrowskito generate program stability reports, 35*2020e764SMateusz Piotrowskiwhich contain information about the number of probe arguments and their types. 36*2020e764SMateusz Piotrowski.Pp 37*2020e764SMateusz PiotrowskiThe 38*2020e764SMateusz Piotrowski.Cm fplookup 39*2020e764SMateusz Piotrowskimodule defines a single probe, 40*2020e764SMateusz Piotrowski.Fn vfs:fplookup:lookup:done "struct nameidata *ndp" "int line" "bool status_code" , 41*2020e764SMateusz Piotrowskithat instruments the fast path lookup code in 42*2020e764SMateusz Piotrowski.Xr VFS 9 . 43*2020e764SMateusz Piotrowski.Pp 44*2020e764SMateusz PiotrowskiThe 45*2020e764SMateusz Piotrowski.Cm namecache 46*2020e764SMateusz Piotrowskimodule provides probes related to the 47*2020e764SMateusz Piotrowski.Xr VFS 9 48*2020e764SMateusz Piotrowskicache. 49*2020e764SMateusz PiotrowskiConsult the source code in 50*2020e764SMateusz Piotrowski.Pa src/sys/kern/vfs_cache.c 51*2020e764SMateusz Piotrowskifor more details. 52*2020e764SMateusz Piotrowski.Pp 53*2020e764SMateusz PiotrowskiThe 54*2020e764SMateusz Piotrowski.Cm namei 55*2020e764SMateusz Piotrowskimodule manages probes related to pathname translation and lookup operations. 56*2020e764SMateusz PiotrowskiRefer to 57*2020e764SMateusz Piotrowski.Xr namei 9 58*2020e764SMateusz Piotrowskito learn more. 59*2020e764SMateusz Piotrowski.Pp 60*2020e764SMateusz PiotrowskiThe 61*2020e764SMateusz Piotrowski.Cm vop 62*2020e764SMateusz Piotrowskimodule contains probes related to the functions responsible for 63*2020e764SMateusz Piotrowski.Xr vnode 9 64*2020e764SMateusz Piotrowskioperations. 65*2020e764SMateusz Piotrowski.Sh COMPATIBILITY 66*2020e764SMateusz PiotrowskiThis provider is specific to 67*2020e764SMateusz Piotrowski.Fx . 68*2020e764SMateusz Piotrowski.Sh EXAMPLES 69*2020e764SMateusz PiotrowskiCheck what lookups failed to be handled in a lockless manner: 70*2020e764SMateusz Piotrowski.Bd -literal -offset 2n 71*2020e764SMateusz Piotrowski# dtrace -n 'vfs:fplookup:lookup:done { @[arg1, arg2] = count(); }' 72*2020e764SMateusz Piotrowski.Ed 73*2020e764SMateusz Piotrowski.Sh SEE ALSO 74*2020e764SMateusz Piotrowski.Xr dtrace 1 , 75*2020e764SMateusz Piotrowski.Xr d 7 , 76*2020e764SMateusz Piotrowski.Xr SDT 9 , 77*2020e764SMateusz Piotrowski.Xr namei 9 , 78*2020e764SMateusz Piotrowski.Xr VFS 9 79*2020e764SMateusz Piotrowski.Rs 80*2020e764SMateusz Piotrowski.%A Brendan Gregg 81*2020e764SMateusz Piotrowski.%A Jim Mauro 82*2020e764SMateusz Piotrowski.%B DTrace: Dynamic Tracing in Oracle Solaris, Mac OS X and FreeBSD 83*2020e764SMateusz Piotrowski.%I Prentice Hall 84*2020e764SMateusz Piotrowski.%P pp. 335\(en351 85*2020e764SMateusz Piotrowski.%D 2011 86*2020e764SMateusz Piotrowski.%U https://www.brendangregg.com/dtracebook/ 87*2020e764SMateusz Piotrowski.Re 88*2020e764SMateusz Piotrowski.Sh AUTHORS 89*2020e764SMateusz Piotrowski.An -nosplit 90*2020e764SMateusz PiotrowskiThe 91*2020e764SMateusz Piotrowski.Fx 92*2020e764SMateusz Piotrowski.Nm vfs 93*2020e764SMateusz Piotrowskiprovider was written by 94*2020e764SMateusz Piotrowski.An Robert Watson Aq Mt rwatson@FreeBSD.org . 95*2020e764SMateusz Piotrowski.Pp 96*2020e764SMateusz PiotrowskiThis manual page was written by 97*2020e764SMateusz Piotrowski.An Mateusz Piotrowski Aq Mt 0mp@FreeBSD.org . 98