NAME
dtrace_vfs – a DTrace provider for Virtual File System
SYNOPSIS
vfs:fplookup:function:name
vfs:namecache:function:name
vfs:namei:function:name
vfs:vop:function:name
DESCRIPTION
The DTrace vfs provider allows users to trace events in the VFS(9) layer, the kernel interface for file systems on FreeBSD.
Run ‘dtrace -l -P vfs’ to list all vfs probes. Add -v to generate program stability reports, which contain information about the number of probe arguments and their types.
The fplookup module defines a single probe, vfs:fplookup:lookup:done(struct nameidata *ndp, int line, bool status_code), that instruments the fast path lookup code in VFS(9).
The namecache module provides probes related to the VFS(9) cache. Consult the source code in src/sys/kern/vfs_cache.c for more details.
The namei module manages probes related to pathname translation and lookup operations. Refer to namei(9) to learn more.
The vop module contains probes related to the functions responsible for vnode(9) operations.
COMPATIBILITY
This provider is specific to FreeBSD.
EXAMPLES
Check what lookups failed to be handled in a lockless manner:
# dtrace -n 'vfs:fplookup:lookup:done { @[arg1, arg2] = count(); }'
SEE ALSO
dtrace(1), d(7), namei(9), SDT(9), VFS(9) Brendan Gregg and Jim Mauro, DTrace: Dynamic Tracing in Oracle Solaris, Mac OS X and FreeBSD, Prentice Hall, pp. 335–351, 2011, https://www.brendangregg.com/dtracebook/.
AUTHORS
The FreeBSD vfs provider was written by Robert Watson ⟨[email protected]⟩.
This manual page was written by Mateusz Piotrowski ⟨[email protected]⟩.