Man Linux: Main Page and Category List

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)