trace.tproj/trace.1

   1 .\" Copyright (c) 2010, Apple Inc.  All rights reserved.
   2 .\"
   3 .Dd October 28, 2010
   4 .Dt TRACE 1
   5 .Os "Mac OS X"
   6 .Sh NAME
   7 .Nm trace
   8 .Nd configure and record kernel trace events
   9 .Sh SYNOPSIS
  10 .Nm trace
  11 .Fl h
  12 .Pp
  13 .Nm trace
  14 .Fl i
  15 .Op Fl b Ar numbufs
  16 .Pp
  17 .Nm trace
  18 .Fl g
  19 .Pp
  20 .Nm trace
  21 .Fl d
  22 .Op Fl a Ar pid | Fl x Ar pid
  23 .Pp
  24 .Nm trace
  25 .Fl r
  26 .Pp
  27 .Nm trace
  28 .Fl n
  29 .Pp
  30 .Nm trace
  31 .Fl e
  32 .Op Fl c Ar class Oo Fl p Ar class Oc Oo Fl s Ar subclass Oc
  33 .Op Fl a Ar pid | Fl x Ar pid
  34 .Op Fl k Ar code | Fl k Ar code | Fl k Ar code | Fl k Ar code
  35 .Pp
  36 .Nm trace
  37 .Fl E
  38 .Op Fl c Ar class Oo Fl p Ar class Oc Oo Fl s Ar subclass Oc
  39 .Op Fl a Ar pid | Fl x Ar pid
  40 .Op Fl k Ar code | Fl k Ar code | Fl k Ar code | Fl k Ar code
  41 .Ar executable_path
  42 .Op Ar optional args to executable
  43 .Pp
  44 .Nm trace
  45 .Fl t
  46 .Op Fl R Ar rawfile
  47 .Op Fl o Ar OutputFilename
  48 .Op Ar CodeFilename
  49 .Sh DESCRIPTION
  50 The
  51 .Nm trace
  52 command allows developers to initialize and configure
  53 the kernel trace subsystem. Trace events can be recorded
  54 to an in-memory buffer, or logged directly to a file. Raw
  55 data files can later be decoded to a plaintext format.
  56 .Sh SEE ALSO
  57 .Xr fs_usage 1 ,
  58 .Xr sc_usage 1 ,
  59 .Xr latency 1 ,
  60 .Xr top 1