manpagez: man pages & more
man instruments(1)
Home | html | info | man
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
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.