SIS Command line Options

SIS supplies various command for control the instrumentation that can work with many programming model,instrumentation libraries, and instrumentation mode. When using the command line the user has to do the following things:

  1. Specify the programming model( kind of his program)
  2. Specify instrumentation library
  3. Specify selected code regions if the user wants to use command lines to select code regions

Programming model options

The following table shows the commands that allow to select programming model of a given input program and instrumentation library.


Table 1: Command for control programming model and instrumentation library.
Options Descriptions
-p7 -VH[HPF+ predefined code regions] HPF+ programs, the output file will be indicated by -O option. The description file name is the name of output file with the extension is .sisdesc.
-p7 -VM[MPI predefined code regions] Fortran MPI programs, the output will be saved in 'filename_sis.f90' with filename is the name of input file. The name of description file is application.sisdesc. Notice that we don't use -O option in this case.
-p5 -p7 -VS[OpenMP code regions] OpenMP programs, the output file will be saved in'filename_sis.f90' with filename is the name of input file.The name of description file is filename.sisdesc. Notice that we don't use -O option in this case
-VL[S|T] Using SISPROFILING instrumentation library with option -VLS. Otherwise TAUSIS instrumentation library will be used with option -VLT. By default SISPROFILING library is used.
-VT If this option is set, predefined code regions will be specified by SIS directives inside the user's source code. Otherwise, predefined code regions will be set using accompany with options for programming model.



By default the instrumented files will be stored in the current directory. However if the user wants to store the instrumented files in a specific directory he can use the following option:
-C -Gdir where dir is the directory.

If the user want to instrument hybrid programs he/she has to combine to these options. For examples, to instrument a MPI mixing OpenMP program the option -p5 -VM[...] -VS[...] is used.

Command line options for selecting predefined code region

Predefined code regions can be selected via command line options or SIS directives. If the user want to select code regions via command line option the user has not to set -VT option. Options for selecting predefine code regions can accompany with options for selecting programming model. Predefined code regions are classified into common code regions and specified code regions. Table 2 shows options for code regions.


Table 2:Command options for control code regions
Options Descriptions
-VR[common code region types] Specify common code regions that will be instrumented
-VH[HPF+ code region types] Specify HPF+ code regions that will be instrumented
-VM[MPI code region types] Specify MPI code regions that will be instrumented
-VS[OpenMP code region types] Specify OpenMP code regions will be instrumented



Options for common code regions

The table 3 specifies predefined common code region types. These types are set by using -VR options:


 
Table 3: Command options for selecting commond code regions
Options Description
P Entire program
Y Procedures
S subroutines calls
F function calls
L all loops
U outermost loop
R all read statements
W all write statements
B arbitrary code regions



E.g, -VRSLRW measures subroutines, loops and read/write statements. Notice that if all loops option is set then it will override outermost loops option if this option is available. Another limitation is that the instrumentation of function calls applies to simple function calls such as x=foo()

Options for selecting predefined HPF code regions

The table 4 specifies options for selecting the predefined HPF+ code regions. These code regions are set by using -VH options.

Table 4: Options for control HPF+ code regions.
HPF+ code regions Descriptions
D work distribution
N Inspector
X Executor
G Gather
T Scatter
I INDEPENDENT loops
R all parallel read statement
W all parallel write statement
E all above code regions



Options for MPI code regions

The table 5 specifies the predefined MPI code regions. These code regions are set by using -VM options.


Table 5: Command options for control MPI code regions.
MPI Code regions Descriptions
I Initialization and Finalization
P Point to point communication
C Collective communication routines
O MPI IO routines
B Barrier routines
T Data type routines
E All MPI routines



For examples, instrumentation all MPI collective routines we use -VMC option.

Options for selecting OpenMP predefined code regions

Table 6 shows options for selecting predefined OpenMP code regios . These code regions are set by using -VS options.


Table 6: Command options for control OpenMP code regions.
OMP Code regions Descriptions
A OMP PARALLEL
D OMP PARALLEL DO
S OMP PARALLEL SECTIONS
W OMP PARALLEL WORSHARE
O OMP DO
Z OMP SECTIONS
K OMP WORKSHARE
I OMP SINGLE
M OMP MASTER
B OMP BARRIER
T OMP ATOMIC
R OMP ORDERED
F OMP FLUSH
E all above code regions



For examples, to instrument all OMP PARALLEL and OMP DO regions we use -VSAO.

[SCALEA]
Send your comments to Truong Hong Linh
Last modified: Wed Dec 12 17:24:55 MET 2001