instruments(1) BSD General Commands Manual instruments(1)NAMEinstrumentsUSAGEinstruments [-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 :
-v Turn on verbose logging
-t template
The path to the template to run
-s [devices, templates]
Show list of known devices or templates, and then exit ( default
is templates )
-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 )
-w [hardware device, or simulator name]
The name or identifier of the hardware or simulator to target
-e variable value
An environment variable setting (You may specify more than one)
-p pid The ID of the process to attach to
application
The path to the application or command to launch
argument
Command line argument to be sent to the launched process (You
may specify more than one)
SEE ALSO
Instruments.app may be used to perform trace executions in a graphical
environment and may also be used to open trace documents created by
instruments.
EXAMPLESinstruments-t mytemplate myapp.app
Mac OS April 28, 2024 Mac OS
