1 /* Copyright (c) 2007-2021. The SimGrid Team. All rights reserved. */
3 /* This program is free software; you can redistribute it and/or modify it
4 * under the terms of the license (GNU LGPL) which comes with this package. */
7 #include "simgrid/Exception.hpp"
8 #include "simgrid/plugins/file_system.h"
9 #include "simgrid/s4u/Engine.hpp"
10 #include "smpi_coll.hpp"
11 #include "smpi_config.hpp"
12 #include "smpi_f2c.hpp"
13 #include "smpi_host.hpp"
14 #include "src/kernel/EngineImpl.hpp"
15 #include "src/kernel/activity/CommImpl.hpp"
16 #include "src/smpi/include/smpi_actor.hpp"
17 #include "xbt/config.hpp"
18 #include "xbt/file.hpp"
22 #include <boost/algorithm/string.hpp> /* split */
23 #include <boost/tokenizer.hpp>
26 #include <cstdint> /* intmax_t */
27 #include <cstring> /* strerror */
34 #include <sys/sendfile.h>
41 #if not defined(__APPLE__) && not defined(__HAIKU__)
45 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(smpi_kernel, smpi, "Logging specific to SMPI (kernel)");
48 extern "C" void for_rtl_init_ (int *, char **);
49 extern "C" void for_rtl_finish_ ();
51 extern "C" void __io_set_argc(int);
52 extern "C" void __io_set_argv(char **);
54 extern "C" void _gfortran_set_args(int, char **);
57 /* RTLD_DEEPBIND is a bad idea of GNU ld that obviously does not exist on other platforms
58 * See https://www.akkadia.org/drepper/dsohowto.pdf
59 * and https://lists.freebsd.org/pipermail/freebsd-current/2016-March/060284.html
61 #if !RTLD_DEEPBIND || HAVE_SANITIZER_ADDRESS || HAVE_SANITIZER_THREAD
62 #define WANT_RTLD_DEEPBIND 0
64 #define WANT_RTLD_DEEPBIND RTLD_DEEPBIND
68 std::map</* computation unit name */ std::string, papi_process_data, std::less<>> units2papi_setup;
71 std::unordered_map<std::string, double> location2speedup;
73 static int smpi_exit_status = 0;
74 xbt_os_timer_t global_timer;
75 static std::vector<std::string> privatize_libs_paths;
77 // No instance gets manually created; check also the smpirun.in script as
78 // this default name is used there as well (when the <actor> tag is generated).
79 static const std::string smpi_default_instance_name("smpirun");
81 static simgrid::config::Flag<std::string>
82 smpi_hostfile("smpi/hostfile",
83 "Classical MPI hostfile containing list of machines to dispatch "
84 "the processes, one per line",
87 static simgrid::config::Flag<std::string> smpi_replay("smpi/replay",
88 "Replay a trace instead of executing the application", "");
90 static simgrid::config::Flag<int> smpi_np("smpi/np", "Number of processes to be created", 0);
92 static simgrid::config::Flag<int> smpi_map("smpi/map", "Display the mapping between nodes and processes", 0);
94 void (*smpi_comm_copy_data_callback)(simgrid::kernel::activity::CommImpl*, void*,
95 size_t) = &smpi_comm_copy_buffer_callback;
97 simgrid::smpi::ActorExt* smpi_process()
99 simgrid::s4u::ActorPtr me = simgrid::s4u::Actor::self();
101 if (me == nullptr) // This happens sometimes (eg, when linking against NS3 because it pulls openMPI...)
104 return me->extension<simgrid::smpi::ActorExt>();
107 simgrid::smpi::ActorExt* smpi_process_remote(simgrid::s4u::ActorPtr actor)
109 if (actor.get() == nullptr)
111 return actor->extension<simgrid::smpi::ActorExt>();
114 MPI_Comm smpi_process_comm_self(){
115 return smpi_process()->comm_self();
118 MPI_Info smpi_process_info_env(){
119 return smpi_process()->info_env();
122 void * smpi_process_get_user_data(){
123 return simgrid::s4u::Actor::self()->get_data();
126 void smpi_process_set_user_data(void *data){
127 simgrid::s4u::Actor::self()->set_data(data);
130 void smpi_comm_set_copy_data_callback(void (*callback) (smx_activity_t, void*, size_t))
132 static void (*saved_callback)(smx_activity_t, void*, size_t);
133 saved_callback = callback;
134 smpi_comm_copy_data_callback = [](simgrid::kernel::activity::CommImpl* comm, void* buff, size_t size) {
135 saved_callback(comm, buff, size);
139 static void memcpy_private(void* dest, const void* src, const std::vector<std::pair<size_t, size_t>>& private_blocks)
141 for (auto const& block : private_blocks)
142 memcpy((uint8_t*)dest+block.first, (uint8_t*)src+block.first, block.second-block.first);
145 static void check_blocks(const std::vector<std::pair<size_t, size_t>>& private_blocks, size_t buff_size)
147 for (auto const& block : private_blocks)
148 xbt_assert(block.first <= block.second && block.second <= buff_size, "Oops, bug in shared malloc.");
151 static void smpi_cleanup_comm_after_copy(simgrid::kernel::activity::CommImpl* comm, void* buff){
152 if (comm->detached()) {
153 // if this is a detached send, the source buffer was duplicated by SMPI
154 // sender to make the original buffer available to the application ASAP
156 //It seems that the request is used after the call there this should be free somewhere else but where???
157 //xbt_free(comm->comm.src_data);// inside SMPI the request is kept inside the user data and should be free
158 comm->src_buff_ = nullptr;
162 void smpi_comm_copy_buffer_callback(simgrid::kernel::activity::CommImpl* comm, void* buff, size_t buff_size)
164 size_t src_offset = 0;
165 size_t dst_offset = 0;
166 std::vector<std::pair<size_t, size_t>> src_private_blocks;
167 std::vector<std::pair<size_t, size_t>> dst_private_blocks;
168 XBT_DEBUG("Copy the data over");
169 if(smpi_is_shared(buff, src_private_blocks, &src_offset)) {
170 src_private_blocks = shift_and_frame_private_blocks(src_private_blocks, src_offset, buff_size);
171 if (src_private_blocks.empty()) { // simple shared malloc ... return.
172 XBT_VERB("Sender is shared. Let's ignore it.");
173 smpi_cleanup_comm_after_copy(comm, buff);
178 src_private_blocks.clear();
179 src_private_blocks.emplace_back(0, buff_size);
181 if (smpi_is_shared((char*)comm->dst_buff_, dst_private_blocks, &dst_offset)) {
182 dst_private_blocks = shift_and_frame_private_blocks(dst_private_blocks, dst_offset, buff_size);
183 if (dst_private_blocks.empty()) { // simple shared malloc ... return.
184 XBT_VERB("Receiver is shared. Let's ignore it.");
185 smpi_cleanup_comm_after_copy(comm, buff);
190 dst_private_blocks.clear();
191 dst_private_blocks.emplace_back(0, buff_size);
193 check_blocks(src_private_blocks, buff_size);
194 check_blocks(dst_private_blocks, buff_size);
195 auto private_blocks = merge_private_blocks(src_private_blocks, dst_private_blocks);
196 check_blocks(private_blocks, buff_size);
198 if (smpi_switch_data_segment(comm->src_actor_->get_iface(), buff)) {
199 XBT_DEBUG("Privatization : We are copying from a zone inside global memory... Saving data to temp buffer !");
200 tmpbuff = xbt_malloc(buff_size);
201 memcpy_private(tmpbuff, buff, private_blocks);
204 if (smpi_switch_data_segment(comm->dst_actor_->get_iface(), comm->dst_buff_))
205 XBT_DEBUG("Privatization : We are copying to a zone inside global memory - Switch data segment");
207 XBT_DEBUG("Copying %zu bytes from %p to %p", buff_size, tmpbuff, comm->dst_buff_);
208 memcpy_private(comm->dst_buff_, tmpbuff, private_blocks);
210 smpi_cleanup_comm_after_copy(comm,buff);
215 void smpi_comm_null_copy_buffer_callback(simgrid::kernel::activity::CommImpl*, void*, size_t)
217 /* nothing done in this version */
221 return MPI_COMM_WORLD != MPI_COMM_UNINITIALIZED;
224 static void smpi_init_papi()
227 // This map holds for each computation unit (such as "default" or "process1" etc.)
228 // the configuration as given by the user (counter data as a pair of (counter_name, counter_counter))
229 // and the (computed) event_set.
231 if (smpi_cfg_papi_events_file().empty())
234 if (PAPI_library_init(PAPI_VER_CURRENT) != PAPI_VER_CURRENT) {
235 XBT_ERROR("Could not initialize PAPI library; is it correctly installed and linked? Expected version is %u",
240 using Tokenizer = boost::tokenizer<boost::char_separator<char>>;
241 boost::char_separator<char> separator_units(";");
242 std::string str = smpi_cfg_papi_events_file();
243 Tokenizer tokens(str, separator_units);
245 // Iterate over all the computational units. This could be processes, hosts, threads, ranks... You name it.
246 // I'm not exactly sure what we will support eventually, so I'll leave it at the general term "units".
247 for (auto const& unit_it : tokens) {
248 boost::char_separator<char> separator_events(":");
249 Tokenizer event_tokens(unit_it, separator_events);
251 int event_set = PAPI_NULL;
252 if (PAPI_create_eventset(&event_set) != PAPI_OK) {
253 // TODO: Should this let the whole simulation die?
254 XBT_CRITICAL("Could not create PAPI event set during init.");
258 // NOTE: We cannot use a map here, as we must obey the order of the counters
259 // This is important for PAPI: We need to map the values of counters back to the event_names (so, when PAPI_read()
261 papi_counter_t counters2values;
263 // Iterate over all counters that were specified for this specific unit.
264 // Note that we need to remove the name of the unit (that could also be the "default" value), which always comes
265 // first. Hence, we start at ++(events.begin())!
266 for (Tokenizer::iterator events_it = ++(event_tokens.begin()); events_it != event_tokens.end(); ++events_it) {
267 int event_code = PAPI_NULL;
268 auto* event_name = const_cast<char*>((*events_it).c_str());
269 if (PAPI_event_name_to_code(event_name, &event_code) != PAPI_OK) {
270 XBT_CRITICAL("Could not find PAPI event '%s'. Skipping.", event_name);
273 if (PAPI_add_event(event_set, event_code) != PAPI_OK) {
274 XBT_ERROR("Could not add PAPI event '%s'. Skipping.", event_name);
277 XBT_DEBUG("Successfully added PAPI event '%s' to the event set.", event_name);
279 counters2values.emplace_back(*events_it, 0LL);
282 std::string unit_name = *(event_tokens.begin());
283 papi_process_data config = {.counter_data = std::move(counters2values), .event_set = event_set};
285 units2papi_setup.insert(std::make_pair(unit_name, std::move(config)));
290 using smpi_entry_point_type = std::function<int(int argc, char* argv[])>;
291 using smpi_c_entry_point_type = int (*)(int argc, char** argv);
292 using smpi_fortran_entry_point_type = void (*)();
294 template <typename F>
295 static int smpi_run_entry_point(const F& entry_point, const std::string& executable_path,
296 const std::vector<std::string>& args)
298 // copy C strings, we need them writable
299 auto* args4argv = new std::vector<char*>(args.size());
300 std::transform(begin(args), end(args), begin(*args4argv), [](const std::string& s) { return xbt_strdup(s.c_str()); });
302 // set argv[0] to executable_path
303 xbt_free((*args4argv)[0]);
304 (*args4argv)[0] = xbt_strdup(executable_path.c_str());
307 // take a copy of args4argv to keep reference of the allocated strings
308 const std::vector<char*> args2str(*args4argv);
310 int argc = static_cast<int>(args4argv->size());
311 args4argv->push_back(nullptr);
312 char** argv = args4argv->data();
315 for_rtl_init_ (&argc, argv);
320 _gfortran_set_args(argc, argv);
324 int res = entry_point(argc, argv);
326 XBT_WARN("SMPI process did not return 0. Return value : %d", res);
327 if (smpi_exit_status == 0)
328 smpi_exit_status = res;
330 } catch (simgrid::ForcefulKillException const& e) {
331 XBT_DEBUG("Caught a ForcefulKillException: %s", e.what());
337 for (char* s : args2str)
346 // TODO, remove the number of functions involved here
347 static smpi_entry_point_type smpi_resolve_function(void* handle)
349 auto* entry_point_fortran = reinterpret_cast<smpi_fortran_entry_point_type>(dlsym(handle, "user_main_"));
350 if (entry_point_fortran != nullptr) {
351 return [entry_point_fortran](int, char**) {
352 entry_point_fortran();
357 auto* entry_point = reinterpret_cast<smpi_c_entry_point_type>(dlsym(handle, "main"));
358 if (entry_point != nullptr) {
362 return smpi_entry_point_type();
365 static void smpi_copy_file(const std::string& src, const std::string& target, off_t fdin_size)
367 int fdin = open(src.c_str(), O_RDONLY);
368 xbt_assert(fdin >= 0, "Cannot read from %s. Please make sure that the file exists and is executable.", src.c_str());
369 xbt_assert(unlink(target.c_str()) == 0 || errno == ENOENT, "Failed to unlink file %s: %s", target.c_str(),
371 int fdout = open(target.c_str(), O_CREAT | O_RDWR | O_EXCL, S_IRWXU);
372 xbt_assert(fdout >= 0, "Cannot write into %s: %s", target.c_str(), strerror(errno));
374 XBT_DEBUG("Copy %" PRIdMAX " bytes into %s", static_cast<intmax_t>(fdin_size), target.c_str());
376 ssize_t sent_size = sendfile(fdout, fdin, nullptr, fdin_size);
377 if (sent_size == fdin_size) {
382 xbt_assert(sent_size == -1 && errno == ENOSYS,
383 "Error while copying %s: only %zd bytes copied instead of %" PRIdMAX " (errno: %d -- %s)", target.c_str(),
384 sent_size, static_cast<intmax_t>(fdin_size), errno, strerror(errno));
386 // If this point is reached, sendfile() actually is not available. Copy file by hand.
387 std::vector<unsigned char> buf(1024 * 1024 * 4);
388 while (ssize_t got = read(fdin, buf.data(), buf.size())) {
390 xbt_assert(errno == EINTR, "Cannot read from %s", src.c_str());
393 const unsigned char* p = buf.data();
395 while (ssize_t done = write(fdout, p, todo)) {
397 xbt_assert(errno == EINTR, "Cannot write into %s", target.c_str());
408 #if not defined(__APPLE__) && not defined(__HAIKU__)
409 static int visit_libs(struct dl_phdr_info* info, size_t, void* data)
411 auto* libname = static_cast<std::string*>(data);
412 std::string path = info->dlpi_name;
413 if (path.find(*libname) != std::string::npos) {
414 *libname = std::move(path);
421 static void smpi_init_privatization_dlopen(const std::string& executable)
423 // Prepare the copy of the binary (get its size)
424 struct stat fdin_stat;
425 stat(executable.c_str(), &fdin_stat);
426 off_t fdin_size = fdin_stat.st_size;
428 std::string libnames = simgrid::config::get_value<std::string>("smpi/privatize-libs");
429 if (not libnames.empty()) {
431 std::vector<std::string> privatize_libs;
432 boost::split(privatize_libs, libnames, boost::is_any_of(";"));
434 for (auto const& libname : privatize_libs) {
435 // load the library once to add it to the local libs, to get the absolute path
436 void* libhandle = dlopen(libname.c_str(), RTLD_LAZY);
437 xbt_assert(libhandle != nullptr, "Cannot dlopen %s - check your settings in smpi/privatize-libs",
439 // get library name from path
440 std::string fullpath = libname;
441 #if not defined(__APPLE__) && not defined(__HAIKU__)
442 xbt_assert(dl_iterate_phdr(visit_libs, &fullpath) != 0,
443 "Can't find a linked %s - check your settings in smpi/privatize-libs", fullpath.c_str());
444 XBT_DEBUG("Extra lib to privatize '%s' found", fullpath.c_str());
446 xbt_die("smpi/privatize-libs is not (yet) compatible with OSX nor with Haiku");
448 privatize_libs_paths.emplace_back(std::move(fullpath));
453 simgrid::s4u::Engine::get_instance()->register_default([executable, fdin_size](std::vector<std::string> args) {
454 return simgrid::kernel::actor::ActorCode([executable, fdin_size, args = std::move(args)] {
455 static std::size_t rank = 0;
456 // Copy the dynamic library:
457 simgrid::xbt::Path path(executable);
458 std::string target_executable = simgrid::config::get_value<std::string>("smpi/tmpdir") + "/" +
459 path.get_base_name() + "_" + std::to_string(getpid()) + "_" + std::to_string(rank) + ".so";
461 smpi_copy_file(executable, target_executable, fdin_size);
462 // if smpi/privatize-libs is set, duplicate pointed lib and link each executable copy to a different one.
463 std::vector<std::string> target_libs;
464 for (auto const& libpath : privatize_libs_paths) {
465 // if we were given a full path, strip it
466 size_t index = libpath.find_last_of("/\\");
468 if (index != std::string::npos)
469 libname = libpath.substr(index + 1);
471 if (not libname.empty()) {
472 // load the library to add it to the local libs, to get the absolute path
473 struct stat fdin_stat2;
474 stat(libpath.c_str(), &fdin_stat2);
475 off_t fdin_size2 = fdin_stat2.st_size;
477 // Copy the dynamic library, the new name must be the same length as the old one
478 // just replace the name with 7 digits for the rank and the rest of the name.
479 auto pad = std::min<size_t>(7, libname.length());
480 std::string target_libname = std::string(pad - std::to_string(rank).length(), '0') + std::to_string(rank) + libname.substr(pad);
481 std::string target_lib = simgrid::config::get_value<std::string>("smpi/tmpdir") + "/" + target_libname;
482 target_libs.push_back(target_lib);
483 XBT_DEBUG("copy lib %s to %s, with size %lld", libpath.c_str(), target_lib.c_str(), (long long)fdin_size2);
484 smpi_copy_file(libpath, target_lib, fdin_size2);
486 std::string sedcommand = "sed -i -e 's/" + libname + "/" + target_libname + "/g' " + target_executable;
487 int status = system(sedcommand.c_str());
488 xbt_assert(status == 0, "error while applying sed command %s \n", sedcommand.c_str());
493 // Load the copy and resolve the entry point:
494 void* handle = dlopen(target_executable.c_str(), RTLD_LAZY | RTLD_LOCAL | WANT_RTLD_DEEPBIND);
495 int saved_errno = errno;
496 if (not simgrid::config::get_value<bool>("smpi/keep-temps")) {
497 unlink(target_executable.c_str());
498 for (const std::string& target_lib : target_libs)
499 unlink(target_lib.c_str());
501 xbt_assert(handle != nullptr,
502 "dlopen failed: %s (errno: %d -- %s).\nError: Did you compile the program with a SMPI-specific "
503 "compiler (spmicc or friends)?",
504 dlerror(), saved_errno, strerror(saved_errno));
506 smpi_entry_point_type entry_point = smpi_resolve_function(handle);
507 xbt_assert(entry_point, "Could not resolve entry point. Does your program contain a main() function?");
508 smpi_run_entry_point(entry_point, executable, args);
513 static void smpi_init_privatization_no_dlopen(const std::string& executable)
515 if (smpi_cfg_privatization() == SmpiPrivStrategies::MMAP)
516 smpi_prepare_global_memory_segment();
518 // Load the dynamic library and resolve the entry point:
519 void* handle = dlopen(executable.c_str(), RTLD_LAZY | RTLD_LOCAL);
520 xbt_assert(handle != nullptr, "dlopen failed for %s: %s (errno: %d -- %s)", executable.c_str(), dlerror(), errno,
522 smpi_entry_point_type entry_point = smpi_resolve_function(handle);
523 xbt_assert(entry_point, "main not found in %s", executable.c_str());
525 if (smpi_cfg_privatization() == SmpiPrivStrategies::MMAP)
526 smpi_backup_global_memory_segment();
528 // Execute the same entry point for each simulated process:
529 simgrid::s4u::Engine::get_instance()->register_default([entry_point, executable](std::vector<std::string> args) {
530 return simgrid::kernel::actor::ActorCode([entry_point, executable, args = std::move(args)] {
531 if (smpi_cfg_privatization() == SmpiPrivStrategies::MMAP) {
532 simgrid::smpi::ActorExt* ext = smpi_process();
533 /* Now using the segment index of this process */
534 ext->set_privatized_region(smpi_init_global_memory_segment_process());
535 /* Done at the process's creation */
536 smpi_switch_data_segment(simgrid::s4u::Actor::self());
538 smpi_run_entry_point(entry_point, executable, args);
543 int smpi_main(const char* executable, int argc, char* argv[])
545 if (getenv("SMPI_PRETEND_CC") != nullptr) {
546 /* Hack to ensure that smpicc can pretend to be a simple compiler. Particularly handy to pass it to the
547 * configuration tools */
551 smpi_init_options_internal(true);
552 simgrid::s4u::Engine engine(&argc, argv);
554 sg_storage_file_system_init();
555 // parse the platform file: get the host list
556 engine.load_platform(argv[1]);
557 engine.set_default_comm_data_copy_callback(smpi_comm_copy_buffer_callback);
559 if (smpi_cfg_privatization() == SmpiPrivStrategies::DLOPEN)
560 smpi_init_privatization_dlopen(executable);
562 smpi_init_privatization_no_dlopen(executable);
564 simgrid::smpi::colls::set_collectives();
565 simgrid::smpi::colls::smpi_coll_cleanup_callback = nullptr;
569 const std::vector<const char*> args(argv + 2, argv + argc);
571 smpi_deployment_smpirun(&engine, smpi_hostfile.get(), smpi_np.get(), smpi_replay.get(), smpi_map.get(), args);
573 SMPI_app_instance_register(smpi_default_instance_name.c_str(), nullptr, rank_counts);
574 MPI_COMM_WORLD = *smpi_deployment_comm_world(smpi_default_instance_name);
576 /* Clean IO before the run */
580 if (MC_is_active()) {
583 engine.get_impl()->run();
585 xbt_os_walltimer_stop(global_timer);
586 simgrid::smpi::utils::print_time_analysis(xbt_os_timer_elapsed(global_timer));
590 return smpi_exit_status;
593 // Called either directly from the user code, or from the code called by smpirun
595 smpi_init_options_internal(false);
596 simgrid::s4u::Actor::on_creation.connect([](simgrid::s4u::Actor& actor) {
597 if (not actor.is_daemon())
598 actor.extension_set<simgrid::smpi::ActorExt>(new simgrid::smpi::ActorExt(&actor));
600 simgrid::s4u::Host::on_creation.connect(
601 [](simgrid::s4u::Host& host) { host.extension_set(new simgrid::smpi::Host(&host)); });
602 for (auto const& host : simgrid::s4u::Engine::get_instance()->get_all_hosts())
603 host->extension_set(new simgrid::smpi::Host(host));
605 if (not MC_is_active()) {
606 global_timer = xbt_os_timer_new();
607 xbt_os_walltimer_start(global_timer);
610 smpi_check_options();
615 smpi_bench_destroy();
616 smpi_shared_destroy();
617 smpi_deployment_cleanup_instances();
619 if (simgrid::smpi::colls::smpi_coll_cleanup_callback != nullptr)
620 simgrid::smpi::colls::smpi_coll_cleanup_callback();
622 MPI_COMM_WORLD = MPI_COMM_NULL;
624 if (not MC_is_active()) {
625 xbt_os_timer_free(global_timer);
628 if (smpi_cfg_privatization() == SmpiPrivStrategies::MMAP)
629 smpi_destroy_global_memory_segments();
631 simgrid::smpi::utils::print_memory_analysis();
634 void smpi_mpi_init() {
635 smpi_init_fortran_types();
636 if(_smpi_init_sleep > 0)
637 simgrid::s4u::this_actor::sleep_for(_smpi_init_sleep);
638 smpi_deployment_startup_barrier(smpi_process()->get_instance_id());
641 void SMPI_thread_create() {
642 TRACE_smpi_init(simgrid::s4u::this_actor::get_pid(), __func__);
643 smpi_process()->mark_as_initialized();
646 void smpi_exit(int res){
648 XBT_WARN("SMPI process did not return 0. Return value : %d", res);
649 smpi_exit_status = res;
651 simgrid::s4u::this_actor::exit();