Copyright (c) 2010, Apple Inc. All rights reserved.

.Dd October 28, 2010 .Dt TRACE 1 .Os "Mac OS X" .Sh NAME .Nm trace .Nd configure and record kernel trace events .Sh SYNOPSIS .Nm trace .Fl h

p .Nm trace .Fl i .Op Fl b Ar numbufs

p .Nm trace .Fl g

p .Nm trace .Fl d .Op Fl a Ar pid | Fl x Ar pid

p .Nm trace .Fl r

p .Nm trace .Fl n

p .Nm trace .Fl e .Op Fl c Ar class Oo Fl p Ar class Oc Oo Fl s Ar subclass Oc .Op Fl a Ar pid | Fl x Ar pid .Op Fl k Ar code | Fl k Ar code | Fl k Ar code | Fl k Ar code

p .Nm trace .Fl E .Op Fl c Ar class Oo Fl p Ar class Oc Oo Fl s Ar subclass Oc .Op Fl a Ar pid | Fl x Ar pid .Op Fl k Ar code | Fl k Ar code | Fl k Ar code | Fl k Ar code .Ar executable_path .Op Ar optional args to executable

p .Nm trace .Fl t .Op Fl R Ar rawfile .Op Fl o Ar OutputFilename .Op Fl N .Op Ar ExtraCodeFilename1 ExtraCodeFilename2 ... .Sh DESCRIPTION The .Nm trace command allows developers to initialize and configure the kernel trace subsystem. Trace events can be recorded to an in-memory buffer, or logged directly to a file. Raw data files can later be decoded to a plaintext format. .Sh SEE ALSO .Xr fs_usage 1 , .Xr sc_usage 1 , .Xr latency 1 , .Xr top 1