gs_device_mpi.F90

Go to the documentation of this file.

! Copyright (c) 2020-2025, The Neko Authors
! All rights reserved.
!
! Redistribution and use in source and binary forms, with or without
! modification, are permitted provided that the following conditions
! are met:
!
!   * Redistributions of source code must retain the above copyright
!     notice, this list of conditions and the following disclaimer.
!
!   * Redistributions in binary form must reproduce the above
!     copyright notice, this list of conditions and the following
!     disclaimer in the documentation and/or other materials provided
!     with the distribution.
!
!   * Neither the name of the authors nor the names of its
!     contributors may be used to endorse or promote products derived
!     from this software without specific prior written permission.
!
! THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
! "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
! LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
! FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
! COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
! INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
! BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
! LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
! CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
! LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
! ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
! POSSIBILITY OF SUCH DAMAGE.
!
module gs_device_mpi
  use num_types, only : rp, c_rp
  use gs_comm, only : gs_comm_t, gs_vec_nc
  use stack, only : stack_i4_t
  use comm, only : pe_size, pe_rank
  use htable, only : htable_i4_t
  use device, only : device_memcpy, device_alloc, device_event_create, &
       device_event_destroy, device_stream_create_with_priority, device_sync, &
       device_stream_wait_event, device_get_ptr, device_event_record, &
       device_stream_destroy, device_free, device_memset, &
       strm_high_prio, host_to_device
  use utils, only : neko_error
  use, intrinsic :: iso_c_binding, only : c_sizeof, c_int32_t, &
       c_ptr, c_null_ptr, c_size_t, c_associated
  implicit none
  private
 
  type, private :: gs_device_mpi_buf_t
     integer, allocatable :: ndofs(:)
     integer, allocatable :: offset(:)
     integer :: total
     type(c_ptr) :: reqs = c_null_ptr 
     type(c_ptr) :: buf_d = c_null_ptr 
     type(c_ptr) :: buf_v_d = c_null_ptr 
     type(c_ptr) :: dof_d = c_null_ptr 
   contains
     procedure, pass(this) :: init => gs_device_mpi_buf_init
     procedure, pass(this) :: free => gs_device_mpi_buf_free
  end type gs_device_mpi_buf_t
 
  type, public, extends(gs_comm_t) :: gs_device_mpi_t
     type(gs_device_mpi_buf_t) :: send_buf
     type(gs_device_mpi_buf_t) :: recv_buf
     type(c_ptr), allocatable :: stream(:)
     type(c_ptr), allocatable :: event(:)
     integer :: nb_strtgy
     type(c_ptr) :: send_event = c_null_ptr
   contains
     procedure, pass(this) :: init => gs_device_mpi_init
     procedure, pass(this) :: free => gs_device_mpi_free
     procedure, pass(this) :: nbsend => gs_device_mpi_nbsend
     procedure, pass(this) :: nbrecv => gs_device_mpi_nbrecv
     procedure, pass(this) :: nbwait => gs_device_mpi_nbwait
     procedure, pass(this) :: nbsend_vec => gs_device_mpi_nbsend_vec
     procedure, pass(this) :: nbrecv_vec => gs_device_mpi_nbrecv_vec
     procedure, pass(this) :: nbwait_vec => gs_device_mpi_nbwait_vec
  end type gs_device_mpi_t
 
