detect - Create a profile from a MPI library#

Usage#

e4s-cl profile detect [ OPTIONS ] < MPI launcher command >

Options#

-p, --profile

The profile in which the gathered information will be output

Description#

The profile detect command will create a profile from the analysis of the given MPI command’s execution. This process uses system call monitoring to produce an exhaustive list of files and libraries required by the MPI installation.

Warning

To get a complete dependency detection, it is best to ensure the following:

  • The MPI launcher and binary should use the host’s MPI library, to be imported in the future containers;

  • The MPI program should call at least one collective to ensure the use of the network stack;

  • The process should be run on multiple nodes using the target network. Failure to do so may result in erroneous detection of communication libraries and thus may create communication errors when using the profile.

Use -p/--profile to select an output profile. If the option is not present, the selected profile will be overwritten instead.

Warning

Not specifying a profile will overwrite the selected profile on success !

Examples#

mpicc -o ping-pong ping-pong.c
e4s-cl profile detect -p profile-detected \
        mpirun -np 2 -ppn 1 -hosts node1,node2 ./ping-pong