This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "MPICH primary repository". The branch, master has been updated via ee2f29508c93d5b37a979c0b0820a5401b6b69f8 (commit) from b8df3c9da9169577b880eac2e385d2eea0e1fe8d (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- http://git.mpich.org/mpich.git/commitdiff/ee2f29508c93d5b37a979c0b0820a5401b... commit ee2f29508c93d5b37a979c0b0820a5401b6b69f8 Author: Ken Raffenetti <[email protected]> Date: Tue Aug 30 12:52:42 2016 -0500 Add CH4 info to README and RELEASE_NOTES Signed-off-by: Pavan Balaji <[email protected]> diff --git a/README.vin b/README.vin index c845b17..5b0a2bf 100644 --- a/README.vin +++ b/README.vin @@ -397,8 +397,9 @@ relevant Makefiles. ================================= The communication mechanisms in MPICH are called "devices". MPICH -supports ch3 (default), as well as many third-party devices that are -released and maintained by other institutes. +supports ch3 (default) and ch4 (experimental), as well as many +third-party devices that are released and maintained by other +institutes. ************************************* @@ -577,6 +578,57 @@ channel can be configured using the following option: --with-device=ch3:sock + +ch4 device +********** +The ch4 device contains different network and shared memory modules +for communication. We currently support the ofi and ucx network +modules, and posix shared memory module. + +ofi network module +``````````````````` +The ofi netmod provides support for the OFI network programming interface. +To enable, configure with the following option: + + --with-device=ch4:ofi + +If the OFI include files and libraries are not in the normal search paths, +you can specify them with the following options: + + --with-libfabric-include= and --with-libfabric-lib= + +... or the if lib/ and include/ are in the same directory, you can use +the following option: + + --with-libfabric= + +ucx network module +`````````````````` +The ucx netmod provides support for the Unified Communication X +library. It can be built with the following configure option: + + --with-device=ch4:ucx + +If the UCX include files and libraries are not in the normal search paths, +you can specify them with the following options: + + --with-ucx-include= and --with-ucx-lib= + +... or the if lib/ and include/ are in the same directory, you can use +the following option: + + --with-ucx= + +By default, the UCX library throws warnings when the system does not +enable certain features that might hurt performance. These are +important warnings that might cause performance degradation on your +system. But you might need root privileges to fix some of them. If +you would like to disable such warnings, you can set the UCX log level +to "error" instead of the default "warn" by using: + + UCX_LOG_LEVEL=error + export UCX_LOG_LEVEL + ------------------------------------------------------------------------- 5. Alternate Process Managers diff --git a/RELEASE_NOTES b/RELEASE_NOTES index b3d7b1e..be423d0 100644 --- a/RELEASE_NOTES +++ b/RELEASE_NOTES @@ -2,6 +2,17 @@ KNOWN ISSUES ---------------------------------------------------------------------- +### CH4 preview + + * Build Issues + - CH4 will not build with "--enable-strict". + - CH4 will not build with Solaris compilers. + + * Test failures + - CH4 will not currently pass 100% of the testsuite. + - Test failures differ based on experimental setup and network + support built in. + ### Solaris compilers * Compilation on solaris will freeze when MPICH is configured with ----------------------------------------------------------------------- Summary of changes: README.vin | 56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-- RELEASE_NOTES | 11 +++++++++++ 2 files changed, 65 insertions(+), 2 deletions(-) hooks/post-receive -- MPICH primary repository