Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
hpc-compendium
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Wiki
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Snippets
Deploy
Releases
Package registry
Container Registry
Model registry
Operate
Terraform modules
Monitor
Incidents
Service Desk
Analyze
Value stream analytics
Contributor analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Terms and privacy
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
ZIH
hpcsupport
hpc-compendium
Commits
4f5ec205
Commit
4f5ec205
authored
2 years ago
by
Maximilian Sander
Browse files
Options
Downloads
Patches
Plain Diff
fix formatting
parent
8af9cd75
No related branches found
No related tags found
2 merge requests
!777
Automated merge from preview to main
,
!768
Update Info on mustrun
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
doc.zih.tu-dresden.de/docs/software/mpi_usage_error_detection.md
+11
-7
11 additions, 7 deletions
....tu-dresden.de/docs/software/mpi_usage_error_detection.md
with
11 additions
and
7 deletions
doc.zih.tu-dresden.de/docs/software/mpi_usage_error_detection.md
+
11
−
7
View file @
4f5ec205
...
@@ -11,9 +11,10 @@ exist (see last section).
...
@@ -11,9 +11,10 @@ exist (see last section).
## MUST
## MUST
[
MUST
](
https://www.i12.rwth-aachen.de/go/id/nrbe
)
checks if your application conforms to the MPI standard and will
[
MUST
](
https://www.i12.rwth-aachen.de/go/id/nrbe
)
checks if your application conforms to the MPI
issue warnings if there are errors or non-portable constructs. You can apply MUST without modifying your source code,
standard and will issue warnings if there are errors or non-portable constructs. You can apply MUST
though we suggest to add the debugging flag "-g" during compilation.
without modifying your source code, though we suggest to add the debugging flag "-g" during
compilation.
See also
[
MUST Introduction Slides
](
misc/parallel_debugging_must.pdf
)
.
See also
[
MUST Introduction Slides
](
misc/parallel_debugging_must.pdf
)
.
...
@@ -46,9 +47,11 @@ In order to launch your application with MUST you need to replace the `srun` com
...
@@ -46,9 +47,11 @@ In order to launch your application with MUST you need to replace the `srun` com
```
console
```
console
marie@login$
mustrun
--must
:mpiexec srun
--must
:np
-n
-n
<number of MPI processes> ./<your binary>
marie@login$
mustrun
--must
:mpiexec srun
--must
:np
-n
-n
<number of MPI processes> ./<your binary>
```
```
Besides replacing the
`srun`
command you need to be aware that
**
MUST always allocates an extra
Besides replacing the
`srun`
command you need to be aware that
**
MUST always allocates an extra
process
**
, i.e. if you issue a
`mustrun --must:mpiexec srun --must:np -n -n 4 ./<your binary>`
then MUST
process
**
, i.e. if you issue a
`mustrun --must:mpiexec srun --must:np -n -n 4 ./<your binary>`
then
will start
**5 processes**
instead. This is usually not critical, however in interactive/batch jobs
**
make sure
MUST will start
**5 processes**
instead. This is usually not critical, however in interactive/batch
jobs
**
make sure
to allocate an extra CPU for this task
**
.
to allocate an extra CPU for this task
**
.
Suppose your application is called
`fancy-program`
and is normally run with 4 processes.
Suppose your application is called
`fancy-program`
and is normally run with 4 processes.
...
@@ -77,14 +80,15 @@ marie@login$ mustrun --must:mpiexec srun --must:np -n --must:stacktrace backward
...
@@ -77,14 +80,15 @@ marie@login$ mustrun --must:mpiexec srun --must:np -n --must:stacktrace backward
{...}
{...}
[MUST] Execution finished, inspect "/home/marie/MUST_Output.html"!
[MUST] Execution finished, inspect "/home/marie/MUST_Output.html"!
```
```
With the additional flag
`--must:stacktrace backward`
you can produce an additional stacktrace
With the additional flag
`--must:stacktrace backward`
you can produce an additional stacktrace
with line number of the error location which allows to pinpoint the error location in your code.
with line number of the error location which allows to pinpoint the error location in your code.
This might slow down code execution slightly.
This might slow down code execution slightly.
Finally, MUST assumes that your application may crash at any time. To still gather correctness
Finally, MUST assumes that your application may crash at any time. To still gather correctness
results under this assumption is extremely expensive in terms of performance overheads. Thus, if
results under this assumption is extremely expensive in terms of performance overheads. Thus, if
your application does not crash, you should add
`--must:nocrash`
to the
`mustrun`
command to make
your application does not crash, you should add
`--must:nocrash`
to the
`mustrun`
command to make
MUST aware of this knowledge. Overhead is drastically reduced with this switch.
MUST aware of this knowledge. Overhead is drastically reduced with this switch.
Further details on alternative launch modes are described in the MUST documentation.
Further details on alternative launch modes are described in the MUST documentation.
### Result Files
### Result Files
...
...
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment