1 /* Copyright (c) 2006-2022. 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. */
6 #include <simgrid/mailbox.h>
7 #include <simgrid/s4u/Engine.hpp>
8 #include <simgrid/s4u/Mailbox.hpp>
10 #include "src/kernel/activity/MailboxImpl.hpp"
12 XBT_LOG_EXTERNAL_CATEGORY(s4u);
13 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(s4u_channel, s4u, "S4U Communication Mailboxes");
18 const xbt::string& Mailbox::get_name() const
20 return pimpl_->get_name();
23 const char* Mailbox::get_cname() const
25 return pimpl_->get_cname();
28 Mailbox* Mailbox::by_name(const std::string& name)
30 return Engine::get_instance()->mailbox_by_name_or_create(name);
33 bool Mailbox::empty() const
35 return pimpl_->empty();
38 size_t Mailbox::size() const
40 return pimpl_->size();
43 bool Mailbox::listen() const
45 return not pimpl_->empty() || (pimpl_->is_permanent() && pimpl_->has_some_done_comm());
48 aid_t Mailbox::listen_from() const
50 kernel::activity::CommImplPtr comm = front();
51 if (comm && comm->src_actor_)
52 return comm->src_actor_->get_pid();
57 bool Mailbox::ready() const
59 bool comm_ready = false;
60 if (not pimpl_->empty()) {
61 comm_ready = pimpl_->front()->get_state() == kernel::activity::State::DONE;
63 } else if (pimpl_->is_permanent() && pimpl_->has_some_done_comm()) {
64 comm_ready = pimpl_->done_front()->get_state() == kernel::activity::State::DONE;
69 kernel::activity::CommImplPtr Mailbox::front() const
71 return pimpl_->empty() ? nullptr : pimpl_->front();
74 void Mailbox::set_receiver(ActorPtr actor)
76 kernel::actor::simcall_answered([this, actor]() { this->pimpl_->set_receiver(actor); });
79 /** @brief get the receiver (process associated to the mailbox) */
80 ActorPtr Mailbox::get_receiver() const
82 if (pimpl_->is_permanent())
84 return pimpl_->get_permanent_receiver()->get_iface();
87 CommPtr Mailbox::put_init()
89 CommPtr res(new Comm());
90 res->sender_ = kernel::actor::ActorImpl::self();
91 res->set_mailbox(this);
95 CommPtr Mailbox::put_init(void* payload, uint64_t simulated_size_in_bytes)
97 return put_init()->set_payload_size(simulated_size_in_bytes)->set_src_data(payload)->set_src_data_size(sizeof(void*));
100 CommPtr Mailbox::put_async(void* payload, uint64_t simulated_size_in_bytes)
102 xbt_assert(payload != nullptr, "You cannot send nullptr");
104 CommPtr res = put_init(payload, simulated_size_in_bytes);
105 res->vetoable_start();
109 void Mailbox::put(void* payload, uint64_t simulated_size_in_bytes)
111 xbt_assert(payload != nullptr, "You cannot send nullptr");
113 put_init()->set_payload_size(simulated_size_in_bytes)->set_src_data(payload)->vetoable_start()->wait();
116 /** Blocking send with timeout */
117 void Mailbox::put(void* payload, uint64_t simulated_size_in_bytes, double timeout)
119 xbt_assert(payload != nullptr, "You cannot send nullptr");
121 put_init()->set_payload_size(simulated_size_in_bytes)->set_src_data(payload)->vetoable_start()->wait_for(timeout);
124 CommPtr Mailbox::get_init()
126 auto res = CommPtr(new Comm())->set_mailbox(this);
127 res->receiver_ = kernel::actor::ActorImpl::self();
131 kernel::activity::ActivityImplPtr
132 Mailbox::iprobe(int type, const std::function<bool(void*, void*, kernel::activity::CommImpl*)>& match_fun, void* data)
134 return kernel::actor::simcall_answered(
135 [this, type, &match_fun, data] { return pimpl_->iprobe(type, match_fun, data); });
138 } // namespace simgrid
140 /* **************************** Public C interface *************************** */
141 sg_mailbox_t sg_mailbox_by_name(const char* alias)
143 return simgrid::s4u::Mailbox::by_name(alias);
146 const char* sg_mailbox_get_name(const_sg_mailbox_t mailbox)
148 return mailbox->get_cname();
151 /** @brief Set the mailbox to receive in asynchronous mode
153 * All messages sent to this mailbox will be transferred to the receiver without waiting for the receive call.
154 * The receive call will still be necessary to use the received data.
155 * If there is a need to receive some messages asynchronously, and some not, two different mailboxes should be used.
157 * @param alias The name of the mailbox
159 void sg_mailbox_set_receiver(const char* alias)
161 simgrid::s4u::Mailbox::by_name(alias)->set_receiver(simgrid::s4u::Actor::self());
162 XBT_VERB("%s mailbox set to receive eagerly for myself\n", alias);
165 /** @brief Check if there is a communication going on in a mailbox.
167 * @param alias the name of the mailbox to be considered
168 * @return Returns 1 if there is a communication, 0 otherwise
170 int sg_mailbox_listen(const char* alias)
172 return simgrid::s4u::Mailbox::by_name(alias)->listen() ? 1 : 0;
175 void* sg_mailbox_get(sg_mailbox_t mailbox)
177 return mailbox->get<void>();
180 sg_comm_t sg_mailbox_get_async(sg_mailbox_t mailbox, void** data)
182 auto comm = mailbox->get_async<void>(data);
187 void sg_mailbox_put(sg_mailbox_t mailbox, void* payload, long simulated_size_in_bytes)
189 mailbox->put(payload, simulated_size_in_bytes);
192 sg_comm_t sg_mailbox_put_async(sg_mailbox_t mailbox, void* payload, long simulated_size_in_bytes)
194 auto comm = mailbox->put_async(payload, simulated_size_in_bytes);
199 sg_comm_t sg_mailbox_put_init(sg_mailbox_t mailbox, void* payload, long simulated_size_in_bytes)
201 auto comm = mailbox->put_init(payload, simulated_size_in_bytes);