NAME
laminfo - Display configuration information about LAM/MPI
SYNTAX
laminfo [-arch] [-config] [-help|-h] [-param <type> <module>]
[-parsable|-pretty] [-path <item>] [-version <item> <scope>]
OPTIONS
-all Show all configuration information
-arch Show architecture that LAM was configured for
-config Show some information about LAM configuration
-help Show help message
-param Show SSI parameter(s) for a given SSI type and module
-parsable Show output in an easily parsable format
-path <item> Print a given configuration path
-pretty Show output in a prettyprint format (default)
-version Print some or part of a version number of a given item
DESCRIPTION
The laminfo command is used to display information about a LAM/MPI
installation. Particularly with the SSI run-time module selection
system, the laminfo command can be useful to scripts and resource
managers to determine the capabilities of the installed LAM/MPI in
order to pass run-time parameters to MPI programs.
Output can be displayed in a "pretty" format (i.e., suitable for human
reading) and also in a parsable format (i.e., suitable for easy parsing
by scripts or other automated mechanisms). There are no other LAM API
functions to retrieve this data (in any language); the laminfo command
is the best mechanism to obtain any configuration information about
LAM/MPI. The parsable output was designed such that common utilities
such as grep, awk, cut, and sed can easily be used to extract relevant
information.
Running laminfo with no arguments will display a subset of
configuration parameters in the "pretty" format (see the EXAMPLES
section, below). Several command line options are available to limit
exactly which information is displayed. These options, when used in
conjunction with the parsable output, can provide automated mechanisms
specific information about the capabilities of LAM/MPI.
GENERAL PARAMETERS
The -pretty and -parsable switches are used to select whether to
display the output in "pretty" or machine-parsable format,
respectively. If neither is specified, -pretty is the default.
The -arch switch will display the architecture that LAM/MPI was
configured and compiled on.
The -config switch will display a set of configuration information
about the MPI capabilities of LAM/MPI, such as whether there are C,
C++, and Fortran MPI bindings available, whether there is MPI profiling
support for C, C++, and Fortran, whether ROMIO support is available,
whether IMPI support is available, whether debugging support is
available (mostly for LAM/MPI maintainers), and whether LAM/MPI is
"purify clean" (meaning that it is suitable for use with memory
checking debuggers). Most of these are options to the LAM/MPI
configure script, and are configure/compile-time selections that cannot
be changed once LAM has been installed. While there is no fine-grained
control to individually request each of these pieces of information,
using -config in conjunction with -parsable and commands such as grep
can return any individual piece of information.
PARAM PARAMETERS
The -param switch can be used to show available SSI parameters and
their default values. The type and module arguments can be used to
specify a particular SSI type and/or module, or use the special keyword
"all" to indicate all available SSI types/modules (respectively).
Available SSI types are:
all Show all SSI types
base Intrinsic LAM/MPI parameters
boot Boot modules (e.g., lamboot)
coll MPI collectives
cr Checkpoint / restart
RPI MPI point-to-point.
The names of the modules that are available are dependant upon which
modules are available for any given type. See EXAMPLES, below, for
example usage.
PATH PARAMETERS
The -path switch returns various paths that were compiled into LAM/MPI.
These were all decided when LAM was configured, and cannot be changed
at run-time. However, knowing the location of these directories can be
useful in order to find LAM data files, binaries, include files, etc.
The -path switch takes a parameter: item. Possible values for item
are:
prefix Display the prefix directory for LAM/MPI
bindir Display the directory where the LAM/MPI executables were
installed
libdir Display the directory where the LAM/MPI libraries were
installed
incdir Display the directory where the LAM/MPI include files were
installed
pkglibdir Display the directory where the LAM/MPI dynamic libraries
were installed
sysconfdir Display the directory where the LAM/MPI help and
configuration files were installed
Note that although LAM's GNU configure script defaults to certain
values for all of these directories based on the prefix (e.g., bindir
is typically $prefix/bin), they can all be overriden by command line
switches to configure, and should therefore never be assumed. Use
laminfo to determine what values were selected at configure time.
VERSION PARAMETERS
Since each SSI module in LAM/MPI is an independant entity in itself, it
may have an entirely different version number than LAM/MPI itself.
Indeed, each SSI module has three version numbers: the version of the
base SSI API that it supports, the version of the component type API
that it supports, and its own version number. Most users will only
care about the last one (the module's own version number).
The -path switch takes two parameters: item and scope.
The item can be the main LAM version itself, any of the SSI types, or a
specific SSI module. There are currently four kinds of SSI modules
that can be queried: boot, coll, rpi, and cr. Hence, the version
numbers that can be obtained from the -version switch are:
lam The version of LAM/MPI
boot The three versions of each boot SSI module
boot:name The three versions of a specific boot SSI module
coll The three versions of each coll SSI module
coll:name The three versions of a specific coll SSI module
rpi The three versions of each rpi SSI module
rpi:name The three versions of a specific rpi SSI module
cr The three versions of each cr SSI module
cr:name The three versions of a specific cr SSI module
The scope argument describes what part of the version number to
display. This allows either the full version number to be displayed,
or any specific individual component of the version number. Valid
values for scope are:
full Display the full version number (i.e., all components). A
sequence of rules are used to run all the components
together into a single string. Generally: major and minor
are always displayed, but other components are only
displayed if they are not zero.
major Display the major version number
minor Display the minor version number
release Display the release version number
alpha Display the alpha version number. In the full scope, if
nonzero, this number will be preceeded by "a".
beta Display the beta version number. In the full scope, if
nonzero, this number will be preceeded by "b".
cvs Display whether LAM was installed from a CVS checkout. In
pretty mode, this will be the string "cvs" if true, or
blank if false. In parsable mode, this will be 1 if true,
0 if false.
EXAMPLES
laminfo
With no parameters, laminfo displays a default set of information
about the LAM/MPI installation. This information includes:
- Version of LAM/MPI
- Installation prefix directory
- Architecture that LAM/MPI is installed for
- User who configured LAM/MPI
- Time/datestamp when LAM/MPI was configured
- Host that LAM/MPI was configured on
- Whether MPI bindings are provided for C, C++, Fortran
- Whether MPI profiling is available for C, C++, Fortran
- Whether ROMIO support is included
- Whether IMPI support is included
- Whether debug support is included (mainly for LAM/MPI maintainers;
specifically indicates whether --with-debug was used to configure
LAM)
- Whether LAM/MPI is "purify clean" (suitable for memory-checking
debuggers; specifically indicates whether --with-purify was used to
configure LAM)
- List all boot, coll, and rpi SSI modules that are available, and
their corresponding versions
laminfo -parsable
Display the same default set of information but in a machine-
readable format.
laminfo -all
Display all information that is available to laminfo.
laminfo -param all all
Show all SSI parameters (and their corresponding default values)
for all available SSI types and modules.
laminfo -param rpi all
Show all SSI parameters (and their corresponding default values)
for all rpi SSI modules.
laminfo -param rpi tcp
Show all SSI parameters (and their corresponding default values)
for the tcp rpi SSI module.
laminfo -param rpi tcp -parsable
Show all SSI parameters (and their corresponding default values)
for the tcp rpi SSI module in a machine-readable format.
laminfo -path bindir -path sysconfdir -parsable
Display the directories where the LAM/MPI executables and
help/configuration files were installed in a machine-readable
format.
laminfo -version lam full -parsable
Display the full version of LAM/MPI in a machine-readable format.
laminfo -version rpi:tcp full
Show the full version of the TCP RPI SSI module.
SEE ALSO
lamssi(7), mpirun(1), lamboot(1), lamwipe(1)