osx man page for instruments

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

NAME
     instruments, version 1.0

USAGE
     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 executions in a graphical environment and may also be used to open trace
     documents created in either instruments or Instruments.app.

EXAMPLES
     instruments -t mytemplate -a myapp.app

Mac OS								   June 2, 2019 							    Mac OS