#ifdef HAVE_HIP
  interface
     subroutine hip_gs_pack(u_d, buf_d, dof_d, offset, n, stream) &
          bind(c, name = 'hip_gs_pack')
       use, intrinsic :: iso_c_binding
       implicit none
       integer(c_int), value :: n, offset
       type(c_ptr), value :: u_d, buf_d, dof_d, stream
     end subroutine hip_gs_pack
  end interface
 
  interface
     subroutine hip_gs_unpack(u_d, op, buf_d, dof_d, offset, n, stream) &
          bind(c, name = 'hip_gs_unpack')
       use, intrinsic :: iso_c_binding
       implicit none
       integer(c_int), value :: op, offset, n
       type(c_ptr), value :: u_d, buf_d, dof_d, stream
     end subroutine hip_gs_unpack
  end interface
 
  interface
     subroutine hip_gs_pack_vec(u_d, buf_d, dof_d, offset, n, nc, ns, stream) &
          bind(c, name = 'hip_gs_pack_vec')
       use, intrinsic :: iso_c_binding
       implicit none
       integer(c_int), value :: offset, n, nc, ns
       type(c_ptr), value :: u_d, buf_d, dof_d, stream
     end subroutine hip_gs_pack_vec
  end interface
 
  interface
     subroutine hip_gs_unpack_vec(u_d, op, buf_d, dof_d, offset, n, nc, ns, &
          stream) bind(c, name = 'hip_gs_unpack_vec')
       use, intrinsic :: iso_c_binding
       implicit none
       integer(c_int), value :: op, offset, n, nc, ns
       type(c_ptr), value :: u_d, buf_d, dof_d, stream
     end subroutine hip_gs_unpack_vec
  end interface
#elif HAVE_CUDA
  interface
     subroutine cuda_gs_pack(u_d, buf_d, dof_d, offset, n, stream) &
          bind(c, name = 'cuda_gs_pack')
       use, intrinsic :: iso_c_binding
       implicit none
       integer(c_int), value :: n, offset
       type(c_ptr), value :: u_d, buf_d, dof_d, stream
     end subroutine cuda_gs_pack
  end interface
 
  interface
     subroutine cuda_gs_unpack(u_d, op, buf_d, dof_d, offset, n, stream) &
          bind(c, name = 'cuda_gs_unpack')
       use, intrinsic :: iso_c_binding
       implicit none
       integer(c_int), value :: op, offset, n
       type(c_ptr), value :: u_d, buf_d, dof_d, stream
     end subroutine cuda_gs_unpack
  end interface
 
  interface
     subroutine cuda_gs_pack_vec(u_d, buf_d, dof_d, offset, n, nc, ns, stream) &
          bind(c, name = 'cuda_gs_pack_vec')
       use, intrinsic :: iso_c_binding
       implicit none
       integer(c_int), value :: offset, n, nc, ns
       type(c_ptr), value :: u_d, buf_d, dof_d, stream
     end subroutine cuda_gs_pack_vec
  end interface
 
  interface
     subroutine cuda_gs_unpack_vec(u_d, op, buf_d, dof_d, offset, n, nc, ns, &
          stream) bind(c, name = 'cuda_gs_unpack_vec')
       use, intrinsic :: iso_c_binding
       implicit none
       integer(c_int), value :: op, offset, n, nc, ns
       type(c_ptr), value :: u_d, buf_d, dof_d, stream
     end subroutine cuda_gs_unpack_vec
  end interface
