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