Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
DTRACE_VFS(4)		    Kernel Interfaces Manual		 DTRACE_VFS(4)

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 pro-
       gram 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.  Con-
       sult 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),	SDT(9),	namei(9), VFS(9)

       Brendan Gregg and Jim Mauro, DTrace: Dynamic Tracing in Oracle Solaris,
       Mac	OS	 X	 and	   FreeBSD,	  Prentice	 Hall,
       https://www.brendangregg.com/dtracebook/, pp. 335-351, 2011.

AUTHORS
       The    FreeBSD	 vfs   provider	  was	written	  by   Robert	Watson
       <rwatson@FreeBSD.org>.

       This manual page	was written by Mateusz Piotrowski <0mp@FreeBSD.org>.

FreeBSD	ports 15.quarterly     November	3, 2025			 DTRACE_VFS(4)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=dtrace_vfs&sektion=4&manpath=FreeBSD+15.1-RELEASE+and+Ports.quarterly>

home | help