.\" Copyright (c) 2013 Apple Inc.  All rights reserved.
.\"
.Dd May 20, 2013
.Dt TIMERFIRES 1
.Os "OS X"
.Sh NAME
.Nm timerfires
.Nd analyze timers as they fire
.Sh SYNOPSIS
.Nm
.Op Fl t Ar timeout
.Op Fl p Ar pid | Fl n Ar name
.Op Fl s
.Sh DESCRIPTION
The
.Nm
utility lists timers as they fire.
.Pp
The options are as follows:
.Bl -tag -width "            "
.It Fl t Ar timeout
Run only for
.Ar timeout
seconds; then exit.
.It Fl p Ar pid
Analyze only timers from the process with process ID
.Ar pid .
.It Fl n Ar name
Analyze only timers from processes with name
.Ar name .
It is an error to specify both
.Fl p
and 
.Fl n .
.It Fl s
Show call stacks for "sleep"-type timers.
.El
.Sh SAMPLE USAGE
.Pp
.Nm
.Fl n
MyApp
.Fl s
.Fl t
10
.Pp
.Nm
will run for ten seconds, displaying timer data for all instances of processes named "MyApp", including stacks.