profile - Edit and manage profiles#

Usage#

e4s-cl [ OPTIONS ] profile SUBCOMMAND { ARGUMENTS }

SUBCOMMAND := { create | copy | delete | edit | list |
                show | select | unselect | detect | dump }

Description#

Profiles are a key component of e4s-cl. They are used to greatly reduce the amount of information to input on a command line by recording chosen arguments.

Instead of listing all necessary files and libraries to use for every command, passing a profile containing those files as an argument vastly improves readability and efficiency.

Profiles are accessed and edited using the profile sub-commands.

Contents#

A profile is a recorded collection of fields relating to a specific MPI library.

Field	Description
name	A name by which the profile is accessed and invoked
image	Path or identifier of a container image
backend	Identifier for a technology to launch the container with
source	Path of a script to source in the container before execution
files	List of files to make accessible to the running program
libraries	List of libraries to load in the running program
wi4mpi	Wi4MPI installation to use for this profile

Profile Creation#

Profiles can be created with the init, profile detect and profile create commands.

The commands init and profile detect will create a profile dynamically according to the execution of a reference MPI program.

The profile create command will create an empty profile to complete at the user’s discretion.

Caution

MPI libraries often dynamically use files and libraries without warning, and the absence of those unlisted files during execution more often than not results in a crash or segmentation fault. Please ensure you acknowledge the result of profile detect when creating an empty profile.

Profile Selection#

A profile can be selected using the profile select command. The target profile is then implicitly used for most of the commands taking a profile as an argument.

Only one profile can be selected at a time. Switching selection is done by selecting another profile. A selection can also be canceled by using profile unselect.