instruments(1) BSD General Commands Manual instruments(1)
NAME
instruments
USAGE
instruments [-t template] [-d document] [-l timeLimit] [-i #] [-w device]
[[-p pid] | [application [-e variable value] [argument ...]]]
DESCRIPTION
Runs an Instruments template from the command line.
Options are :
-t template
The path to the template to run
-s Show list of known templates and exit
-d document
The path to save the trace document data to (This may already
exist, in which case a new Run will be added)
-l # The limit of milliseconds to record until termination ( infinite
is default )
-i # The index of the instrument to apply the following target data
to ( default if missing )
-p pid The ID of the process to attach to
application
The path to the application or command to launch
-w hardware device
The identifier of the hardware to target
-e variable value
An environment variable setting (You may specify more than one)
argument
Command line argument to be sent to the launched process (You
may specify more than one)
-v Turn on verbose logging
FILES
/usr/bin/instruments Executable
SEE ALSO
/Developer/Applications/Instruments.app may be used to perform trace exe-
cutions in a graphical environment and may also be used to open trace
documents created in either instruments or Instruments.app.
EXAMPLES
instruments -t mytemplate myapp.app
Mac OS August 21, 2012 Mac OS
Mac OS X 10.8 - Generated Tue Aug 21 11:33:43 CDT 2012