bcc-vfscount(8)

1vfscount(8)                 System Manager's Manual                vfscount(8)
2
3
4

NAME

6       vfscount - Count VFS calls ("vfs_*"). Uses Linux eBPF/bcc.
7

SYNOPSIS

9       vfscount
10

DESCRIPTION

12       This  counts VFS calls. This can be useful for general workload charac‐
13       terization of these operations.
14
15       This works by tracing all kernel functions beginning with "vfs_"  using
16       dynamic  tracing. This may match more functions than you are interested
17       in measuring: Edit the script to customize which functions to trace.
18
19       Since this uses BPF, only the root user can use this tool.
20

REQUIREMENTS

22       CONFIG_BPF and bcc.
23

EXAMPLES

25       Count some VFS calls until Ctrl-C is hit:
26              # vfscount
27

FIELDS

29       ADDR   Address of the instruction pointer that was traced (only  useful
30              if  the  FUNC  column is suspicious and you would like to double
31              check the translation).
32
33       FUNC   Kernel function name
34
35       COUNT  Number of calls while tracing
36

OVERHEAD

38       This traces kernel vfs functions and maintains in-kernel counts,  which
39       are  asynchronously  copied to user-space. While the rate of VFS opera‐
40       tions can be very high (>1M/sec), this is a relatively efficient way to
41       trace  these  events,  and  so the overhead is expected to be small for
42       normal workloads.  Measure in a test environment, and if overheads  are
43       an  issue,  edit the script to reduce the types of vfs functions traced
44       (currently all beginning with "vfs_").
45

SOURCE

47       This is from bcc.
48
49              https://github.com/iovisor/bcc
50
51       Also look in the bcc distribution for a  companion  _examples.txt  file
52       containing example usage, output, and commentary for this tool.
53

OS

55       Linux
56

STABILITY

58       Unstable - in development.
59

AUTHOR

61       Brendan Gregg
62