remote_point.h

Go to the documentation of this file.

// Copyright (c) 2024 The YAC Authors
//
// SPDX-License-Identifier: BSD-3-Clause
 
#ifndef REMOTE_POINT_H
#define REMOTE_POINT_H
 
#include <stdint.h>
#include <mpi.h>
 
#include "yac_types.h"
 
struct remote_point_info {
  int rank;          // MPI rank
  uint64_t orig_pos; // local id on the remote process
};
 
//  more processes
struct remote_point_infos {
  int count; // number of processes
  union {
    struct remote_point_info single; // valid if count == 1;
    struct remote_point_info * multi; // valid if count != -1;
  } data; // remote process information
};
 
//  is located on one or more processes
struct remote_point {
  yac_int global_id;
  struct remote_point_infos data;
};
 
//  about a list of points that are located on one or more processes
struct remote_points {
  struct remote_point * data;
  size_t count;
  struct remote_point_info buffer[]; // buffer required to
                                     // store location information
};
 
MPI_Datatype yac_get_remote_point_info_mpi_datatype(MPI_Comm comm);
 
int yac_remote_point_infos_get_pack_size(
  struct remote_point_infos const * infos, MPI_Datatype point_info_dt,
  MPI_Comm comm);
 
void yac_remote_point_infos_pack(
  struct remote_point_infos const * infos, void * buffer, int buffer_size,
  int * position, MPI_Datatype point_info_dt, MPI_Comm comm);
 
void yac_remote_point_infos_unpack(
  void * buffer, int buffer_size, int * position,
  struct remote_point_infos * infos, MPI_Datatype point_info_dt,
  MPI_Comm comm);
 
int yac_remote_point_get_pack_size(
  struct remote_point * point, MPI_Datatype point_info_dt, MPI_Comm comm);
 
void yac_remote_point_pack(
  struct remote_point * point, void * buffer, int buffer_size, int * position,
  MPI_Datatype point_info_dt, MPI_Comm comm);
 
void yac_remote_point_unpack(
  void * buffer, int buffer_size, int * position, struct remote_point * point,
  MPI_Datatype point_info_dt, MPI_Comm comm);
 
int yac_remote_points_get_pack_size(
  struct remote_points * points, MPI_Datatype point_info_dt, MPI_Comm comm);
 
void yac_remote_points_pack(
  struct remote_points * points, void * buffer, int buffer_size, int * position,
  MPI_Datatype point_info_dt, MPI_Comm comm);
 
void yac_remote_points_unpack(
  void * buffer, int buffer_size, int * position,
  struct remote_points ** points, MPI_Datatype point_info_dt, MPI_Comm comm);
 
#endif // REMOTE_POINT_H