1 /* Copyright (c) 2007-2020. 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 #ifndef SG_POPPING_PRIVATE_HPP
7 #define SG_POPPING_PRIVATE_HPP
9 #include "simgrid/forward.h"
10 #include "src/kernel/activity/ActivityImpl.hpp"
13 #include <boost/intrusive_ptr.hpp>
15 /********************************* Simcalls *********************************/
16 #include "popping_enum.hpp" /* Definition of Simcall, with one value per simcall */
18 XBT_PUBLIC_DATA const std::array<const char*, simgrid::simix::NUM_SIMCALLS> simcall_names; /* Name of each simcall */
20 using simix_match_func_t = bool (*)(void*, void*, simgrid::kernel::activity::CommImpl*);
21 using simix_copy_data_func_t = void (*)(simgrid::kernel::activity::CommImpl*, void*, size_t);
22 using simix_clean_func_t = void (*)(void*);
23 using FPtr = void (*)(); // Hide the ugliness
25 /* Pack all possible scalar types in an union */
37 unsigned long long ull;
44 * @brief Represents a simcall to the kernel.
46 struct s_smx_simcall {
47 simgrid::simix::Simcall call_ = simgrid::simix::Simcall::NONE;
48 smx_actor_t issuer_ = nullptr;
49 smx_timer_t timeout_cb_ = nullptr; // Callback to timeouts
50 simgrid::mc::SimcallInspector* inspector_ = nullptr; // makes that simcall observable by the MC
52 std::array<u_smx_scalar, 11> args_ = {};
53 u_smx_scalar result_ = {};
56 #define SIMCALL_SET_MC_VALUE(simcall, value) ((simcall).mc_value_ = (value))
57 #define SIMCALL_GET_MC_VALUE(simcall) ((simcall).mc_value_)
59 /******************************** General *************************************/
61 XBT_PRIVATE const char* SIMIX_simcall_name(simgrid::simix::Simcall kind);
62 XBT_PRIVATE void SIMIX_run_kernel(std::function<void()> const* code);
63 XBT_PRIVATE void SIMIX_run_blocking(std::function<void()> const* code);
65 /* Defines the marshal/unmarshal functions for each type of parameters.
67 * They will be used in popping_accessors.hpp to define the functions allowing
68 * to retrieve/set each parameter of each simcall.
70 * There is a unmarshal_raw() function, which is exactly similar to unmarshal()
71 * for all types but boost::intrusive_ptr(T). For that type, the unmarshal()
72 * function builds a new intrusive_ptr wrapping the pointer (that is stored raw
73 * within the simcall) while the unmarshal_raw retrieves the raw pointer.
75 * This is used in <simcall>_getraw_<param> functions, that allow the
76 * model-checker, to read the data in the remote memory of the MCed.
82 template <class T> class type {
83 constexpr bool operator==(type) const { return true; }
84 template <class U> constexpr bool operator==(type<U>) const { return false; }
85 constexpr bool operator!=(type) const { return false; }
86 template <class U> constexpr bool operator!=(type<U>) const { return true; }
89 template <typename T> struct marshal_t {
91 #define SIMIX_MARSHAL(T, field) \
92 inline void marshal(type<T>, u_smx_scalar& simcall, T value) { simcall.field = value; } \
93 inline T unmarshal(type<T>, u_smx_scalar const& simcall) { return simcall.field; } \
94 inline T unmarshal_raw(type<T>, u_smx_scalar const& simcall) \
95 { /* Exactly same as unmarshal. It differs only for intrusive_ptr */ return simcall.field; }
97 SIMIX_MARSHAL(bool, b)
98 SIMIX_MARSHAL(char, c)
99 SIMIX_MARSHAL(short, s)
100 SIMIX_MARSHAL(int, i)
101 SIMIX_MARSHAL(long, l)
102 SIMIX_MARSHAL(unsigned char, uc)
103 SIMIX_MARSHAL(unsigned short, us)
104 SIMIX_MARSHAL(unsigned int, ui)
105 SIMIX_MARSHAL(unsigned long, ul)
106 SIMIX_MARSHAL(unsigned long long, ull)
107 SIMIX_MARSHAL(long long, ll)
108 SIMIX_MARSHAL(float, d)
109 SIMIX_MARSHAL(double, d)
110 SIMIX_MARSHAL(FPtr, fp)
112 inline void unmarshal(type<void>, u_smx_scalar const& /*simcall*/)
114 /* Nothing to do for void data */
116 inline void unmarshal_raw(type<void>, u_smx_scalar const& /*simcall*/)
118 /* Nothing to do for void data */
121 template <class T> inline void marshal(type<T*>, u_smx_scalar& simcall, T* value)
123 simcall.dp = (void*)value;
125 template <class T> inline T* unmarshal(type<T*>, u_smx_scalar const& simcall)
127 return static_cast<T*>(simcall.dp);
129 template <class T> inline T* unmarshal_raw(type<T*>, u_smx_scalar const& simcall)
131 return static_cast<T*>(simcall.dp);
135 inline void marshal(type<boost::intrusive_ptr<T>>, u_smx_scalar& simcall, boost::intrusive_ptr<T> value)
137 if (value.get() == nullptr) { // Sometimes we return nullptr in an intrusive_ptr...
138 simcall.dp = nullptr;
140 intrusive_ptr_add_ref(value.get());
141 simcall.dp = static_cast<void*>(value.get());
144 template <class T> inline boost::intrusive_ptr<T> unmarshal(type<boost::intrusive_ptr<T>>, u_smx_scalar const& simcall)
146 // refcount was already increased during the marshaling, thus the "false" as last argument
147 boost::intrusive_ptr<T> res = boost::intrusive_ptr<T>(static_cast<T*>(simcall.dp), false);
150 template <class T> inline T* unmarshal_raw(type<boost::intrusive_ptr<T>>, u_smx_scalar const& simcall)
152 return static_cast<T*>(simcall.dp);
155 template <class R, class... T> inline void marshal(type<R (*)(T...)>, u_smx_scalar& simcall, R (*value)(T...))
157 simcall.fp = (FPtr)value;
159 template <class R, class... T> inline auto unmarshal(type<R (*)(T...)>, u_smx_scalar simcall) -> R (*)(T...)
161 return (R(*)(T...))simcall.fp;
163 template <class R, class... T> inline auto unmarshal_raw(type<R (*)(T...)>, u_smx_scalar simcall) -> R (*)(T...)
165 return (R(*)(T...))simcall.fp;
168 template <class T> inline void marshal(u_smx_scalar& simcall, T const& value)
170 return marshal(type<T>(), simcall, value);
172 template <class T> inline typename std::remove_reference<T>::type unmarshal(u_smx_scalar& simcall)
174 return unmarshal(type<T>(), simcall);
176 template <class T> inline typename std::remove_reference<T>::type unmarshal_raw(u_smx_scalar& simcall)
178 return unmarshal(type<T>(), simcall);
181 template <std::size_t I> inline void marshal_args(const s_smx_simcall* /*simcall*/)
183 /* Nothing to do when no args */
186 template <std::size_t I, class A> inline void marshal_args(smx_simcall_t simcall, A const& a)
188 marshal(simcall->args_[I], a);
191 template <std::size_t I, class A, class... B> inline void marshal_args(smx_simcall_t simcall, A const& a, B const&... b)
193 marshal(simcall->args_[I], a);
194 marshal_args<I + 1>(simcall, b...);
197 /** Initialize the simcall */
198 template <class... A> inline void marshal(smx_simcall_t simcall, Simcall call, A const&... a)
200 simcall->call_ = call;
201 memset(&simcall->result_, 0, sizeof simcall->result_);
202 memset(simcall->args_.data(), 0, simcall->args_.size() * sizeof simcall->args_[0]);
203 marshal_args<0>(simcall, a...);
208 #include "popping_accessors.hpp"