scalasca(1)

1scalasca(1)                  Scalasca Trace Tools                  scalasca(1)
2
3
4

NAME

6       scalasca - Scalasca information and proxy command
7

SYNOPSIS

9       scalasca [OPTIONS]
10       scalasca [OPTIONS] ACTION ACTION_ARGS
11

DESCRIPTION

13       The scalasca command allows to query information about a Scalasca Trace
14       Tools installation, but can  also  be  used  as  a  proxy  command  for
15       measurement, analysis, post-processing, and report examination tasks.
16
17       When  used  without  an  ACTION argument, the scalasca command provides
18       various OPTIONS to query and display  information  about  the  Scalasca
19       Trace Tools installation, such as the version number, the configuration
20       summary report, or installation-dependent path information. It is  also
21       possible  to  display a quick reference guide (if a suitable PDF viewer
22       is found on the system).
23
24       By contrast, if an ACTION argument is given, the scalasca command  acts
25       as  a  proxy  which  simply  delegates  the  requested operation to the
26       underlying specific command. It can therefore be considered  a  single-
27       entry-point convenience command that is easy to remember.
28

ACTIONS

30       Since  ACTION  arguments  enable  the  delegation of operations, please
31       refer to the documentation of the  respective  underlying  command  for
32       possible  ACTION_ARGS.  Also, note that ACTION_ARGS have to be provided
33       after the ACTION argument.
34
35       -a, --analyze, --analyse
36           Run application under  the  control  of  the  Scalasca  measurement
37           collection and analysis nexus scan(1).
38
39       -e, --examine
40           Examine  measurement  analysis  report  using the Scalasca analysis
41           report explorer square(1).
42
43   Deprecated actions
44       -i, -inst, --instrument
45           Prepare application objects and executable  for  measurement  using
46           the  Score-P  instrumenter.  This  action  only exists for backward
47           compatibility with the Scalasca 1.x release series.
48           Users are strongly encouraged  to  use  the  'scorep'  instrumenter
49           command   directly   to   take   full  advantage  of  its  improved
50           functionality.
51

OPTIONS

53       -c, --show-config
54           Print configuration summary, then exit.
55
56       -h, --help
57           Print a brief usage summary, then exit.
58
59       -n, --dry-run
60           Print the command(s) to be launched, but do not execute them.
61
62       --quickref
63           Display quick reference guide, then exit.
64
65       --remap-specfile
66           Show path to remapper specification file  used  for  trace-analysis
67           report post-processing, then exit.
68
69       -v, --verbose
70           Enable verbose mode.
71
72       -V, --version
73           Print version information, then exit.
74

EXIT STATUS

76       scalasca  exits  with status 0 on success, and greater than 0 if errors
77       occur.
78

BUGS

80       Please report bugs to scalasca@fz-juelich.de. Make sure to  include  at
81       least the following information in your bug report:
82
83       • The Scalasca Trace Tools version reported by 'scalasca -V'.
84
85       • The Scalasca Trace Tools configuration reported by 'scalasca -c'.
86
87       • The Score-P version reported by 'scorep --version'.
88
89       • The Score-P configuration reported by 'scorep-info config-summary'.
90
91       • The exact command line of the failing command.
92
93       • The exact failure/error message.
94
95       Also,  if the trace analysis fails, please archive a copy of the entire
96       experiment archive directory including the event trace  data,  as  this
97       may  be  required to aid in debugging. However, ONLY PROVIDE TRACE DATA
98       IF EXPLICITLY REQUESTED, as the data volume may be excessive.
99

EXAMPLES

101       scalasca --version
102       Displays the Scalasca Trace Tools version number.
103
104       scalasca --analyze mpiexec -n 4 foo args
105       Execute the instrumented MPI program foo  with  command-line  arguments
106       args,  collecting a runtime summary (default). Results in an experiment
107       directory scorep_foo_4_sum.
108
109       scalasca --examine -s -f filter scorep_foo_4_sum
110       Post-process measurement reports in  scorep_foo_4_sum  and  generate  a
111       score  report  with the run-time measurement filter rules from the file
112       filter applied.
113