From 19a6e0e31ebb0d0d7098cef41f6386d0e4497359 Mon Sep 17 00:00:00 2001 From: Hui Zhou Date: Tue, 7 Nov 2023 18:50:03 -0600 Subject: [PATCH 1/2] threadcomm: enhance man pages Add short descriptions and SeeAlso. --- src/binding/c/threadcomm_api.txt | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/src/binding/c/threadcomm_api.txt b/src/binding/c/threadcomm_api.txt index 12ad4d5e12d..ee339a2078c 100644 --- a/src/binding/c/threadcomm_api.txt +++ b/src/binding/c/threadcomm_api.txt @@ -4,13 +4,20 @@ MPIX_Threadcomm_init: comm: COMMUNICATOR, [communicator] num_threads: ARRAY_LENGTH_NNI, [number of participating threads] newthreadcomm: COMMUNICATOR, direction=out, [new thread communicator] + .desc: initialize a thread communicator (outside thread parallel regions) + .seealso: MPIX_Threadcomm_start, MPIX_Threadcomm_finish, MPIX_Threadcomm_free MPIX_Threadcomm_free: threadcomm: COMMUNICATOR, direction=inout, [thread communicator] + .desc: free a thread communicator (outside thread parallel regions) + .seealso: MPIX_Threadcomm_init, MPIX_Threadcomm_start, MPIX_Threadcomm_finish MPIX_Threadcomm_start: threadcomm: COMMUNICATOR, [thread communicator] + .desc: start/activiate a thread communicator (inside thread parallel regions) + .seealso: MPIX_Threadcomm_init, MPIX_Threadcomm_finish, MPIX_Threadcomm_free MPIX_Threadcomm_finish: threadcomm: COMMUNICATOR, [thread communicator] - + .desc: finish/deactiviate a thread communicator (inside thread parallel regions) + .seealso: MPIX_Threadcomm_init, MPIX_Threadcomm_start, MPIX_Threadcomm_free From bfed0f55f50098d5bff5fa4492b7dca6b4ece447 Mon Sep 17 00:00:00 2001 From: Hui Zhou Date: Tue, 7 Nov 2023 18:50:31 -0600 Subject: [PATCH 2/2] doc: update CHANGES for 4.2 Add more entries to CHANGES. Update version to 4.2b1. --- CHANGES | 36 +++++++++++++++++++++++++++++++----- maint/version.m4 | 2 +- 2 files changed, 32 insertions(+), 6 deletions(-) diff --git a/CHANGES b/CHANGES index dd63974f6c8..b123a311e46 100644 --- a/CHANGES +++ b/CHANGES @@ -3,6 +3,15 @@ =============================================================================== # Complete support MPI 4.1 specification +# Experimental thread communicator feature (e.g. MPIX_Threadcomm_init). + See paper "Frustrated With MPI+Threads? Try MPIxThreads!", + https://doi.org/10.1145/3615318.3615320. + +# Experimental datatype functions MPIX_Type_iov_len and MPIX_Type_Iov + +# Experimental op MPIX_EQUAL for MPI_Reduce and MPI_Allreduce (intra + communicator only) + # Use --with-{pmi,pmi2,pmix]=[path] to configure external PMI library. Convenience options for Slurm and cray deprecated. Use --with-pmi=oldcray for older Cray environment. @@ -22,6 +31,28 @@ # Yaksa updated to auto detect the GPU architecture and only build for the detected arch. This applies to CUDA and HIP support. +# MPI_Win_shared_query can be used on windows created by MPI_Win_create, + MPI_Win_allocate, in addition to windows created by MPI_Win_allocate_shared. + MPI_Win_allocate will create shared memory whenever feasible, including between + spawned processes on the same node. + +# Fortran mpi.mod support Type(c_ptr) buffer output for MPI_Alloc_mem, + MPI_Win_allocate, and MPI_Win_allocate_shared. + +# New functions added in MPI-4.1: MPI_Remove_error_string, MPI_Remove_error_code, + and MPI_Remove_error_class + +# New functions added in MPI-4.1: MPI_Request_get_status_all, + MPI_Request_get_status_any, and MPI_Request_get_status_some. + +# New function added in MPI-4.1: MPI_Type_get_value_index. + +# New functions added in MPI-4.1: MPI_Comm_attach_buffer, MPI_Session_attach_buffer, + MPI_Comm_detach_buffer, MPI_Session_detach_buffer, + MPI_Buffer_flush, MPI_Comm_flush_buffer, MPI_Session_flush_buffer, + MPI_Buffer_iflush, MPI_Comm_iflush_buffer, and MPI_Session_iflush_buffer. + Also added constant MPI_BUFFER_AUTOMATIC to allow automatic buffers. + # Support for "mpi_memory_alloc_kinds" info key. Memory allocation kind requests can be made via argument to mpiexec, or as info during session creation. Kinds supported are "mpi" (with standard defined @@ -31,11 +62,6 @@ decided at the October 2023 meeting that this was a mistake and will be removed in an erratum. -# New functions added in MPI-4.1: MPI_Comm_attach_buffer, MPI_Session_attach_buffer, - MPI_Comm_detach_buffer, MPI_Session_detach_buffer, - MPI_Buffer_flush, MPI_Comm_flush_buffer, MPI_Session_flush_buffer, - MPI_Buffer_iflush, MPI_Comm_iflush_buffer, and MPI_Session_iflush_buffer. - Also added constant MPI_BUFFER_AUTOMATIC to allow automatic buffers. =============================================================================== Changes in 4.1 diff --git a/maint/version.m4 b/maint/version.m4 index 4c239e0696e..00048c5ef72 100644 --- a/maint/version.m4 +++ b/maint/version.m4 @@ -14,7 +14,7 @@ # changing this by playing with diversions, but then we would probably be # playing with autotools-fire. -m4_define([MPICH_VERSION_m4],[4.2a1])dnl +m4_define([MPICH_VERSION_m4],[4.2.0b1])dnl m4_define([MPICH_RELEASE_DATE_m4],[unreleased development copy])dnl # For libtool ABI versioning rules see: