procset_module.h

Go to the documentation of this file.

/*
 * Copyright 2025 Stanford University, NVIDIA Corporation
 * SPDX-License-Identifier: Apache-2.0
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 
#ifndef REALM_PROCSET_MODULE_H
#define REALM_PROCSET_MODULE_H
 
#include "realm/module.h"
 
namespace Realm {
 
  namespace ProcSet {
 
    class ProcSetModuleConfig : public ModuleConfig {
      friend class ProcSetModule;
 
    protected:
      ProcSetModuleConfig(void);
 
    public:
      virtual void configure_from_cmdline(std::vector<std::string> &cmdline);
 
    protected:
      int cfg_num_mp_threads = 0; // threads per ProcSet
      int cfg_num_mp_procs = 0;   // number of ProcSets
      int cfg_num_mp_cpus = 0;    // additional cpus on any non ProcSet nodes
      size_t cfg_stack_size = 2 << 20;
    };
 
    // our interface to the rest of the runtime
    class ProcSetModule : public Module {
    protected:
      ProcSetModule(void);
 
    public:
      virtual ~ProcSetModule(void);
 
      static ModuleConfig *create_module_config(RuntimeImpl *runtime);
 
      static Module *create_module(RuntimeImpl *runtime);
 
      // do any general initialization - this is called after all configuration is
      //  complete
      virtual void initialize(RuntimeImpl *runtime);
 
      // create any memories provided by this module (default == do nothing)
      //  (each new MemoryImpl should use a Memory from RuntimeImpl::next_local_memory_id)
      virtual void create_memories(RuntimeImpl *runtime);
 
      // create any processors provided by the module (default == do nothing)
      //  (each new ProcessorImpl should use a Processor from
      //   RuntimeImpl::next_local_processor_id)
      virtual void create_processors(RuntimeImpl *runtime);
 
      // create any DMA channels provided by the module (default == do nothing)
      virtual void create_dma_channels(RuntimeImpl *runtime);
 
      // create any code translators provided by the module (default == do nothing)
      virtual void create_code_translators(RuntimeImpl *runtime);
 
      // clean up any common resources created by the module - this will be called
      //  after all memories/processors/etc. have been shut down and destroyed
      virtual void cleanup(void);
 
    public:
      ProcSetModuleConfig *config;
    };
 
  }; // namespace ProcSet
 
}; // namespace Realm
 
#endif