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.

Sub-Commands