Profiling.Linux.Perf

A higher-level interface to the perf data file parsing code.

Below is an example program which reads and parses a perf.data file and then dumps the contents to standard output:

module Main where

import Profiling.Linux.Perf (readAndDisplay, OutputStyle (..))
import System.Environment (getArgs)

main :: IO ()
main = do
  args <- getArgs
  case args of
     [] -> return ()
     (file:_) -> readAndDisplay Dump file

Data types

type TypeMap = Map EventID TypeInfo

Associate events with their event types. Events are (usually) tagged with an EventID. Many events can share the same EventID. Each EventID is associated with exactly one event type, which includes the name of the event, an EventSource and an EventTypeID

data TypeInfo

Type information for of event.

Constructors

TypeInfo

Fields

typeInfo_name :: String

Printable name of the event source.

typeInfo_source :: EventSource

Kind of the event source (hardware, software, tracepoint etc.).

typeInfo_id :: EventTypeID

Unique number of this type of event.

data OutputStyle

Style to use for printing the event data.

Constructors

Dump

Output full details of the data file preserving the original order of the events.

Trace

Output command and sample events in time order with event type annotations.

Functions

readAndDisplay :: OutputStyle -> FilePath -> IO ()

Read the contents of the perf.data file and render it on stdout in a specified style.

readPerfData :: FilePath -> IO PerfData

Read and parse the perf.data file into its constituent components.

display :: OutputStyle -> PerfData -> IO ()

Render the components of the perf.data file under the specified style. Don't create a single big Doc or String to avoid stack overflows. Instead, lazily print events as they are rendered.

makeTypeMap :: PerfData -> TypeMap

Build a map from EventIDs to their type information.

sortEventsOnTime :: [Event] -> [Event]

Sort a list of events in ascending time order. Events without a timestamp are treated as having a timestamp of 0, which places them at the start of the sorted output.