init_finalize.h

Go to the documentation of this file.

// -----------------------------------------------------------------------------
//
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception OR LGPL-2.1-or-later
// Copyright (C) 2023 - 2025 by the deal.II authors
//
// This file is part of the deal.II library.
//
// Detailed license information governing the source code and contributions
// can be found in LICENSE.md and CONTRIBUTING.md at the top level directory.
//
// -----------------------------------------------------------------------------
 
#ifndef dealii_init_finalize_h
#define dealii_init_finalize_h
 
#include <deal.II/base/config.h>
 
#include <deal.II/base/mpi_stub.h>
#include <deal.II/base/numbers.h>
#include <deal.II/base/types.h>
 
#include <boost/signals2.hpp>
 
#include <set>
 
#ifdef DEAL_II_WITH_PSBLAS
#  include <psb_c_dbase.h>
#endif
 
DEAL_II_NAMESPACE_OPEN
 
enum class InitializeLibrary
{
  None = 0,
  MPI = 1,
  Kokkos = 2,
  SLEPc = 4,
  PETSc = 8,
  Zoltan = 16,
  P4EST = 32,
  PSBLAS = 64,
  GMSH = 128
};
 
 
 
inline InitializeLibrary
operator|(const InitializeLibrary f1, const InitializeLibrary f2)
{
  return static_cast<InitializeLibrary>(static_cast<unsigned int>(f1) |
                                        static_cast<unsigned int>(f2));
}
 
 
 
inline InitializeLibrary
operator&(const InitializeLibrary f1, const InitializeLibrary f2)
{
  return static_cast<InitializeLibrary>(static_cast<unsigned int>(f1) &
                                        static_cast<unsigned int>(f2));
}
 
 
 
class InitFinalize
{
public:
  InitFinalize(
    int                     &argc,
    char                  **&argv,
    const InitializeLibrary &libraries,
    const unsigned int       max_num_threads = numbers::invalid_unsigned_int);
 
  ~InitFinalize();
 
  void
  finalize();
 
  static void
  register_request(MPI_Request &request);
 
  static void
  unregister_request(MPI_Request &request);
 
#ifdef DEAL_II_WITH_PSBLAS
  static psb_c_ctxt *
  get_psblas_context();
#endif
 
  struct Signals
  {
    boost::signals2::signal<void()> at_mpi_init;
 
    boost::signals2::signal<void()> at_mpi_finalize;
  };
 
  static Signals signals;
 
private:
  InitializeLibrary libraries;
 
  static std::set<MPI_Request *> requests;
 
  bool is_finalized = false;
 
#ifdef DEAL_II_WITH_PETSC
  bool finalize_petscslepc;
#endif
 
#ifdef DEAL_II_WITH_PSBLAS
  static psb_c_ctxt *cctxt;
#endif
};
 
DEAL_II_NAMESPACE_CLOSE
 
#endif