#endif
 
  interface
     subroutine device_mpi_init_reqs(n, reqs) &
          bind(c, name = 'device_mpi_init_reqs')
       use, intrinsic :: iso_c_binding
       implicit none
       integer(c_int), value :: n
       type(c_ptr) :: reqs
     end subroutine device_mpi_init_reqs
  end interface
 
  interface
     subroutine device_mpi_free_reqs(reqs) &
          bind(c, name = 'device_mpi_free_reqs')
       use, intrinsic :: iso_c_binding
       implicit none
       type(c_ptr) :: reqs
     end subroutine device_mpi_free_reqs
  end interface
 
  interface
     subroutine device_mpi_isend(buf_d, offset, nbytes, rank, tag, reqs, i) &
          bind(c, name = 'device_mpi_isend')
       use, intrinsic :: iso_c_binding
       implicit none
       integer(c_int), value :: offset, nbytes, rank, tag, i
       type(c_ptr), value :: buf_d, reqs
     end subroutine device_mpi_isend
  end interface
 
  interface
     subroutine device_mpi_irecv(buf_d, offset, nbytes, rank, tag, reqs, i) &
          bind(c, name = 'device_mpi_irecv')
       use, intrinsic :: iso_c_binding
       implicit none
       integer(c_int), value :: offset, nbytes, rank, tag, i
       type(c_ptr), value :: buf_d, reqs
     end subroutine device_mpi_irecv
  end interface
 
  interface
     integer(c_int) function device_mpi_test(reqs, i) &
          bind(c, name = 'device_mpi_test')
       use, intrinsic :: iso_c_binding
       implicit none
       integer(c_int), value :: i
       type(c_ptr), value :: reqs
     end function device_mpi_test
  end interface
 
  interface
     subroutine device_mpi_waitall(n, reqs) &
          bind(c, name = 'device_mpi_waitall')
       use, intrinsic :: iso_c_binding
       implicit none
       integer(c_int), value :: n
       type(c_ptr), value :: reqs
     end subroutine device_mpi_waitall
  end interface
 
  interface
     integer(c_int) function device_mpi_waitany(n, reqs, i) &
          bind(c, name = 'device_mpi_waitany')
       use, intrinsic :: iso_c_binding
       implicit none
       integer(c_int), value :: n
       integer(c_int) :: i
       type(c_ptr), value :: reqs
     end function device_mpi_waitany
  end interface
 
contains
 
  subroutine gs_device_mpi_buf_init(this, pe_order, dof_stack, mark_dupes)
    class(gs_device_mpi_buf_t), intent(inout) :: this
    integer, allocatable, intent(inout) :: pe_order(:)
    type(stack_i4_t), allocatable, intent(inout) :: dof_stack(:)
    logical, intent(in) :: mark_dupes
    integer, allocatable :: dofs(:)
    integer :: i, j, total
    integer(c_size_t) :: sz
    type(htable_i4_t) :: doftable
    integer :: dupe, marked, k
    real(c_rp) :: rp_dummy
    integer(c_int32_t) :: i4_dummy
 
    call device_mpi_init_reqs(size(pe_order), this%reqs)
 
    allocate(this%ndofs(size(pe_order)))
    allocate(this%offset(size(pe_order)))
 
    total = 0
    do i = 1, size(pe_order)
       this%ndofs(i) = dof_stack(pe_order(i))%size()
       this%offset(i) = total
       total = total + this%ndofs(i)
    end do
 
    this%total = total
 
    sz = c_sizeof(rp_dummy) * total
    call device_alloc(this%buf_d, sz)
    call device_memset(this%buf_d, 0, sz, sync = .true.)
 
    ! Fused vector buffer, sized for up to GS_VEC_NC components.
    sz = c_sizeof(rp_dummy) * gs_vec_nc * total
    call device_alloc(this%buf_v_d, sz)
    call device_memset(this%buf_v_d, 0, sz, sync = .true.)
 
    sz = c_sizeof(i4_dummy) * total
    call device_alloc(this%dof_d, sz)
 
    if (mark_dupes) call doftable%init(2*total)
    allocate(dofs(total))
 
    ! Copy from dof_stack into dofs, optionally marking duplicates with doftable
    marked = 0
    do i = 1, size(pe_order)
       ! %array() breaks on cray
       select type (arr => dof_stack(pe_order(i))%data)
       type is (integer)
          do j = 1, this%ndofs(i)
             k = this%offset(i) + j
             if (mark_dupes) then
                if (doftable%get(arr(j), dupe) .eq. 0) then
                   if (dofs(dupe) .gt. 0) then
                      dofs(dupe) = -dofs(dupe)
                      marked = marked + 1
                   end if
                   dofs(k) = -arr(j)
                   marked = marked + 1
                else
                   call doftable%set(arr(j), k)
                   dofs(k) = arr(j)
                end if
             else
                dofs(k) = arr(j)
             end if
          end do
       end select
    end do
    call device_memcpy(dofs, this%dof_d, total, host_to_device, &
         sync = .true.)
    ! Syncing here prevents the memory in dofs to accidently be corrupted
    ! while this memcpy is happening.
    ! This might be happening in many other places as well. Karp 4/6-25
 
    deallocate(dofs)
    call doftable%free()
 
  end subroutine gs_device_mpi_buf_init
 
  subroutine gs_device_mpi_buf_free(this)
    class(gs_device_mpi_buf_t), intent(inout) :: this
 
    if (c_associated(this%reqs)) call device_mpi_free_reqs(this%reqs)
 
    if (allocated(this%ndofs)) deallocate(this%ndofs)
    if (allocated(this%offset)) deallocate(this%offset)
 
    if (c_associated(this%buf_d)) call device_free(this%buf_d)
    if (c_associated(this%buf_v_d)) call device_free(this%buf_v_d)
    if (c_associated(this%dof_d)) call device_free(this%dof_d)
  end subroutine gs_device_mpi_buf_free
 
  subroutine gs_device_mpi_init(this, send_pe, recv_pe)
    class(gs_device_mpi_t), intent(inout) :: this
    type(stack_i4_t), intent(inout) :: send_pe
    type(stack_i4_t), intent(inout) :: recv_pe
    integer :: i, nstrm
 
    call this%init_order(send_pe, recv_pe)
 
    call this%send_buf%init(this%send_pe, this%send_dof, .false.)
    call this%recv_buf%init(this%recv_pe, this%recv_dof, .true.)
 
