tvscript Command Syntax
The syntax for the tvscript command is:
tvscript [options] [ filename ] [ -a program_args]
options
TotalView and tvscript command-line options. You can use any options described in TotalView Command Syntax
filename
The program being debugged.
-a program_args
Program arguments.
The command-line options most often used with tvscript are:
-mpi(The MPI environments supported are those listed in the Parallel tab of the File > New Program dialog box.)-starter_args-nodes-np or -procsor -tasksFor more information on these command-line options, see TotalView Command Syntax.
Cray Xeon Phi
The syntax for using tvscript on Cray Xeon Phi Knights Corner (KNC) native nodes is:
tvscript [options] -mpi CrayKNC-aprun -npnumber-of-processes-starter_args "[aprun-arguments]filename[program_args]"aprun
-np
The number of processes or tasks that the starter program will create.
-starter_args
Required, with the arguments following enclosed in quotes; the application executable (filename) to be debugged must follow the arguments for aprun.
aprun-arguments
The command arguments for aprun (except the -k argument).
filename
The program being debugged.
program_args
The arguments for the program being debugged.
aprun
Required; the executable at the end of the command line.
For example:
tvscript \
-create_actionpoint "tx_basic_mpi.c#98=>display_backtrace
‑show_arguments, print myid" \
-mpi CrayKNC-aprun -np 16 \
-starter_args "tx_basic_mpi" \
aprun
Cray XK7
The syntax for using tvscript on Cray XK7 is:
tvscript [options] -mpi CrayXK7-aprun -npnumber-of-processes-starter_args
"[aprun-arguments]filename[program_args]"aprun
"[aprun-arguments]filename[program_args]"aprun
-np
The number of processes or tasks that the starter program will create.
-starter_args
Required, with the arguments following enclosed in quotes; the application executable (filename) to be debugged must follow the arguments for aprun.
aprun-arguments
The command arguments for aprun.
filename
The program being debugged.
program_args
The arguments for the program being debugged.
aprun
Required; the executable at the end of the command line.
For example:
tvscript \
-create_actionpoint "tx_basic_mpi.c#98=>display_backtrace
‑show_arguments, print myid" \
-mpi CrayXK7-aprun -np 16 \
-starter_args "tx_basic_mpi" \
aprun
