Show Table of Contents
The tracepoints can be found under the
/sys/kernel/debug/tracing/directory assuming that
debugfsis mounted in the standard place at the
eventssubdirectory contains all the tracing events that may be specified and, provided the
gfs2module is loaded, there will be a
gfs2subdirectory containing further subdirectories, one for each GFS2 event. The contents of the
/sys/kernel/debug/tracing/events/gfs2directory should look roughly like the following:
lsenable gfs2_bmap gfs2_glock_queue gfs2_log_flush filter gfs2_demote_rq gfs2_glock_state_change gfs2_pin gfs2_block_alloc gfs2_glock_put gfs2_log_blocks gfs2_promote
To enable all the GFS2 tracepoints, enter the following command:
echo -n 1 >/sys/kernel/debug/tracing/events/gfs2/enable
To enable a specific tracepoint, there is an
enablefile in each of the individual event subdirectories. The same is true of the
filterfile which can be used to set an event filter for each event or set of events. The meaning of the individual events is explained in more detail below.
The output from the tracepoints is available in ASCII or binary format. This appendix does not currently cover the binary interface. The ASCII interface is available in two ways. To list the current content of the ring buffer, you can enter the following command:
This interface is useful in cases where you are using a long-running process for a certain period of time and, after some event, want to look back at the latest captured information in the buffer. An alternative interface,
/sys/kernel/debug/tracing/trace_pipe, can be used when all the output is required. Events are read from this file as they occur; there is no historical information available through this interface. The format of the output is the same from both interfaces and is described for each of the GFS2 events in the later sections of this appendix.
A utility called
trace-cmdis available for reading tracepoint data. For more information on this utility, see the link in Section B.10, “References”. The
trace-cmdutility can be used in a similar way to the
straceutility, for example to run a command while gathering trace data from various sources.