#if defined(HAVE_HIP) || defined(HAVE_CUDA)
    ! Create a set of non-blocking streams. The per-peer streams and events
    ! are indexed over both send_pe (pack) and recv_pe (unpack, sync), so
    ! size them for the larger of the two peer lists.
    nstrm = max(size(this%send_pe), size(this%recv_pe))
    allocate(this%stream(nstrm))
    do i = 1, nstrm
       call device_stream_create_with_priority(this%stream(i), 1, &
            strm_high_prio)
    end do
 
    allocate(this%event(nstrm))
    do i = 1, nstrm
       call device_event_create(this%event(i), 2)
    end do
#endif
 
 
    this%nb_strtgy = 0
 
    this%vec_supported = .true.
 
  end subroutine gs_device_mpi_init
 
  subroutine gs_device_mpi_free(this)
    class(gs_device_mpi_t), intent(inout) :: this
    integer :: i
 
    call this%send_buf%free()
    call this%recv_buf%free()
 
    call this%free_order()
    call this%free_dofs()
 
#if defined(HAVE_HIP) || defined(HAVE_CUDA)
    if (allocated(this%stream)) then
       do i = 1, size(this%stream)
          call device_stream_destroy(this%stream(i))
       end do
       deallocate(this%stream)
    end if
 
    if (allocated(this%event)) then
       do i = 1, size(this%event)
          call device_event_destroy(this%event(i))
       end do
       deallocate(this%event)
    end if
#endif
 
  end subroutine gs_device_mpi_free
 
  subroutine gs_device_mpi_nbsend(this, u, n, tag, deps, strm)
    class(gs_device_mpi_t), intent(inout) :: this
    integer, intent(in) :: n
    real(kind=rp), dimension(n), intent(inout) :: u
    integer, intent(in) :: tag
    type(c_ptr), intent(inout) :: deps
    type(c_ptr), intent(inout) :: strm
    integer :: i
    type(c_ptr) :: u_d
 
    u_d = device_get_ptr(u)
 
    if (iand(this%nb_strtgy, 1) .eq. 0) then
 
#ifdef HAVE_HIP
       call hip_gs_pack(u_d, &
            this%send_buf%buf_d, &
            this%send_buf%dof_d, &
            0, this%send_buf%total, &
            strm)
#elif HAVE_CUDA
       call cuda_gs_pack(u_d, &
            this%send_buf%buf_d, &
            this%send_buf%dof_d, &
            0, this%send_buf%total, &
            strm)
