instruments(1) BSD General Commands Manual instruments(1)

NAME
     iinnssttrruummeennttss,, vveerrssiioonn 11..00

UUSSAAGGEE
     instruments [-t template] [-d document] [-l timeLimit] [-i #] [-w device]
     [[-p pid] | [-a application [-e variable value] [-g 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

     -a 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)

     -g 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.

EEXXAAMMPPLLEESS
     instruments -t mytemplate -a myapp.app

Mac OS                         December 21, 2019                        Mac OS