- see src/util/show_help.h for details (doxygen); main function call
is ompi_show_help()
- text message files are expected to be located in $pkgdatadir
(usually $prefix/share/openmpi). Anyone can install a text file in
$pkgdatadir with their message(s) in it and then have them displayed
via ompi_show_help(). "pkgdata_DATA" is the keyword to use in
Makefile.am's, for example (from src/mca/base/Makefile.am):
pkgdata_DATA = help-mca-base.txt
- added a few examples in the code base using ompi_show_help(), but
not too many -- can convert more "show_help" comments in the code
over time; no huge rush. :-)
- no i18n-like support yet; waiting for advice and consensus from
other developers
This commit was SVN r2519.
resolution is now (effectively):
- read from MPI keyval (if associated)
- read from command line
- read from environment
- read from file
More capabilities will be added shortly for developers to
programatically set MCA parameter values
- Create [empty but commented] system-wide MCA param file that gets
installed at $sysconf/openmpi-mca-params.conf (i.e.,
$prefix/etc/openmpi-mca-params.conf)
- The following files are opened and read (in order):
1. $sysconf/openmpi-mca-params.conf
2. $HOME/.openmpi/mca-params.conf
Specifically, the values in 2) will override the values in 1) (so
users can override system-wide defaults.
- Update MCA string params to allow for "~/" in the middle to be
expanded to the user's home directory.
- Added to default value of MCA parameter component_path to be:
$pkglibdir:$HOME/.openmpi/components
$pkglibdir is typically $prefix/lib/openmpi. So now both of these
directories will be searched for components at run time (in all Open
MPI executables, including ompi_info). Note that this is an MCA
parameter, so it, too, can be changed at run-time.
- Updated all docs to match this behavior -- some is \internal, so it
doesn't show unless you tell doxygen to generate internal docs
(which is not the default)
- update ompi_info to handle new behavior; ompi_info --param now shows
the *current* default value (i.e., it will look in the environment
and/or files to find out what the default values are -- so if you
change a value in $HOME/.openmpi/mca-params.conf, it should be
reflected in "ompi_info --param all all")
- updated bunches of doxygen docs to match
- this diff is slightly artifically large -- some of the changes are
converstions to 4 space tabs (I re-indented my own code that
previously used 2 space tabs)
This commit was SVN r2408.
code base.
- many (most) mca type names have "component" or "module" in them,
as relevant, just to further distinguish the difference between
component data/actions and module data/actions. All developers
are encouraged to perpetuate this convention when you create
types that are specific to a framework, component, or module
- did very little to entire framework (just the basics to make it
compile) because it's just about to be almost entirely replaced
- ditto for io / romio
- did not work on elan or ib components; have to commit and then
convert those on a different machine with the right libraries and
headers
- renamed a bunch of *_module.c files to *_component.c and *module*c
to *component*c (a few still remain, e.g., ptl/ib, ptl/elan, etc.)
- modified autogen/configure/build process to match new filenames
(e.g., output static-components.h instead of static-modules.h)
- removed DOS-style cr/lf stuff in ns/ns.h
- added newline to end of file src/util/numtostr.h
- removed some redundant error checking in the top-level topo
functions
- added a few {} here and there where people "forgot" to put them in
for 1 line blocks ;-)
- removed a bunch of MPI_* types from mca header files (replaced with
corresponding ompi_* types)
- all the ptl components had version numbers in their structs; removed
- converted a few more elements in the MCA base to use the OBJ
interface -- removed some old manual reference counting kruft
This commit was SVN r1830.
- Various fixes / cleanups as a result of the code review
George makes a good point that we could consolidate a lot of the
malloc's / strdup's in this code for platforms where we do not have
a lot of memory (i.e., add up all the memory required and make one
big malloc vs. lots of little mallocs). This is something for
post-first-release.
- Convert another data structure to the OBJ_* interface.
- Split the internal prototypes and struct definitions into their own
header file that won't be included anywhere else in Open MPI (except
ompi_info).
This commit was SVN r1692.
real commit of the collectives. MPI_SCAN and MPI_EXSCAN are still not
implemented, but lots of other things are in the critical path and
holding up other people, so it's ok to commit without them:
- better checks for sizes in configure, and add defaults for fortran
sizes if we don't have a fortran compiler
- fix some logic that was accidentally broken for size checks for the
file type offset_t
- add some C equivalent types for fortran's complex and double complex
(for use in internal reduction/op functions)
- additionals and slight reorganization of ompi_mpi_init()
ompi_mpi_finalize()
- fully implement all top-level MPI collective calls, including all
param checking for both intra- and inter-communicators (woof)
- change the communicator_t type for stuff that we need in coll, and
update all references throughout the code base to match
- all kinds of updates to the coll framework base
- next cut of the basic coll module -- has all intracommunicator
collectives implemented except scan and exscan (see note above).
All intercommunicator functions return ERR_NOT_IMPLEMENTED.
- MPI_Op is a fixed implementation -- not component-ized yet. So
there are generic C loops for all implementations.
This commit was SVN r1491.