#else
       call neko_error('gs_device_mpi: no backend')
#endif
 
       call device_sync(strm)
 
       do i = 1, size(this%send_pe)
          call device_mpi_isend(this%send_buf%buf_d, &
               rp*this%send_buf%offset(i), &
               rp*this%send_buf%ndofs(i), this%send_pe(i), tag, &
               this%send_buf%reqs, i)
       end do
 
    else
 
       do i = 1, size(this%send_pe)
          call device_stream_wait_event(this%stream(i), deps, 0)
#ifdef HAVE_HIP
          call hip_gs_pack(u_d, &
               this%send_buf%buf_d, &
               this%send_buf%dof_d, &
               this%send_buf%offset(i), &
               this%send_buf%ndofs(i), &
               this%stream(i))
#elif HAVE_CUDA
          call cuda_gs_pack(u_d, &
               this%send_buf%buf_d, &
               this%send_buf%dof_d, &
               this%send_buf%offset(i), &
               this%send_buf%ndofs(i), &
               this%stream(i))
#else
          call neko_error('gs_device_mpi: no backend')
#endif
       end do
 
       ! Consider adding a poll loop here once we have device_query in place
       do i = 1, size(this%send_pe)
          call device_sync(this%stream(i))
          call device_mpi_isend(this%send_buf%buf_d, &
               rp*this%send_buf%offset(i), &
               rp*this%send_buf%ndofs(i), this%send_pe(i), tag, &
               this%send_buf%reqs, i)
       end do
    end if
 
  end subroutine gs_device_mpi_nbsend
 
  subroutine gs_device_mpi_nbrecv(this, tag)
    class(gs_device_mpi_t), intent(inout) :: this
    integer, intent(in) :: tag
    integer :: i
 
    do i = 1, size(this%recv_pe)
       call device_mpi_irecv(this%recv_buf%buf_d, rp*this%recv_buf%offset(i), &
            rp*this%recv_buf%ndofs(i), this%recv_pe(i), tag, &
            this%recv_buf%reqs, i)
    end do
 
  end subroutine gs_device_mpi_nbrecv
 
  subroutine gs_device_mpi_nbwait(this, u, n, op, strm)
    class(gs_device_mpi_t), intent(inout) :: this
    integer, intent(in) :: n
    real(kind=rp), dimension(n), intent(inout) :: u
    type(c_ptr), intent(inout) :: strm
    integer :: op, done_req, i
    type(c_ptr) :: u_d
 
    u_d = device_get_ptr(u)
 
    if (iand(this%nb_strtgy, 2) .eq. 0) then
       call device_mpi_waitall(size(this%recv_pe), this%recv_buf%reqs)
 
#ifdef HAVE_HIP
       call hip_gs_unpack(u_d, op, &
            this%recv_buf%buf_d, &
            this%recv_buf%dof_d, &
            0, this%recv_buf%total, &
            strm)
#elif HAVE_CUDA
       call cuda_gs_unpack(u_d, op, &
            this%recv_buf%buf_d, &
            this%recv_buf%dof_d, &
            0, this%recv_buf%total, &
            strm)
#else
       call neko_error('gs_device_mpi: no backend')
#endif
 
       call device_mpi_waitall(size(this%send_pe), this%send_buf%reqs)
 
       ! Syncing here seems to prevent some race condition
       call device_sync(strm)
 
    else
 
       do while (device_mpi_waitany(size(this%recv_pe), &
            this%recv_buf%reqs, done_req) .ne. 0)
 
#ifdef HAVE_HIP
          call hip_gs_unpack(u_d, op, &
               this%recv_buf%buf_d, &
               this%recv_buf%dof_d, &
               this%recv_buf%offset(done_req), &
               this%recv_buf%ndofs(done_req), &
               this%stream(done_req))
#elif HAVE_CUDA
          call cuda_gs_unpack(u_d, op, &
               this%recv_buf%buf_d, &
               this%recv_buf%dof_d, &
               this%recv_buf%offset(done_req), &
               this%recv_buf%ndofs(done_req), &
               this%stream(done_req))
#else
          call neko_error('gs_device_mpi: no backend')
#endif
          call device_event_record(this%event(done_req), this%stream(done_req))
       end do
 
       call device_mpi_waitall(size(this%send_pe), this%send_buf%reqs)
 
       ! Sync non-blocking streams
       do done_req = 1, size(this%recv_pe)
          call device_stream_wait_event(strm, &
               this%event(done_req), 0)
       end do
 
    end if
 
  end subroutine gs_device_mpi_nbwait
 
  subroutine gs_device_mpi_nbsend_vec(this, u, n, nc, tag, deps, strm)
    class(gs_device_mpi_t), intent(inout) :: this
    integer, intent(in) :: n, nc
    real(kind=rp), dimension(nc*n), intent(inout) :: u
    integer, intent(in) :: tag
    type(c_ptr), intent(inout) :: deps
    type(c_ptr), intent(inout) :: strm
    integer :: i
    type(c_ptr) :: u_d
 
    u_d = device_get_ptr(u)
 
#ifdef HAVE_HIP
    call hip_gs_pack_vec(u_d, this%send_buf%buf_v_d, this%send_buf%dof_d, &
         0, this%send_buf%total, nc, n, strm)
#elif HAVE_CUDA
    call cuda_gs_pack_vec(u_d, this%send_buf%buf_v_d, this%send_buf%dof_d, &
         0, this%send_buf%total, nc, n, strm)
#else
    call neko_error('gs_device_mpi: no backend')
#endif
 
    call device_sync(strm)
 
    do i = 1, size(this%send_pe)
       call device_mpi_isend(this%send_buf%buf_v_d, &
            rp*nc*this%send_buf%offset(i), &
            rp*nc*this%send_buf%ndofs(i), this%send_pe(i), tag, &
            this%send_buf%reqs, i)
    end do
 
  end subroutine gs_device_mpi_nbsend_vec
 
  subroutine gs_device_mpi_nbrecv_vec(this, tag, nc)
    class(gs_device_mpi_t), intent(inout) :: this
    integer, intent(in) :: tag, nc
    integer :: i
 
    do i = 1, size(this%recv_pe)
       call device_mpi_irecv(this%recv_buf%buf_v_d, &
            rp*nc*this%recv_buf%offset(i), &
            rp*nc*this%recv_buf%ndofs(i), this%recv_pe(i), tag, &
            this%recv_buf%reqs, i)
    end do
 
  end subroutine gs_device_mpi_nbrecv_vec
 
  subroutine gs_device_mpi_nbwait_vec(this, u, n, nc, op, strm)
    class(gs_device_mpi_t), intent(inout) :: this
    integer, intent(in) :: n, nc
    real(kind=rp), dimension(nc*n), intent(inout) :: u
    type(c_ptr), intent(inout) :: strm
    integer :: op
    type(c_ptr) :: u_d
 
    u_d = device_get_ptr(u)
 
    call device_mpi_waitall(size(this%recv_pe), this%recv_buf%reqs)
 
#ifdef HAVE_HIP
    call hip_gs_unpack_vec(u_d, op, this%recv_buf%buf_v_d, &
         this%recv_buf%dof_d, 0, this%recv_buf%total, nc, n, strm)
#elif HAVE_CUDA
    call cuda_gs_unpack_vec(u_d, op, this%recv_buf%buf_v_d, &
         this%recv_buf%dof_d, 0, this%recv_buf%total, nc, n, strm)
#else
    call neko_error('gs_device_mpi: no backend')
#endif
 
    call device_mpi_waitall(size(this%send_pe), this%send_buf%reqs)
 
    call device_sync(strm)
 
  end subroutine gs_device_mpi_nbwait_vec
 
end module gs_device_mpi